[{"data":1,"prerenderedAt":1725},["ShallowReactive",2],{"navigation":3,"\u002Fdevelopers\u002Fauthentication":488,"\u002Fdevelopers\u002Fauthentication-surround":1720,"\u002Fdevelopers\u002Fauthentication-reference":1714},[4,28,93,113,135,173],{"title":5,"path":6,"stem":7,"children":8,"icon":27},"Getting started","\u002Fgetting-started","1.getting-started\u002F1.index",[9,12,17,22],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-house",{"title":13,"path":14,"stem":15,"icon":16},"Concepts","\u002Fgetting-started\u002Fconcepts","1.getting-started\u002F2.concepts","i-lucide-shapes",{"title":18,"path":19,"stem":20,"icon":21},"Quickstart in the portal","\u002Fgetting-started\u002Fquickstart","1.getting-started\u002F3.quickstart","i-lucide-mouse-pointer-click",{"title":23,"path":24,"stem":25,"icon":26},"Quickstart with the API","\u002Fgetting-started\u002Fapi-quickstart","1.getting-started\u002F4.api-quickstart","i-lucide-terminal",false,{"title":29,"icon":27,"path":30,"stem":31,"children":32,"page":27},"Guides","\u002Fguides","2.guides",[33,38,43,48,53,58,63,68,73,78,83,88],{"title":34,"path":35,"stem":36,"icon":37},"Products","\u002Fguides\u002Fproducts","2.guides\u002F01.products","i-lucide-package",{"title":39,"path":40,"stem":41,"icon":42},"Pricing","\u002Fguides\u002Fpricing","2.guides\u002F02.pricing","i-lucide-tags",{"title":44,"path":45,"stem":46,"icon":47},"Locations","\u002Fguides\u002Flocations","2.guides\u002F03.locations","i-lucide-map-pin",{"title":49,"path":50,"stem":51,"icon":52},"Inventory","\u002Fguides\u002Finventory","2.guides\u002F04.inventory","i-lucide-warehouse",{"title":54,"path":55,"stem":56,"icon":57},"Suppliers and purchasing","\u002Fguides\u002Fsuppliers-and-purchasing","2.guides\u002F05.suppliers-and-purchasing","i-lucide-truck",{"title":59,"path":60,"stem":61,"icon":62},"Transfer orders","\u002Fguides\u002Ftransfer-orders","2.guides\u002F06.transfer-orders","i-lucide-arrow-left-right",{"title":64,"path":65,"stem":66,"icon":67},"Bills of material","\u002Fguides\u002Fbills-of-material","2.guides\u002F07.bills-of-material","i-lucide-list-tree",{"title":69,"path":70,"stem":71,"icon":72},"Production","\u002Fguides\u002Fproduction","2.guides\u002F08.production","i-lucide-factory",{"title":74,"path":75,"stem":76,"icon":77},"Orders and shipments","\u002Fguides\u002Forders-and-shipments","2.guides\u002F09.orders-and-shipments","i-lucide-shopping-cart",{"title":79,"path":80,"stem":81,"icon":82},"Business hierarchy","\u002Fguides\u002Fbusiness-hierarchy","2.guides\u002F10.business-hierarchy","i-lucide-network",{"title":84,"path":85,"stem":86,"icon":87},"Users and roles","\u002Fguides\u002Fusers-and-roles","2.guides\u002F11.users-and-roles","i-lucide-users",{"title":89,"path":90,"stem":91,"icon":92},"Notifications","\u002Fguides\u002Fnotifications","2.guides\u002F12.notifications","i-lucide-bell",{"title":94,"icon":27,"path":95,"stem":96,"children":97,"page":27},"Planning and AI","\u002Fplanning-and-ai","3.planning-and-ai",[98,103,108],{"title":99,"path":100,"stem":101,"icon":102},"Miridia Planner","\u002Fplanning-and-ai\u002Fmiridia-planner","3.planning-and-ai\u002F1.miridia-planner","i-lucide-chart-line",{"title":104,"path":105,"stem":106,"icon":107},"Miridia AI Studio","\u002Fplanning-and-ai\u002Fai-studio","3.planning-and-ai\u002F2.ai-studio","i-lucide-sparkles",{"title":109,"path":110,"stem":111,"icon":112},"Miridia Console","\u002Fplanning-and-ai\u002Fconsole","3.planning-and-ai\u002F3.console","i-lucide-monitor",{"title":114,"path":115,"stem":116,"children":117,"icon":27},"Integrations","\u002Fintegrations","4.integrations\u002F1.index",[118,121,126,131],{"title":119,"path":115,"stem":116,"icon":120},"Integrations overview","i-lucide-plug",{"title":122,"path":123,"stem":124,"icon":125},"Workflows and events","\u002Fintegrations\u002Fworkflows","4.integrations\u002F2.workflows","i-lucide-workflow",{"title":127,"path":128,"stem":129,"icon":130},"Build a connector","\u002Fintegrations\u002Fconnectors","4.integrations\u002F3.connectors","i-lucide-cable",{"title":132,"path":133,"stem":134,"icon":52},"Data warehouse","\u002Fintegrations\u002Fdata-warehouse","4.integrations\u002F4.data-warehouse",{"title":136,"path":137,"stem":138,"children":139,"icon":27},"Tutorials","\u002Ftutorials","5.tutorials\u002F01.index",[140,143,148,152,157,161,165,169],{"title":141,"path":137,"stem":138,"icon":142},"Video tutorials","i-lucide-circle-play",{"title":144,"path":145,"stem":146,"icon":147},"Set up your business","\u002Ftutorials\u002Fset-up-your-business","5.tutorials\u002F02.set-up-your-business","i-lucide-building-2",{"title":149,"path":150,"stem":151,"icon":42},"Add products and prices","\u002Ftutorials\u002Fadd-products-and-prices","5.tutorials\u002F03.add-products-and-prices",{"title":153,"path":154,"stem":155,"icon":156},"Receive a purchase order","\u002Ftutorials\u002Freceive-a-purchase-order","5.tutorials\u002F04.receive-a-purchase-order","i-lucide-package-check",{"title":158,"path":159,"stem":160,"icon":62},"Replenish a branch","\u002Ftutorials\u002Freplenish-a-branch","5.tutorials\u002F05.replenish-a-branch",{"title":162,"path":163,"stem":164,"icon":72},"Cost and produce a product","\u002Ftutorials\u002Fcost-and-produce","5.tutorials\u002F06.cost-and-produce",{"title":166,"path":167,"stem":168,"icon":125},"Automate with n8n","\u002Ftutorials\u002Fautomate-with-n8n","5.tutorials\u002F07.automate-with-n8n",{"title":170,"path":171,"stem":172,"icon":26},"Call the API","\u002Ftutorials\u002Fcall-the-api","5.tutorials\u002F08.call-the-api",{"title":174,"path":175,"stem":176,"children":177,"icon":27},"Developers","\u002Fdevelopers","6.developers\u002F1.index",[178,181,186,191,234],{"title":179,"path":175,"stem":176,"icon":180},"API overview","i-lucide-braces",{"title":182,"path":183,"stem":184,"icon":185},"Authentication","\u002Fdevelopers\u002Fauthentication","6.developers\u002F2.authentication","i-lucide-key-round",{"title":187,"path":188,"stem":189,"icon":190},"Conventions","\u002Fdevelopers\u002Fconventions","6.developers\u002F3.conventions","i-lucide-list-checks",{"title":192,"icon":27,"path":193,"stem":194,"children":195,"page":27},"Global API","\u002Fdevelopers\u002Fglobal-api","6.developers\u002F4.global-api",[196,199,204,209,214,219,224,229],{"title":182,"path":197,"stem":198,"icon":185},"\u002Fdevelopers\u002Fglobal-api\u002Fauth","6.developers\u002F4.global-api\u002F01.auth",{"title":200,"path":201,"stem":202,"icon":203},"Organizations","\u002Fdevelopers\u002Fglobal-api\u002Forganization","6.developers\u002F4.global-api\u002F02.organization","i-lucide-building",{"title":205,"path":206,"stem":207,"icon":208},"Users","\u002Fdevelopers\u002Fglobal-api\u002Fuser","6.developers\u002F4.global-api\u002F03.user","i-lucide-user",{"title":210,"path":211,"stem":212,"icon":213},"Linked accounts","\u002Fdevelopers\u002Fglobal-api\u002Flinked-accounts","6.developers\u002F4.global-api\u002F04.linked-accounts","i-lucide-link",{"title":215,"path":216,"stem":217,"icon":218},"Subscriptions","\u002Fdevelopers\u002Fglobal-api\u002Fsubscription","6.developers\u002F4.global-api\u002F05.subscription","i-lucide-credit-card",{"title":220,"path":221,"stem":222,"icon":223},"Support","\u002Fdevelopers\u002Fglobal-api\u002Fsupport","6.developers\u002F4.global-api\u002F06.support","i-lucide-life-buoy",{"title":225,"path":226,"stem":227,"icon":228},"Banners","\u002Fdevelopers\u002Fglobal-api\u002Fnotification","6.developers\u002F4.global-api\u002F07.notification","i-lucide-megaphone",{"title":230,"path":231,"stem":232,"icon":233},"Signing keys","\u002Fdevelopers\u002Fglobal-api\u002Fwell-known","6.developers\u002F4.global-api\u002F08.well-known","i-lucide-shield-check",{"title":235,"icon":27,"path":236,"stem":237,"children":238,"page":27},"Core API","\u002Fdevelopers\u002Fcore-api","6.developers\u002F5.core-api",[239,255,272,285,305,327,376,409,436],{"title":240,"icon":37,"path":241,"stem":242,"children":243,"page":27},"Catalogue","\u002Fdevelopers\u002Fcore-api\u002Fcatalogue","6.developers\u002F5.core-api\u002F01.catalogue",[244,247,251],{"title":34,"path":245,"stem":246,"icon":37},"\u002Fdevelopers\u002Fcore-api\u002Fcatalogue\u002Fproducts","6.developers\u002F5.core-api\u002F01.catalogue\u002F01.products",{"title":248,"path":249,"stem":250,"icon":37},"Product groups","\u002Fdevelopers\u002Fcore-api\u002Fcatalogue\u002Fproduct-groups","6.developers\u002F5.core-api\u002F01.catalogue\u002F02.product-groups",{"title":252,"path":253,"stem":254,"icon":37},"Price lists","\u002Fdevelopers\u002Fcore-api\u002Fcatalogue\u002Fprice-lists","6.developers\u002F5.core-api\u002F01.catalogue\u002F03.price-lists",{"title":49,"icon":52,"path":256,"stem":257,"children":258,"page":27},"\u002Fdevelopers\u002Fcore-api\u002Finventory","6.developers\u002F5.core-api\u002F02.inventory",[259,262,266,269],{"title":49,"path":260,"stem":261,"icon":52},"\u002Fdevelopers\u002Fcore-api\u002Finventory\u002Finventory","6.developers\u002F5.core-api\u002F02.inventory\u002F01.inventory",{"title":263,"path":264,"stem":265,"icon":52},"Inventory lots","\u002Fdevelopers\u002Fcore-api\u002Finventory\u002Finventory-lots","6.developers\u002F5.core-api\u002F02.inventory\u002F02.inventory-lots",{"title":44,"path":267,"stem":268,"icon":52},"\u002Fdevelopers\u002Fcore-api\u002Finventory\u002Flocations","6.developers\u002F5.core-api\u002F02.inventory\u002F03.locations",{"title":59,"path":270,"stem":271,"icon":52},"\u002Fdevelopers\u002Fcore-api\u002Finventory\u002Ftransfer-orders","6.developers\u002F5.core-api\u002F02.inventory\u002F04.transfer-orders",{"title":273,"icon":77,"path":274,"stem":275,"children":276,"page":27},"Procurement","\u002Fdevelopers\u002Fcore-api\u002Fprocurement","6.developers\u002F5.core-api\u002F03.procurement",[277,281],{"title":278,"path":279,"stem":280,"icon":77},"Suppliers","\u002Fdevelopers\u002Fcore-api\u002Fprocurement\u002Fsuppliers","6.developers\u002F5.core-api\u002F03.procurement\u002F01.suppliers",{"title":282,"path":283,"stem":284,"icon":77},"Purchase orders","\u002Fdevelopers\u002Fcore-api\u002Fprocurement\u002Fpurchase-orders","6.developers\u002F5.core-api\u002F03.procurement\u002F02.purchase-orders",{"title":286,"icon":72,"path":287,"stem":288,"children":289,"page":27},"Manufacturing","\u002Fdevelopers\u002Fcore-api\u002Fmanufacturing","6.developers\u002F5.core-api\u002F04.manufacturing",[290,293,297,301],{"title":64,"path":291,"stem":292,"icon":72},"\u002Fdevelopers\u002Fcore-api\u002Fmanufacturing\u002Fboms","6.developers\u002F5.core-api\u002F04.manufacturing\u002F01.boms",{"title":294,"path":295,"stem":296,"icon":72},"Production processes","\u002Fdevelopers\u002Fcore-api\u002Fmanufacturing\u002Fproduction-processes","6.developers\u002F5.core-api\u002F04.manufacturing\u002F02.production-processes",{"title":298,"path":299,"stem":300,"icon":72},"Work orders","\u002Fdevelopers\u002Fcore-api\u002Fmanufacturing\u002Fwork-orders","6.developers\u002F5.core-api\u002F04.manufacturing\u002F03.work-orders",{"title":302,"path":303,"stem":304,"icon":72},"Work order templates","\u002Fdevelopers\u002Fcore-api\u002Fmanufacturing\u002Fwork-order-templates","6.developers\u002F5.core-api\u002F04.manufacturing\u002F04.work-order-templates",{"title":306,"icon":307,"path":308,"stem":309,"children":310,"page":27},"Sales","i-lucide-receipt","\u002Fdevelopers\u002Fcore-api\u002Fsales","6.developers\u002F5.core-api\u002F05.sales",[311,315,319,323],{"title":312,"path":313,"stem":314,"icon":307},"Orders","\u002Fdevelopers\u002Fcore-api\u002Fsales\u002Forders","6.developers\u002F5.core-api\u002F05.sales\u002F01.orders",{"title":316,"path":317,"stem":318,"icon":307},"Customers","\u002Fdevelopers\u002Fcore-api\u002Fsales\u002Fcustomers","6.developers\u002F5.core-api\u002F05.sales\u002F02.customers",{"title":320,"path":321,"stem":322,"icon":307},"Customer groups","\u002Fdevelopers\u002Fcore-api\u002Fsales\u002Fcustomer-groups","6.developers\u002F5.core-api\u002F05.sales\u002F03.customer-groups",{"title":324,"path":325,"stem":326,"icon":307},"Sales channels","\u002Fdevelopers\u002Fcore-api\u002Fsales\u002Fsales-channels","6.developers\u002F5.core-api\u002F05.sales\u002F04.sales-channels",{"title":328,"icon":57,"path":329,"stem":330,"children":331,"page":27},"Logistics","\u002Fdevelopers\u002Fcore-api\u002Flogistics","6.developers\u002F5.core-api\u002F06.logistics",[332,336,340,344,348,352,356,360,364,368,372],{"title":333,"path":334,"stem":335,"icon":57},"Shipments","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Fshipment","6.developers\u002F5.core-api\u002F06.logistics\u002F01.shipment",{"title":337,"path":338,"stem":339,"icon":57},"Carriers","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Fcarriers","6.developers\u002F5.core-api\u002F06.logistics\u002F02.carriers",{"title":341,"path":342,"stem":343,"icon":57},"Rates","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Frates","6.developers\u002F5.core-api\u002F06.logistics\u002F03.rates",{"title":345,"path":346,"stem":347,"icon":57},"Waybills","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Fwaybill","6.developers\u002F5.core-api\u002F06.logistics\u002F04.waybill",{"title":349,"path":350,"stem":351,"icon":57},"Delivery plans","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Fdelivery-plans","6.developers\u002F5.core-api\u002F06.logistics\u002F05.delivery-plans",{"title":353,"path":354,"stem":355,"icon":57},"Delivery zones","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Fdelivery-zones","6.developers\u002F5.core-api\u002F06.logistics\u002F06.delivery-zones",{"title":357,"path":358,"stem":359,"icon":57},"Vehicles","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Fvehicle","6.developers\u002F5.core-api\u002F06.logistics\u002F07.vehicle",{"title":361,"path":362,"stem":363,"icon":57},"Drivers","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Fdriver","6.developers\u002F5.core-api\u002F06.logistics\u002F08.driver",{"title":365,"path":366,"stem":367,"icon":57},"Dimension presets","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Fdimension-preset","6.developers\u002F5.core-api\u002F06.logistics\u002F09.dimension-preset",{"title":369,"path":370,"stem":371,"icon":57},"Fulfilment","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Ffulfillment","6.developers\u002F5.core-api\u002F06.logistics\u002F10.fulfillment",{"title":373,"path":374,"stem":375,"icon":57},"Schedules","\u002Fdevelopers\u002Fcore-api\u002Flogistics\u002Fschedule","6.developers\u002F5.core-api\u002F06.logistics\u002F11.schedule",{"title":377,"icon":102,"path":378,"stem":379,"children":380,"page":27},"Insights","\u002Fdevelopers\u002Fcore-api\u002Finsights","6.developers\u002F5.core-api\u002F07.insights",[381,385,389,393,397,401,405],{"title":382,"path":383,"stem":384,"icon":102},"Dashboard insights","\u002Fdevelopers\u002Fcore-api\u002Finsights\u002Fdashboard-insights","6.developers\u002F5.core-api\u002F07.insights\u002F01.dashboard-insights",{"title":386,"path":387,"stem":388,"icon":102},"Sales insights","\u002Fdevelopers\u002Fcore-api\u002Finsights\u002Fsales-insights","6.developers\u002F5.core-api\u002F07.insights\u002F02.sales-insights",{"title":390,"path":391,"stem":392,"icon":102},"Inventory insights","\u002Fdevelopers\u002Fcore-api\u002Finsights\u002Finventory-insights","6.developers\u002F5.core-api\u002F07.insights\u002F03.inventory-insights",{"title":394,"path":395,"stem":396,"icon":102},"Location insights","\u002Fdevelopers\u002Fcore-api\u002Finsights\u002Flocation-insights","6.developers\u002F5.core-api\u002F07.insights\u002F04.location-insights",{"title":398,"path":399,"stem":400,"icon":102},"Supplier insights","\u002Fdevelopers\u002Fcore-api\u002Finsights\u002Fsupplier-insights","6.developers\u002F5.core-api\u002F07.insights\u002F05.supplier-insights",{"title":402,"path":403,"stem":404,"icon":102},"Network insights","\u002Fdevelopers\u002Fcore-api\u002Finsights\u002Fnetwork-insights","6.developers\u002F5.core-api\u002F07.insights\u002F06.network-insights",{"title":406,"path":407,"stem":408,"icon":102},"AI Studio","\u002Fdevelopers\u002Fcore-api\u002Finsights\u002Fai-studio","6.developers\u002F5.core-api\u002F07.insights\u002F07.ai-studio",{"title":114,"icon":120,"path":410,"stem":411,"children":412,"page":27},"\u002Fdevelopers\u002Fcore-api\u002Fintegrations","6.developers\u002F5.core-api\u002F08.integrations",[413,416,420,424,428,432],{"title":114,"path":414,"stem":415,"icon":120},"\u002Fdevelopers\u002Fcore-api\u002Fintegrations\u002Fintegrations","6.developers\u002F5.core-api\u002F08.integrations\u002F01.integrations",{"title":417,"path":418,"stem":419,"icon":120},"Workflows","\u002Fdevelopers\u002Fcore-api\u002Fintegrations\u002Fworkflow","6.developers\u002F5.core-api\u002F08.integrations\u002F02.workflow",{"title":421,"path":422,"stem":423,"icon":120},"Triggers","\u002Fdevelopers\u002Fcore-api\u002Fintegrations\u002Ftriggers","6.developers\u002F5.core-api\u002F08.integrations\u002F03.triggers",{"title":425,"path":426,"stem":427,"icon":120},"Order integration","\u002Fdevelopers\u002Fcore-api\u002Fintegrations\u002Forder-integration","6.developers\u002F5.core-api\u002F08.integrations\u002F04.order-integration",{"title":429,"path":430,"stem":431,"icon":120},"Product integration","\u002Fdevelopers\u002Fcore-api\u002Fintegrations\u002Fproduct-integration","6.developers\u002F5.core-api\u002F08.integrations\u002F05.product-integration",{"title":433,"path":434,"stem":435,"icon":120},"Shipment integration","\u002Fdevelopers\u002Fcore-api\u002Fintegrations\u002Fshipment-integration","6.developers\u002F5.core-api\u002F08.integrations\u002F06.shipment-integration",{"title":437,"icon":438,"path":439,"stem":440,"children":441,"page":27},"Administration","i-lucide-settings","\u002Fdevelopers\u002Fcore-api\u002Fadministration","6.developers\u002F5.core-api\u002F09.administration",[442,446,450,454,458,462,465,468,472,476,480,484],{"title":443,"path":444,"stem":445,"icon":438},"Businesses","\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Fbusiness","6.developers\u002F5.core-api\u002F09.administration\u002F01.business",{"title":447,"path":448,"stem":449,"icon":438},"Configurations","\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Fconfigurations","6.developers\u002F5.core-api\u002F09.administration\u002F02.configurations",{"title":451,"path":452,"stem":453,"icon":438},"Roles","\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Froles","6.developers\u002F5.core-api\u002F09.administration\u002F03.roles",{"title":455,"path":456,"stem":457,"icon":438},"Teams","\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Fteams","6.developers\u002F5.core-api\u002F09.administration\u002F04.teams",{"title":459,"path":460,"stem":461,"icon":438},"Employees","\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Femployee","6.developers\u002F5.core-api\u002F09.administration\u002F05.employee",{"title":205,"path":463,"stem":464,"icon":438},"\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Fuser","6.developers\u002F5.core-api\u002F09.administration\u002F06.user",{"title":89,"path":466,"stem":467,"icon":438},"\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Fnotification","6.developers\u002F5.core-api\u002F09.administration\u002F07.notification",{"title":469,"path":470,"stem":471,"icon":438},"Push notifications","\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Fpush-notification","6.developers\u002F5.core-api\u002F09.administration\u002F08.push-notification",{"title":473,"path":474,"stem":475,"icon":438},"Files","\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Ffiles","6.developers\u002F5.core-api\u002F09.administration\u002F09.files",{"title":477,"path":478,"stem":479,"icon":438},"Lookups","\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Flookup","6.developers\u002F5.core-api\u002F09.administration\u002F10.lookup",{"title":481,"path":482,"stem":483,"icon":438},"Addresses","\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Faddress","6.developers\u002F5.core-api\u002F09.administration\u002F11.address",{"title":485,"path":486,"stem":487,"icon":438},"PDF generator","\u002Fdevelopers\u002Fcore-api\u002Fadministration\u002Fpdf-generator","6.developers\u002F5.core-api\u002F09.administration\u002F12.pdf-generator",{"id":489,"title":182,"body":490,"description":1712,"extension":1713,"links":1714,"meta":1715,"navigation":1716,"path":183,"reference":27,"seo":1717,"sitemap":1718,"stem":184,"__hash__":1719},"docs\u002F6.developers\u002F2.authentication.md",{"type":491,"value":492,"toc":1699},"minimark",[493,497,516,519,524,532,598,601,1183,1187,1198,1242,1251,1256,1266,1273,1277,1280,1475,1479,1498,1536,1539,1583,1589,1593,1608,1612,1618,1629,1633,1672,1679,1683,1695],[494,495,496],"p",{},"Miridia accepts two credentials:",[498,499,500,509],"ul",{},[501,502,503,504,508],"li",{},"A ",[505,506,507],"strong",{},"bearer token"," acts for a person. Use it in an application where a person logs in.",[501,510,511,512,515],{},"An ",[505,513,514],{},"API key"," acts for your organisation, without a person. Use it for a server, a script, or a connector.",[494,517,518],{},"The Global API issues both credentials. The Core API accepts both.",[520,521,523],"h2",{"id":522},"log-in","Log in",[494,525,526,527,531],{},"Send the email address and the password of the user to ",[528,529,530],"code",{},"POST \u002Fapi\u002Fauth\u002Flogin"," on the Global API.",[533,534,540],"pre",{"className":535,"code":536,"filename":537,"language":538,"meta":539,"style":539},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -X POST https:\u002F\u002Fglobal.miridia.io\u002Fapi\u002Fauth\u002Flogin \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"email\":\"you@example.com\",\"password\":\"\u003Cyour-password>\"}'\n","Terminal","bash","",[528,541,542,565,583],{"__ignoreMap":539},[543,544,547,551,555,558,561],"span",{"class":545,"line":546},"line",1,[543,548,550],{"class":549},"sBMFI","curl",[543,552,554],{"class":553},"sfazB"," -X",[543,556,557],{"class":553}," POST",[543,559,560],{"class":553}," https:\u002F\u002Fglobal.miridia.io\u002Fapi\u002Fauth\u002Flogin",[543,562,564],{"class":563},"sTEyZ"," \\\n",[543,566,568,571,575,578,581],{"class":545,"line":567},2,[543,569,570],{"class":553},"  -H",[543,572,574],{"class":573},"sMK4o"," \"",[543,576,577],{"class":553},"Content-Type: application\u002Fjson",[543,579,580],{"class":573},"\"",[543,582,564],{"class":563},[543,584,586,589,592,595],{"class":545,"line":585},3,[543,587,588],{"class":553},"  -d",[543,590,591],{"class":573}," '",[543,593,594],{"class":553},"{\"email\":\"you@example.com\",\"password\":\"\u003Cyour-password>\"}",[543,596,597],{"class":573},"'\n",[494,599,600],{},"The response has one of two shapes.",[602,603,604,844],"tabs",{},[605,606,608,611,837],"tabs-item",{"icon":208,"label":607},"One organisation",[494,609,610],{},"The user is a member of one organisation. The response holds a session.",[533,612,617],{"className":613,"code":614,"filename":615,"language":616,"meta":539,"style":539},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"data\": {\n    \"requiresOrganizationSelection\": false,\n    \"session\": {\n      \"accessToken\": \"eyJhbGciOiJSUzI1NiIs...\",\n      \"expiresAtUtc\": \"2026-09-29T09:00:00Z\",\n      \"organization\": { \"id\": \"...\", \"slug\": \"your-company\", \"name\": \"Your Company\" }\n    }\n  },\n  \"statusCode\": 200,\n  \"messages\": []\n}\n","Response","json",[528,618,619,624,641,656,670,694,715,787,793,799,816,831],{"__ignoreMap":539},[543,620,621],{"class":545,"line":546},[543,622,623],{"class":573},"{\n",[543,625,626,629,633,635,638],{"class":545,"line":567},[543,627,628],{"class":573},"  \"",[543,630,632],{"class":631},"spNyl","data",[543,634,580],{"class":573},[543,636,637],{"class":573},":",[543,639,640],{"class":573}," {\n",[543,642,643,646,649,651,653],{"class":545,"line":585},[543,644,645],{"class":573},"    \"",[543,647,648],{"class":549},"requiresOrganizationSelection",[543,650,580],{"class":573},[543,652,637],{"class":573},[543,654,655],{"class":573}," false,\n",[543,657,659,661,664,666,668],{"class":545,"line":658},4,[543,660,645],{"class":573},[543,662,663],{"class":549},"session",[543,665,580],{"class":573},[543,667,637],{"class":573},[543,669,640],{"class":573},[543,671,673,676,680,682,684,686,689,691],{"class":545,"line":672},5,[543,674,675],{"class":573},"      \"",[543,677,679],{"class":678},"sbssI","accessToken",[543,681,580],{"class":573},[543,683,637],{"class":573},[543,685,574],{"class":573},[543,687,688],{"class":553},"eyJhbGciOiJSUzI1NiIs...",[543,690,580],{"class":573},[543,692,693],{"class":573},",\n",[543,695,697,699,702,704,706,708,711,713],{"class":545,"line":696},6,[543,698,675],{"class":573},[543,700,701],{"class":678},"expiresAtUtc",[543,703,580],{"class":573},[543,705,637],{"class":573},[543,707,574],{"class":573},[543,709,710],{"class":553},"2026-09-29T09:00:00Z",[543,712,580],{"class":573},[543,714,693],{"class":573},[543,716,718,720,723,725,727,730,732,736,738,740,742,745,747,750,752,755,757,759,761,764,766,768,770,773,775,777,779,782,784],{"class":545,"line":717},7,[543,719,675],{"class":573},[543,721,722],{"class":678},"organization",[543,724,580],{"class":573},[543,726,637],{"class":573},[543,728,729],{"class":573}," {",[543,731,574],{"class":573},[543,733,735],{"class":734},"swJcz","id",[543,737,580],{"class":573},[543,739,637],{"class":573},[543,741,574],{"class":573},[543,743,744],{"class":553},"...",[543,746,580],{"class":573},[543,748,749],{"class":573},",",[543,751,574],{"class":573},[543,753,754],{"class":734},"slug",[543,756,580],{"class":573},[543,758,637],{"class":573},[543,760,574],{"class":573},[543,762,763],{"class":553},"your-company",[543,765,580],{"class":573},[543,767,749],{"class":573},[543,769,574],{"class":573},[543,771,772],{"class":734},"name",[543,774,580],{"class":573},[543,776,637],{"class":573},[543,778,574],{"class":573},[543,780,781],{"class":553},"Your Company",[543,783,580],{"class":573},[543,785,786],{"class":573}," }\n",[543,788,790],{"class":545,"line":789},8,[543,791,792],{"class":573},"    }\n",[543,794,796],{"class":545,"line":795},9,[543,797,798],{"class":573},"  },\n",[543,800,802,804,807,809,811,814],{"class":545,"line":801},10,[543,803,628],{"class":573},[543,805,806],{"class":631},"statusCode",[543,808,580],{"class":573},[543,810,637],{"class":573},[543,812,813],{"class":678}," 200",[543,815,693],{"class":573},[543,817,819,821,824,826,828],{"class":545,"line":818},11,[543,820,628],{"class":573},[543,822,823],{"class":631},"messages",[543,825,580],{"class":573},[543,827,637],{"class":573},[543,829,830],{"class":573}," []\n",[543,832,834],{"class":545,"line":833},12,[543,835,836],{"class":573},"}\n",[494,838,839,840,843],{},"Use ",[528,841,842],{},"data.session.accessToken"," as the bearer token.",[605,845,847,850,1116,1123,1180],{"icon":87,"label":846},"More than one organisation",[494,848,849],{},"The user is a member of more than one organisation. The response holds a selection token and the list of organisations.",[533,851,853],{"className":613,"code":852,"filename":615,"language":616,"meta":539,"style":539},"{\n  \"data\": {\n    \"requiresOrganizationSelection\": true,\n    \"selectionToken\": \"eyJhbGciOiJSUzI1NiIs...\",\n    \"selectionExpiresAtUtc\": \"2026-09-29T08:05:00Z\",\n    \"organizations\": [\n      { \"id\": \"0f8e...\", \"slug\": \"north\", \"name\": \"North Ltd\", \"isOwner\": true },\n      { \"id\": \"7c21...\", \"slug\": \"south\", \"name\": \"South Ltd\", \"isOwner\": false }\n    ]\n  },\n  \"statusCode\": 200,\n  \"messages\": []\n}\n",[528,854,855,859,871,884,903,923,937,1008,1076,1081,1085,1099,1111],{"__ignoreMap":539},[543,856,857],{"class":545,"line":546},[543,858,623],{"class":573},[543,860,861,863,865,867,869],{"class":545,"line":567},[543,862,628],{"class":573},[543,864,632],{"class":631},[543,866,580],{"class":573},[543,868,637],{"class":573},[543,870,640],{"class":573},[543,872,873,875,877,879,881],{"class":545,"line":585},[543,874,645],{"class":573},[543,876,648],{"class":549},[543,878,580],{"class":573},[543,880,637],{"class":573},[543,882,883],{"class":573}," true,\n",[543,885,886,888,891,893,895,897,899,901],{"class":545,"line":658},[543,887,645],{"class":573},[543,889,890],{"class":549},"selectionToken",[543,892,580],{"class":573},[543,894,637],{"class":573},[543,896,574],{"class":573},[543,898,688],{"class":553},[543,900,580],{"class":573},[543,902,693],{"class":573},[543,904,905,907,910,912,914,916,919,921],{"class":545,"line":672},[543,906,645],{"class":573},[543,908,909],{"class":549},"selectionExpiresAtUtc",[543,911,580],{"class":573},[543,913,637],{"class":573},[543,915,574],{"class":573},[543,917,918],{"class":553},"2026-09-29T08:05:00Z",[543,920,580],{"class":573},[543,922,693],{"class":573},[543,924,925,927,930,932,934],{"class":545,"line":696},[543,926,645],{"class":573},[543,928,929],{"class":549},"organizations",[543,931,580],{"class":573},[543,933,637],{"class":573},[543,935,936],{"class":573}," [\n",[543,938,939,942,944,946,948,950,952,955,957,959,961,963,965,967,969,972,974,976,978,980,982,984,986,989,991,993,995,998,1000,1002,1005],{"class":545,"line":717},[543,940,941],{"class":573},"      {",[543,943,574],{"class":573},[543,945,735],{"class":678},[543,947,580],{"class":573},[543,949,637],{"class":573},[543,951,574],{"class":573},[543,953,954],{"class":553},"0f8e...",[543,956,580],{"class":573},[543,958,749],{"class":573},[543,960,574],{"class":573},[543,962,754],{"class":678},[543,964,580],{"class":573},[543,966,637],{"class":573},[543,968,574],{"class":573},[543,970,971],{"class":553},"north",[543,973,580],{"class":573},[543,975,749],{"class":573},[543,977,574],{"class":573},[543,979,772],{"class":678},[543,981,580],{"class":573},[543,983,637],{"class":573},[543,985,574],{"class":573},[543,987,988],{"class":553},"North Ltd",[543,990,580],{"class":573},[543,992,749],{"class":573},[543,994,574],{"class":573},[543,996,997],{"class":678},"isOwner",[543,999,580],{"class":573},[543,1001,637],{"class":573},[543,1003,1004],{"class":573}," true",[543,1006,1007],{"class":573}," },\n",[543,1009,1010,1012,1014,1016,1018,1020,1022,1025,1027,1029,1031,1033,1035,1037,1039,1042,1044,1046,1048,1050,1052,1054,1056,1059,1061,1063,1065,1067,1069,1071,1074],{"class":545,"line":789},[543,1011,941],{"class":573},[543,1013,574],{"class":573},[543,1015,735],{"class":678},[543,1017,580],{"class":573},[543,1019,637],{"class":573},[543,1021,574],{"class":573},[543,1023,1024],{"class":553},"7c21...",[543,1026,580],{"class":573},[543,1028,749],{"class":573},[543,1030,574],{"class":573},[543,1032,754],{"class":678},[543,1034,580],{"class":573},[543,1036,637],{"class":573},[543,1038,574],{"class":573},[543,1040,1041],{"class":553},"south",[543,1043,580],{"class":573},[543,1045,749],{"class":573},[543,1047,574],{"class":573},[543,1049,772],{"class":678},[543,1051,580],{"class":573},[543,1053,637],{"class":573},[543,1055,574],{"class":573},[543,1057,1058],{"class":553},"South Ltd",[543,1060,580],{"class":573},[543,1062,749],{"class":573},[543,1064,574],{"class":573},[543,1066,997],{"class":678},[543,1068,580],{"class":573},[543,1070,637],{"class":573},[543,1072,1073],{"class":573}," false",[543,1075,786],{"class":573},[543,1077,1078],{"class":545,"line":795},[543,1079,1080],{"class":573},"    ]\n",[543,1082,1083],{"class":545,"line":801},[543,1084,798],{"class":573},[543,1086,1087,1089,1091,1093,1095,1097],{"class":545,"line":818},[543,1088,628],{"class":573},[543,1090,806],{"class":631},[543,1092,580],{"class":573},[543,1094,637],{"class":573},[543,1096,813],{"class":678},[543,1098,693],{"class":573},[543,1100,1101,1103,1105,1107,1109],{"class":545,"line":833},[543,1102,628],{"class":573},[543,1104,823],{"class":631},[543,1106,580],{"class":573},[543,1108,637],{"class":573},[543,1110,830],{"class":573},[543,1112,1114],{"class":545,"line":1113},13,[543,1115,836],{"class":573},[494,1117,1118,1119,1122],{},"Send the selection token as a bearer token to ",[528,1120,1121],{},"POST \u002Fapi\u002Fauth\u002Fselect-organization",", with the id of the organisation. The response holds a session.",[533,1124,1126],{"className":535,"code":1125,"filename":537,"language":538,"meta":539,"style":539},"curl -X POST https:\u002F\u002Fglobal.miridia.io\u002Fapi\u002Fauth\u002Fselect-organization \\\n  -H \"Authorization: Bearer $SELECTION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"organizationId\":\"0f8e...\"}'\n",[528,1127,1128,1141,1157,1169],{"__ignoreMap":539},[543,1129,1130,1132,1134,1136,1139],{"class":545,"line":546},[543,1131,550],{"class":549},[543,1133,554],{"class":553},[543,1135,557],{"class":553},[543,1137,1138],{"class":553}," https:\u002F\u002Fglobal.miridia.io\u002Fapi\u002Fauth\u002Fselect-organization",[543,1140,564],{"class":563},[543,1142,1143,1145,1147,1150,1153,1155],{"class":545,"line":567},[543,1144,570],{"class":553},[543,1146,574],{"class":573},[543,1148,1149],{"class":553},"Authorization: Bearer ",[543,1151,1152],{"class":563},"$SELECTION_TOKEN",[543,1154,580],{"class":573},[543,1156,564],{"class":563},[543,1158,1159,1161,1163,1165,1167],{"class":545,"line":585},[543,1160,570],{"class":553},[543,1162,574],{"class":573},[543,1164,577],{"class":553},[543,1166,580],{"class":573},[543,1168,564],{"class":563},[543,1170,1171,1173,1175,1178],{"class":545,"line":658},[543,1172,588],{"class":553},[543,1174,591],{"class":573},[543,1176,1177],{"class":553},"{\"organizationId\":\"0f8e...\"}",[543,1179,597],{"class":573},[494,1181,1182],{},"The selection token expires after a short time. If it expires, log in again.",[520,1184,1186],{"id":1185},"send-a-bearer-token","Send a bearer token",[494,1188,1189,1190,1193,1194,1197],{},"Send the access token in the ",[528,1191,1192],{},"Authorization"," header. Send the business in the ",[528,1195,1196],{},"X-Business-Id"," header.",[533,1199,1201],{"className":535,"code":1200,"filename":537,"language":538,"meta":539,"style":539},"curl https:\u002F\u002Fapi.miridia.io\u002Fapi\u002Fv1\u002Fpurchase-orders \\\n  -H \"Authorization: Bearer $MIRIDIA_TOKEN\" \\\n  -H \"X-Business-Id: $MIRIDIA_BUSINESS_ID\"\n",[528,1202,1203,1212,1227],{"__ignoreMap":539},[543,1204,1205,1207,1210],{"class":545,"line":546},[543,1206,550],{"class":549},[543,1208,1209],{"class":553}," https:\u002F\u002Fapi.miridia.io\u002Fapi\u002Fv1\u002Fpurchase-orders",[543,1211,564],{"class":563},[543,1213,1214,1216,1218,1220,1223,1225],{"class":545,"line":567},[543,1215,570],{"class":553},[543,1217,574],{"class":573},[543,1219,1149],{"class":553},[543,1221,1222],{"class":563},"$MIRIDIA_TOKEN",[543,1224,580],{"class":573},[543,1226,564],{"class":563},[543,1228,1229,1231,1233,1236,1239],{"class":545,"line":585},[543,1230,570],{"class":553},[543,1232,574],{"class":573},[543,1234,1235],{"class":553},"X-Business-Id: ",[543,1237,1238],{"class":563},"$MIRIDIA_BUSINESS_ID",[543,1240,1241],{"class":573},"\"\n",[494,1243,1244,1245,1248,1249,1197],{},"To find the businesses of the user, send ",[528,1246,1247],{},"GET \u002Fapi\u002Fme"," to the Core API. This operation does not need the ",[528,1250,1196],{},[1252,1253,1255],"h3",{"id":1254},"refresh-the-session","Refresh the session",[494,1257,1258,1259,1261,1262,1265],{},"An access token is valid for a short time. The value of ",[528,1260,701],{}," tells you when it expires. The login response also sets a refresh cookie. To get a new access token, send ",[528,1263,1264],{},"POST \u002Fapi\u002Fauth\u002Fnew-token"," with that cookie. A browser application sends the cookie automatically.",[494,1267,1268,1269,1272],{},"To end the session, send ",[528,1270,1271],{},"POST \u002Fapi\u002Fauth\u002Flogout",".",[520,1274,1276],{"id":1275},"use-an-api-key","Use an API key",[494,1278,1279],{},"An API key does not expire unless you give it a time to live. It is the correct credential for a system that calls Miridia.",[1281,1282,1283,1287,1294,1349,1426,1430,1437,1441,1447],"steps",{},[1252,1284,1286],{"id":1285},"make-the-key","Make the key",[494,1288,1289,1290,1293],{},"Log in as an owner of the organisation. Then send ",[528,1291,1292],{},"POST \u002Fapi\u002Fauth\u002Ftokens"," to the Global API.",[533,1295,1297],{"className":535,"code":1296,"filename":537,"language":538,"meta":539,"style":539},"curl -X POST https:\u002F\u002Fglobal.miridia.io\u002Fapi\u002Fauth\u002Ftokens \\\n  -H \"Authorization: Bearer $MIRIDIA_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"label\":\"Warehouse scanner\",\"businessId\":\"\u003Cbusiness-id>\",\"ttlMinutes\":null,\"scopes\":null}'\n",[528,1298,1299,1312,1326,1338],{"__ignoreMap":539},[543,1300,1301,1303,1305,1307,1310],{"class":545,"line":546},[543,1302,550],{"class":549},[543,1304,554],{"class":553},[543,1306,557],{"class":553},[543,1308,1309],{"class":553}," https:\u002F\u002Fglobal.miridia.io\u002Fapi\u002Fauth\u002Ftokens",[543,1311,564],{"class":563},[543,1313,1314,1316,1318,1320,1322,1324],{"class":545,"line":567},[543,1315,570],{"class":553},[543,1317,574],{"class":573},[543,1319,1149],{"class":553},[543,1321,1222],{"class":563},[543,1323,580],{"class":573},[543,1325,564],{"class":563},[543,1327,1328,1330,1332,1334,1336],{"class":545,"line":585},[543,1329,570],{"class":553},[543,1331,574],{"class":573},[543,1333,577],{"class":553},[543,1335,580],{"class":573},[543,1337,564],{"class":563},[543,1339,1340,1342,1344,1347],{"class":545,"line":658},[543,1341,588],{"class":553},[543,1343,591],{"class":573},[543,1345,1346],{"class":553},"{\"label\":\"Warehouse scanner\",\"businessId\":\"\u003Cbusiness-id>\",\"ttlMinutes\":null,\"scopes\":null}",[543,1348,597],{"class":573},[1350,1351,1352,1368],"table",{},[1353,1354,1355],"thead",{},[1356,1357,1358,1362,1365],"tr",{},[1359,1360,1361],"th",{},"Field",[1359,1363,1364],{},"Required",[1359,1366,1367],{},"Description",[1369,1370,1371,1385,1398,1410],"tbody",{},[1356,1372,1373,1379,1382],{},[1374,1375,1376],"td",{},[528,1377,1378],{},"businessId",[1374,1380,1381],{},"Yes",[1374,1383,1384],{},"The business that the key acts for.",[1356,1386,1387,1392,1395],{},[1374,1388,1389],{},[528,1390,1391],{},"label",[1374,1393,1394],{},"No",[1374,1396,1397],{},"A name that tells you where the key is in use.",[1356,1399,1400,1405,1407],{},[1374,1401,1402],{},[528,1403,1404],{},"ttlMinutes",[1374,1406,1394],{},[1374,1408,1409],{},"The life of the key, in minutes. Leave it empty for a key that does not expire.",[1356,1411,1412,1417,1419],{},[1374,1413,1414],{},[528,1415,1416],{},"scopes",[1374,1418,1394],{},[1374,1420,1421,1422,1425],{},"The permissions of the key, as JSON: ",[528,1423,1424],{},"{ \"ModuleName\": bitmask }",". Leave it empty for a key with full access.",[1252,1427,1429],{"id":1428},"keep-the-key-secret","Keep the key secret",[494,1431,1432,1433,1436],{},"The response holds the key in ",[528,1434,1435],{},"data.token",". Miridia shows the key only one time. Put it in a secret store. Do not put it in source code or in a browser application.",[1252,1438,1440],{"id":1439},"send-the-key","Send the key",[494,1442,1443,1444,1197],{},"Send the key in the ",[528,1445,1446],{},"x-dispatch-api-key",[533,1448,1450],{"className":535,"code":1449,"filename":537,"language":538,"meta":539,"style":539},"curl https:\u002F\u002Fapi.miridia.io\u002Fapi\u002Fv1\u002FProducts \\\n  -H \"x-dispatch-api-key: $MIRIDIA_API_KEY\"\n",[528,1451,1452,1461],{"__ignoreMap":539},[543,1453,1454,1456,1459],{"class":545,"line":546},[543,1455,550],{"class":549},[543,1457,1458],{"class":553}," https:\u002F\u002Fapi.miridia.io\u002Fapi\u002Fv1\u002FProducts",[543,1460,564],{"class":563},[543,1462,1463,1465,1467,1470,1473],{"class":545,"line":567},[543,1464,570],{"class":553},[543,1466,574],{"class":573},[543,1468,1469],{"class":553},"x-dispatch-api-key: ",[543,1471,1472],{"class":563},"$MIRIDIA_API_KEY",[543,1474,1241],{"class":573},[1252,1476,1478],{"id":1477},"limit-a-key-with-scopes","Limit a key with scopes",[494,1480,1481,1482,1485,1486,1489,1490,1493,1494,1497],{},"A scope gives the key a permission on one module. The bitmask adds the actions: ",[528,1483,1484],{},"1"," is view, ",[528,1487,1488],{},"2"," is modify, and ",[528,1491,1492],{},"4"," is delete. For example, ",[528,1495,1496],{},"7"," gives all three actions.",[533,1499,1502],{"className":613,"code":1500,"filename":1501,"language":616,"meta":539,"style":539},"{ \"Products\": 1, \"PurchaseOrders\": 3 }\n","Scopes",[528,1503,1504],{"__ignoreMap":539},[543,1505,1506,1509,1511,1513,1515,1517,1520,1522,1524,1527,1529,1531,1534],{"class":545,"line":546},[543,1507,1508],{"class":573},"{",[543,1510,574],{"class":573},[543,1512,34],{"class":631},[543,1514,580],{"class":573},[543,1516,637],{"class":573},[543,1518,1519],{"class":678}," 1",[543,1521,749],{"class":573},[543,1523,574],{"class":573},[543,1525,1526],{"class":631},"PurchaseOrders",[543,1528,580],{"class":573},[543,1530,637],{"class":573},[543,1532,1533],{"class":678}," 3",[543,1535,786],{"class":573},[494,1537,1538],{},"This key can read products. It can read and change purchase orders. It cannot do anything else.",[494,1540,1541,1542,1544,1545,1544,1547,1544,1549,1544,1551,1544,1553,1544,1555,1544,1558,1544,1561,1544,1563,1544,1566,1544,1568,1544,1570,1544,1572,1544,1575,1578,1579,1582],{},"The modules are ",[528,1543,312],{},", ",[528,1546,333],{},[528,1548,316],{},[528,1550,34],{},[528,1552,357],{},[528,1554,114],{},[528,1556,1557],{},"TeamAndRoles",[528,1559,1560],{},"Billing",[528,1562,417],{},[528,1564,1565],{},"Settings",[528,1567,377],{},[528,1569,278],{},[528,1571,1526],{},[528,1573,1574],{},"WorkOrders",[528,1576,1577],{},"TransferOrders",", and ",[528,1580,1581],{},"Schedule",". Each operation in the reference tells you the permission that it needs.",[1584,1585,1586],"tip",{},[494,1587,1588],{},"Give each system its own key, with only the scopes that it needs. Then you can revoke one key without an effect on the other systems.",[1252,1590,1592],{"id":1591},"list-and-revoke-keys","List and revoke keys",[498,1594,1595,1601],{},[501,1596,1597,1598,1272],{},"To list the keys of your organisation, send ",[528,1599,1600],{},"GET \u002Fapi\u002Fauth\u002Ftokens",[501,1602,1603,1604,1607],{},"To revoke a key, send ",[528,1605,1606],{},"DELETE \u002Fapi\u002Fauth\u002Ftokens\u002F{id}",". The key stops at once.",[520,1609,1611],{"id":1610},"permissions","Permissions",[494,1613,1614,1615,1617],{},"Each operation of the Core API needs a permission on one module, for example ",[528,1616,1526],{}," view. The role of the user gives the permissions of a bearer token. The scopes give the permissions of an API key.",[494,1619,1620,1621,1624,1625,1628],{},"If the credential does not have the permission, the API returns ",[528,1622,1623],{},"403",". Read ",[1626,1627,84],"a",{"href":85}," for the roles.",[520,1630,1632],{"id":1631},"errors","Errors",[1350,1634,1635,1645],{},[1353,1636,1637],{},[1356,1638,1639,1642],{},[1359,1640,1641],{},"Status",[1359,1643,1644],{},"Cause",[1369,1646,1647,1660],{},[1356,1648,1649,1654],{},[1374,1650,1651],{},[528,1652,1653],{},"401",[1374,1655,1656,1657,1659],{},"The credential is missing or not valid, or the ",[528,1658,1196],{}," header names a business that the user cannot use.",[1356,1661,1662,1666],{},[1374,1663,1664],{},[528,1665,1623],{},[1374,1667,1668,1669,1671],{},"The credential is valid, but it does not have the permission. An expired token also gives ",[528,1670,1623],{}," on the Core API.",[494,1673,1674,1675,1678],{},"Read ",[1626,1676,187],{"href":1677},"\u002Fdevelopers\u002Fconventions#errors"," for the error body.",[520,1680,1682],{"id":1681},"reference","Reference",[498,1684,1685,1690],{},[501,1686,1687],{},[1626,1688,1689],{"href":197},"Global API: Authentication",[501,1691,1692],{},[1626,1693,1694],{"href":201},"Global API: Organizations",[1696,1697,1698],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}",{"title":539,"searchDepth":546,"depth":567,"links":1700},[1701,1702,1705,1709,1710,1711],{"id":522,"depth":567,"text":523},{"id":1185,"depth":567,"text":1186,"children":1703},[1704],{"id":1254,"depth":585,"text":1255},{"id":1275,"depth":567,"text":1276,"children":1706},[1707,1708],{"id":1477,"depth":585,"text":1478},{"id":1591,"depth":585,"text":1592},{"id":1610,"depth":567,"text":1611},{"id":1631,"depth":567,"text":1632},{"id":1681,"depth":567,"text":1682},"Log in with the Global API, send a bearer token or an API key, and choose the business for each request.","md",null,{},{"icon":185},{"title":182,"description":1712},{"loc":183},"2XZw7ynNDq6RmN4oBqrTdZ3kFvqOYONqBr-tHFBmWVI",[1721,1723],{"title":179,"path":175,"stem":176,"description":1722,"icon":180,"children":-1},"The two Miridia APIs, their hosts, and how a request finds your organisation and your business.",{"title":187,"path":188,"stem":189,"description":1724,"icon":190,"children":-1},"The response envelopes, paging, filters, enums, dates, partial updates, and errors that each operation uses.",1790689638821]