Create a stock sale document that reduces inventory quantities. The payload follows the same line-item structure as income/invoice (date, customer, items[] with item_name, quantity, selling_price, category). COGS is computed automatically from cost_price.
Branch id. Same as branch_uuid. Leave both off to use the business default branch. A name is not accepted, and a new branch is not created. An id that is not one of your branches is still saved, but it will not show under a location in reports.
Department id. Same as department_uuid. An unknown id is saved as sent and does not create a department. To add one from a name, send department_name and leave this off.
Department name. Capitalization does not matter. If no department has that name, Tyms adds one and tags this document with it. Ignored when department or department_uuid is set.
Project id from GET /projects. An unknown id is saved as sent and does not create a project. To add one from a name, send project_name and leave this off.
Project name, matched exactly, including capital letters. If no project has that name, Tyms adds an active project that starts today and ends in one month, then tags this document with it. Ignored when project_uuid is set.
Team member id. Same as employee_uuid. An unknown id is saved as sent and does not add a person. To add one from a name, send employee_name and leave this off.
Pagination (page, limit, total) and/or report range (from, to). Cash flow may include previous_period_end.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tyms Developer API","colors":{"primary":"#6D28D9","light":"#8B5CF6","dark":"#5B21B6"},"logo":{"light":"https://mintcdn.com/useadamio/bSPxu4ZTH4vIIJob/logo/light.svg?fit=max\u0026auto=format\u0026n=bSPxu4ZTH4vIIJob\u0026q=85\u0026s=6d0cb3c0725d43766203684a0cf5c61c","dark":"https://mintcdn.com/useadamio/bSPxu4ZTH4vIIJob/logo/dark.svg?fit=max\u0026auto=format\u0026n=bSPxu4ZTH4vIIJob\u0026q=85\u0026s=786fd3a6adff1ecfd1c2402ef822d271"},"favicon":"https://mintcdn.com/useadamio/bSPxu4ZTH4vIIJob/icon.svg?fit=max\u0026auto=format\u0026n=bSPxu4ZTH4vIIJob\u0026q=85\u0026s=9a71cdd99b1161f77c753fc583e05ca6","api":{"openapi":"openapi/adam-v1.json","params":{"expanded":"all"},"playground":{"display":"interactive","proxy":true},"examples":{"defaults":"all","languages":["bash","python","javascript"],"prefill":true,"autogenerate":true},"url":"full","mdx":{"auth":{"method":"key","name":"X-API-Key"},"server":"https://api.tyms.io/v1/adam"}},"navbar":{"links":[{"href":"https://help.tyms.io","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.tyms.io"}},"footer":{"socials":{"website":"https://www.tyms.io","linkedin":"https://linkedin.com/company/tyms-io","x":"https://x.com/tyms_io"}},"fonts":{"heading":{"family":"Newsreader","weight":350},"body":{"family":"Instrument Sans","weight":400}},"contextual":{"options":["chatgpt","claude","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"useadamio","hasAudioNarration":false,"actualSubdomain":"useadamio","customDomains":["developer.tyms.io"],"gitSource":{"type":"github","owner":"tymsinc","repo":"useadam_documentation","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a72fb94287656fd2b06944c","collectionId":"9c6af3dc-2a85-4cf7-a5d7-4e84e7d3d18a","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a72fb94287656fd2b06944c"},"entitlements":{},"buildId":"6ae0821a6c1a15a18d9d66f9","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"API reference","count":133},{"language":"default","tag":"MCP and AI","count":14},{"language":"default","tag":"Quotes","count":10},{"language":"default","tag":"Documentation","count":9},{"language":"default","tag":"Inventory","count":9},{"language":"default","tag":"Getting started","count":8},{"language":"default","tag":"Bills","count":8},{"language":"default","tag":"Chart of accounts","count":8},{"language":"default","tag":"Invoices","count":8},{"language":"default","tag":"Purchase Orders","count":8}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/inventory/sell-stock","slug":"/api-reference/inventory/sell-stock","pageMetadata":{"title":"Sell stock","description":"Create a stock sale document that reduces inventory quantities. The payload follows the same line-item structure as income/invoice (`date`, `customer`, `items[]` with `item_name`, `quantity`, `selling_price`, `category`). COGS is computed automatically from cost_price.","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /inventories/sell","href":"/api-reference/inventory/sell-stock","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Create a stock sale document that reduces inventory quantities. The payload follows the same line-item structure as income/invoice (\", _jsx(_components.code, {\n children: \"date\"\n }), \", \", _jsx(_components.code, {\n children: \"customer\"\n }), \", \", _jsx(_components.code, {\n children: \"items[]\"\n }), \" with \", _jsx(_components.code, {\n children: \"item_name\"\n }), \", \", _jsx(_components.code, {\n children: \"quantity\"\n }), \", \", _jsx(_components.code, {\n children: \"selling_price\"\n }), \", \", _jsx(_components.code, {\n children: \"category\"\n }), \"). COGS is computed automatically from cost_price.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Sell stock","description":"Create a stock sale document that reduces inventory quantities. The payload follows the same line-item structure as income/invoice (`date`, `customer`, `items[]` with `item_name`, `quantity`, `selling_price`, `category`). COGS is computed automatically from cost_price.","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /inventories/sell","href":"/api-reference/inventory/sell-stock","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"sellInventory","tags":["Inventory"],"summary":"Sell stock","description":"Create a stock sale document that reduces inventory quantities. The payload follows the same line-item structure as income/invoice (`date`, `customer`, `items[]` with `item_name`, `quantity`, `selling_price`, `category`). COGS is computed automatically from cost_price.","requestBody":"6b6f48c1-c85f-403a-b1d5-8bcace703ba8","responses":{"200":"e46c9ce5-a689-437f-b377-3842133d2d04","400":"621e0594-de14-4c56-b795-f240bd49f2c5"},"method":"post","type":"path","servers":["6ab02ce9-69a6-48cc-8431-23c6a59ae502","84cb2c32-46a9-45f0-897d-f0943b19cd7f"],"security":["e2c747a1-f276-40d6-86a8-e0213a878e16"],"path":"/inventories/sell","baseUrlOptions":["https://staging-api.tyms.io/v1/adam","https://api.tyms.io/v1/adam"],"title":"Sell stock","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.date":"2026-03-04","body.\\items.items.0.item_name":"Consulting package","body.\\items.items.0.quantity":1,"body.\\items.items.0.selling_price":75000,"body.\\items.items.0.category":"Service Income","body.\\items.items.0.tax":7.5,"body.payment_category":"Cash on Hand","body.currency":"NGN","body.customer":"a1b2c3d4e5f6478990a1b2c3d4e5f678","body.document_number":"RCT-881","body.narration":"Walk-in sale — March 4"}],"urlDisplay":"full"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["date","items","payment_category"],"example":{"date":"2026-03-04","currency":"NGN","document_number":"RCT-881","narration":"Walk-in sale — March 4","customer":"a1b2c3d4e5f6478990a1b2c3d4e5f678","payment_category":"Cash on Hand","items":[{"item_name":"Consulting package","quantity":1,"selling_price":75000,"category":"Service Income","tax":7.5}]},"properties":{"date":{"type":"string","format":"date","isRequired":true,"uniqueKey":"date","typeLabel":"string\u003cdate>"},"items":{"type":"array","minItems":1,"items":{"type":"object","required":["item_name","quantity","selling_price","category"],"properties":{"item_name":{"type":"string","description":"Line label. Alias: `name`.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].item_name","typeLabel":"string"},"quantity":{"type":"number","description":"Quantity sold or purchased.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].quantity","typeLabel":"number"},"selling_price":{"type":"number","description":"Unit price. On bills this is unit cost. Alias: `price`.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].selling_price","typeLabel":"number"},"category":{"type":"string","description":"Required. Revenue, expense, or inventory account — name, uuid, or account code.","isRequired":true,"uniqueKey":"\\items.items.[INDEX].category","typeLabel":"string"},"description":{"type":"string","description":"Optional line description.","uniqueKey":"\\items.items.[INDEX].description","typeLabel":"string"},"tax":{"type":"number","description":"Tax rate as a percentage (e.g. `7.5` = 7.5%). Preferred over `tax_uuid`.","uniqueKey":"\\items.items.[INDEX].tax","typeLabel":"number"},"tax_uuid":{"type":"string","description":"Optional tax record uuid instead of `tax` percentage.","uniqueKey":"\\items.items.[INDEX].tax_uuid","typeLabel":"string"},"withholding_tax":{"type":"number","description":"Withholding tax (WHT) rate as a percentage.","uniqueKey":"\\items.items.[INDEX].withholding_tax","typeLabel":"number"},"withholding_tax_uuid":{"type":"string","description":"Optional WHT uuid instead of `withholding_tax` percentage.","uniqueKey":"\\items.items.[INDEX].withholding_tax_uuid","typeLabel":"string"},"discount":{"type":"number","description":"Line discount value.","uniqueKey":"\\items.items.[INDEX].discount","typeLabel":"number"},"discount_type":{"type":"string","enum":["percent","amount","fixed"],"description":"`percent` or `amount` / `fixed`.","uniqueKey":"\\items.items.[INDEX].discount_type","typeLabel":"enum\u003cstring>"},"is_inventory":{"type":"boolean","description":"`true` if the line affects stock.","uniqueKey":"\\items.items.[INDEX].is_inventory","typeLabel":"boolean"},"uuid":{"type":"string","description":"Existing inventory item uuid when linking stock.","uniqueKey":"\\items.items.[INDEX].uuid","typeLabel":"string"}},"uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"\\items","typeLabel":"object[]"},"payment_category":{"type":"string","description":"Cash or bank **name** received into. Payment is assumed in full from the line totals — do not send `amount_paid` (that key is only for invoices and bills).","isRequired":true,"uniqueKey":"payment_category","typeLabel":"string"},"currency":{"type":"string","uniqueKey":"currency","typeLabel":"string"},"customer":{"type":"string","uniqueKey":"customer","typeLabel":"string"},"document_number":{"type":"string","description":"Returned as `receipt_no`.","uniqueKey":"document_number","typeLabel":"string"},"narration":{"type":"string","uniqueKey":"narration","typeLabel":"string"},"is_prepayment":{"type":"boolean","description":"Set `true` (or `1`) to create a `prepaid_income` record (unearned revenue). The income is deferred and recognized monthly over `prepayment_duration`.","uniqueKey":"is_prepayment","typeLabel":"boolean"},"prepayment_duration":{"type":"integer","description":"Number of months to recognize the prepaid income over. Required when `is_prepayment` is true.","uniqueKey":"prepayment_duration","typeLabel":"integer"},"prepayment_account":{"type":"string","description":"Liability account name (unearned revenue) for the deferred balance. Defaults to the business unearned revenue account.","uniqueKey":"prepayment_account","typeLabel":"string"},"branch":{"type":"string","description":"Branch id. Same as `branch_uuid`. Leave both off to use the business default branch. A name is not accepted, and a new branch is not created. An id that is not one of your branches is still saved, but it will not show under a location in reports.","uniqueKey":"branch","typeLabel":"string"},"branch_uuid":{"type":"string","description":"Branch id from `GET /branches`. Alias: `branch`.","uniqueKey":"branch_uuid","typeLabel":"string"},"department":{"type":"string","description":"Department id. Same as `department_uuid`. An unknown id is saved as sent and does not create a department. To add one from a name, send `department_name` and leave this off.","uniqueKey":"department","typeLabel":"string"},"department_uuid":{"type":"string","description":"Department id from `GET /departments`. Alias: `department`.","uniqueKey":"department_uuid","typeLabel":"string"},"department_name":{"type":"string","description":"Department name. Capitalization does not matter. If no department has that name, Tyms adds one and tags this document with it. Ignored when `department` or `department_uuid` is set.","uniqueKey":"department_name","typeLabel":"string"},"project_uuid":{"type":"string","description":"Project id from `GET /projects`. An unknown id is saved as sent and does not create a project. To add one from a name, send `project_name` and leave this off.","uniqueKey":"project_uuid","typeLabel":"string"},"project_name":{"type":"string","description":"Project name, matched exactly, including capital letters. If no project has that name, Tyms adds an active project that starts today and ends in one month, then tags this document with it. Ignored when `project_uuid` is set.","uniqueKey":"project_name","typeLabel":"string"},"employee":{"type":"string","description":"Team member id. Same as `employee_uuid`. An unknown id is saved as sent and does not add a person. To add one from a name, send `employee_name` and leave this off.","uniqueKey":"employee","typeLabel":"string"},"employee_uuid":{"type":"string","description":"Team member id. Alias: `employee`.","uniqueKey":"employee_uuid","typeLabel":"string"},"employee_name":{"type":"string","description":"Full name of the team member. If nobody matches, Tyms adds them. Ignored when `employee` or `employee_uuid` is set.","uniqueKey":"employee_name","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"date":"2026-03-04","currency":"NGN","document_number":"RCT-881","narration":"Walk-in sale — March 4","customer":"a1b2c3d4e5f6478990a1b2c3d4e5f678","payment_category":"Cash on Hand","items":[{"item_name":"Consulting package","quantity":1,"selling_price":75000,"category":"Service Income","tax":7.5}]}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"e46c9ce5-a689-437f-b377-3842133d2d04":{"description":"Sale document created","content":{"application/json":{"schema":{"type":"object","required":["status","message"],"properties":{"status":{"type":"string","example":"success","isRequired":true,"uniqueKey":"status","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"data":{"description":"Single resource, array of resources, statement sections, or async job metadata — see each operation's example.","uniqueKey":"data","typeLabel":"any"},"meta":{"type":"object","additionalProperties":true,"description":"Pagination (`page`, `limit`, `total`) and/or report range (`from`, `to`). Cash flow may include `previous_period_end`.","uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"status":"success","message":"Inventory sold successfully","data":{"uuid":"sell-uuid-1","transaction_type":"sales_receipt"}},"examples":{"Example":{"title":"Example","value":{"status":"success","message":"Inventory sold successfully","data":{"uuid":"sell-uuid-1","transaction_type":"sales_receipt"}}}},"exampleType":"examples"}},"exampleType":"examples"},"621e0594-de14-4c56-b795-f240bd49f2c5":{"description":"Validation error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"failed","uniqueKey":"status","typeLabel":"string"},"message":{"type":"string","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"status":"failed","message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e2c747a1-f276-40d6-86a8-e0213a878e16":{"apiKey":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Business secret `tyms_sk_...` for business-scoped routes. Partner secret for register-business and referred-business distributor routes.","x-default":"your_tyms_sk_or_partner_key","scopes":[],"schemeName":"apiKey"}}},"servers":{"6ab02ce9-69a6-48cc-8431-23c6a59ae502":{"url":"https://staging-api.tyms.io/v1/adam","description":"Sandbox (pre-production). Request credentials at developer@tyms.io."},"84cb2c32-46a9-45f0-897d-f0943b19cd7f":{"url":"https://api.tyms.io/v1/adam","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"Business secret `tyms_sk_...` for business-scoped routes. Partner secret for register-business and referred-business distributor routes.","x-default":"your_tyms_sk_or_partner_key","scopes":[],"schemeName":"apiKey"},"schema":{"title":"X-API-Key","type":"string","description":"Business secret `tyms_sk_...` for business-scoped routes. Partner secret for register-business and referred-business distributor routes.","isRequired":true,"default":"your_tyms_sk_or_partner_key","typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-API-Key"}],"title":"apiKey"}]},"originalFileLocation":"openapi/adam-v1.json"},"subdomain":"useadamio","siteName":"Tyms Developer API","title":"Sell stock - Tyms Developer API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T10:51:15.340Z","originalFileLocation":"api-reference/inventory/sell-stock.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Create a stock sale document that reduces inventory quantities. The payload follows the same line-item structure as income/invoice (date, customer, items[] with item_name, quantity, selling_price, category). COGS is computed automatically from cost_price.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tyms Developer API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/useadamio/W1O7Py8Z2fiJjqrH/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/useadamio/W1O7Py8Z2fiJjqrH/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/useadamio/W1O7Py8Z2fiJjqrH/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/useadamio/W1O7Py8Z2fiJjqrH/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/useadamio/W1O7Py8Z2fiJjqrH/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/useadamio/W1O7Py8Z2fiJjqrH/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/useadamio/W1O7Py8Z2fiJjqrH/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/useadamio/W1O7Py8Z2fiJjqrH/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/useadamio/W1O7Py8Z2fiJjqrH/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Sell stock - Tyms Developer API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Create a stock sale document that reduces inventory quantities. The payload follows the same line-item structure as income/invoice (date, customer, items[] with item_name, quantity, selling_price, category). COGS is computed automatically from cost_price.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tyms Developer API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.tyms.io/api-reference/inventory/sell-stock\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://useadamio.mintlify.app/_mintlify/api/og/v2?division=Inventory\u0026amp;title=Sell+stock\u0026amp;description=Create+a+stock+sale+document+that+reduces+inventory+quantities.+The+payload+follows+the+same+line-item+structure+as+income%2Finvoice+%28%60date%60%2C+%60customer%60%2C+%60items%5B%5D\u0026amp;theme=c616638792130eab687c34fc\u0026amp;signature=b14eb6f41a693b3d6d163f3d1700273385e6f0ad090b40df6aeac5719ace994a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Sell stock - Tyms Developer API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Create a stock sale document that reduces inventory quantities. The payload follows the same line-item structure as income/invoice (date, customer, items[] with item_name, quantity, selling_price, category). COGS is computed automatically from cost_price.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://useadamio.mintlify.app/_mintlify/api/og/v2?division=Inventory\u0026amp;title=Sell+stock\u0026amp;description=Create+a+stock+sale+document+that+reduces+inventory+quantities.+The+payload+follows+the+same+line-item+structure+as+income%2Finvoice+%28%60date%60%2C+%60customer%60%2C+%60items%5B%5D\u0026amp;theme=c616638792130eab687c34fc\u0026amp;signature=b14eb6f41a693b3d6d163f3d1700273385e6f0ad090b40df6aeac5719ace994a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/useadamio/W1O7Py8Z2fiJjqrH/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tyms Developer API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6D28D9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.tyms.io/api-reference/inventory/sell-stock\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/inventory/sell-stock.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.tyms.io/#organization\",\"name\":\"Tyms Developer API\",\"url\":\"https://developer.tyms.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/useadamio/bSPxu4ZTH4vIIJob/logo/light.svg?fit=max\u0026auto=format\u0026n=bSPxu4ZTH4vIIJob\u0026q=85\u0026s=6d0cb3c0725d43766203684a0cf5c61c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.tyms.io#website\",\"name\":\"Tyms Developer API\",\"url\":\"https://developer.tyms.io\",\"publisher\":{\"@id\":\"https://developer.tyms.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.tyms.io/api-reference/inventory/sell-stock#webpage\",\"url\":\"https://developer.tyms.io/api-reference/inventory/sell-stock\",\"name\":\"Sell stock\",\"description\":\"Create a stock sale document that reduces inventory quantities. The payload follows the same line-item structure as income/invoice (date, customer, items[] with item_name, quantity, selling_price, category). COGS is computed automatically from cost_price.\",\"dateModified\":\"2026-10-27T10:51:15.340Z\",\"isPartOf\":{\"@id\":\"https://developer.tyms.io#website\"},\"breadcrumb\":{\"@id\":\"https://developer.tyms.io/api-reference/inventory/sell-stock#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.tyms.io/api-reference/inventory/sell-stock#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Inventory\",\"item\":\"https://developer.tyms.io/api-reference/inventory/list-inventory-items\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Sell stock\",\"item\":\"https://developer.tyms.io/api-reference/inventory/sell-stock\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.tyms.io/api-reference/inventory/sell-stock#apireference\",\"headline\":\"Sell stock\",\"name\":\"Sell stock\",\"description\":\"Create a stock sale document that reduces inventory quantities. The payload follows the same line-item structure as income/invoice (date, customer, items[] with item_name, quantity, selling_price, category). COGS is computed automatically from cost_price.\",\"url\":\"https://developer.tyms.io/api-reference/inventory/sell-stock\",\"mainEntityOfPage\":{\"@id\":\"https://developer.tyms.io/api-reference/inventory/sell-stock#webpage\"},\"dateModified\":\"2026-10-27T10:51:15.340Z\",\"publisher\":{\"@id\":\"https://developer.tyms.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.tyms.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tyms Developer API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Tyms Developer API","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"API overview","playground":"none","href":"/api-reference/overview"},{"title":"Attachments","playground":"none","href":"/api-reference/attachments"}]},{"group":"Authentication","pages":[{"title":"Validate business","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /auth/validate","href":"/api-reference/authentication/validate-business"}]},{"group":"OAuth","pages":[{"title":"Get authorization URL","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /oauth/authorization","href":"/api-reference/oauth/get-authorization-url"},{"title":"Exchange authorization code","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /oauth/access/token","href":"/api-reference/oauth/exchange-authorization-code"},{"title":"Refresh access token","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /oauth/refresh/token","href":"/api-reference/oauth/refresh-access-token"},{"title":"Revoke access","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /oauth/revoke/token","href":"/api-reference/oauth/revoke-access"},{"title":"Validate OAuth session","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /oauth/token/validate","href":"/api-reference/oauth/validate-oauth-session"}]},{"group":"Chart of accounts","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /accounts","href":"/api-reference/chart-of-accounts/list-accounts"},{"title":"Get account types","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /accounts/types","href":"/api-reference/chart-of-accounts/get-account-types"},{"title":"Create account","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/chart_of_account","href":"/api-reference/chart-of-accounts/create-account"},{"title":"Create account (AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /accounts","href":"/api-reference/chart-of-accounts/create-account-ai"},{"title":"Get account","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /accounts/{uuid}","href":"/api-reference/chart-of-accounts/get-account"},{"title":"Update account","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /accounts/{uuid}","href":"/api-reference/chart-of-accounts/update-account"},{"title":"Update account (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /accounts/{uuid}","href":"/api-reference/chart-of-accounts/update-account-partial"},{"title":"Delete account","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /accounts/{uuid}","href":"/api-reference/chart-of-accounts/delete-account"}]},{"group":"Invoices","pages":[{"title":"List invoices","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /invoices","href":"/api-reference/invoices/list-invoices"},{"title":"Create invoice","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/invoice","href":"/api-reference/invoices/create-invoice"},{"title":"Create invoice (AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /invoices","href":"/api-reference/invoices/create-invoice-ai"},{"title":"Get invoice","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /invoices/{uuid}","href":"/api-reference/invoices/get-invoice"},{"title":"Update invoice","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /invoices/{uuid}","href":"/api-reference/invoices/update-invoice"},{"title":"Update invoice (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /invoices/{uuid}","href":"/api-reference/invoices/update-invoice-partial"},{"title":"Delete invoice","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /invoices/{uuid}","href":"/api-reference/invoices/delete-invoice"},{"title":"Update invoice payments","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /invoices/{uuid}/payments","href":"/api-reference/invoices/update-invoice-payments"}]},{"group":"Bills","pages":[{"title":"List bills","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /bills","href":"/api-reference/bills/list-bills"},{"title":"Create bill","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/bill","href":"/api-reference/bills/create-bill"},{"title":"Create bill (AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /bills","href":"/api-reference/bills/create-bill-ai"},{"title":"Get bill","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /bills/{uuid}","href":"/api-reference/bills/get-bill"},{"title":"Update bill","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /bills/{uuid}","href":"/api-reference/bills/update-bill"},{"title":"Update bill (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /bills/{uuid}","href":"/api-reference/bills/update-bill-partial"},{"title":"Delete bill","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /bills/{uuid}","href":"/api-reference/bills/delete-bill"},{"title":"Update bill payments","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /bills/{uuid}/payments","href":"/api-reference/bills/update-bill-payments"}]},{"group":"Expenses","pages":[{"title":"List expenses","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /expenses","href":"/api-reference/expenses/list-expenses"},{"title":"Create expense","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/expense","href":"/api-reference/expenses/create-expense"},{"title":"Create expense (AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /expenses","href":"/api-reference/expenses/create-expense-ai"},{"title":"Get expense","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /expenses/{uuid}","href":"/api-reference/expenses/get-expense"},{"title":"Update expense","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /expenses/{uuid}","href":"/api-reference/expenses/update-expense"},{"title":"Update expense (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /expenses/{uuid}","href":"/api-reference/expenses/update-expense-partial"},{"title":"Delete expense","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /expenses/{uuid}","href":"/api-reference/expenses/delete-expense"}]},{"group":"Income","pages":[{"title":"List income","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /income","href":"/api-reference/income/list-income"},{"title":"Create income","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/income","href":"/api-reference/income/create-income"},{"title":"Create income (AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /income","href":"/api-reference/income/create-income-ai"},{"title":"Get income","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /income/{uuid}","href":"/api-reference/income/get-income"},{"title":"Update income","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /income/{uuid}","href":"/api-reference/income/update-income"},{"title":"Update income (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /income/{uuid}","href":"/api-reference/income/update-income-partial"},{"title":"Delete income","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /income/{uuid}","href":"/api-reference/income/delete-income"}]},{"group":"Journals","pages":[{"title":"List journals","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /journals","href":"/api-reference/journals/list-journals"},{"title":"Create journal","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/journal","href":"/api-reference/journals/create-journal"},{"title":"Create journal (AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /journals","href":"/api-reference/journals/create-journal-ai"},{"title":"Get journal","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /journals/{uuid}","href":"/api-reference/journals/get-journal"},{"title":"Update journal","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /journals/{uuid}","href":"/api-reference/journals/update-journal"},{"title":"Update journal (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /journals/{uuid}","href":"/api-reference/journals/update-journal-partial"},{"title":"Delete journal","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /journals/{uuid}","href":"/api-reference/journals/delete-journal"}]},{"group":"Contacts","pages":[{"title":"List contacts","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /contacts","href":"/api-reference/contacts/list-contacts"},{"title":"Create contact","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/contact","href":"/api-reference/contacts/create-contact"},{"title":"Create contact (AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /contacts","href":"/api-reference/contacts/create-contact-ai"},{"title":"Get contact","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /contacts/{uuid}","href":"/api-reference/contacts/get-contact"},{"title":"Update contact","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /contacts/{uuid}","href":"/api-reference/contacts/update-contact"},{"title":"Update contact (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /contacts/{uuid}","href":"/api-reference/contacts/update-contact-partial"},{"title":"Delete contact","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /contacts/{uuid}","href":"/api-reference/contacts/delete-contact"}]},{"group":"Banks","pages":[{"title":"List banks","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /banks","href":"/api-reference/banks/list-banks"},{"title":"Create bank account","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /banks","href":"/api-reference/banks/create-bank-account"},{"title":"Get bank","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /banks/{uuid}","href":"/api-reference/banks/get-bank"},{"title":"Delete bank account","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /banks/{uuid}","href":"/api-reference/banks/delete-bank-account"}]},{"group":"Bank transactions","pages":[{"title":"List bank transactions","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /bank-transactions","href":"/api-reference/bank-transactions/list-bank-transactions"},{"title":"Create bank transaction","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /bank-transactions","href":"/api-reference/bank-transactions/create-bank-transaction"},{"title":"Create bank transactions (AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /bank-transactions/upload","href":"/api-reference/bank-transactions/create-bank-transactions-ai"},{"title":"Get bank transaction","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /bank-transactions/{uuid}","href":"/api-reference/bank-transactions/get-bank-transaction"},{"title":"Update bank transaction","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /bank-transactions/{uuid}","href":"/api-reference/bank-transactions/update-bank-transaction"},{"title":"Update bank transaction (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /bank-transactions/{uuid}","href":"/api-reference/bank-transactions/update-bank-transaction-partial"},{"title":"Delete bank transaction","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /bank-transactions/{uuid}","href":"/api-reference/bank-transactions/delete-bank-transaction"}]},{"group":"Inventory","pages":[{"title":"List inventory items","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /inventories","href":"/api-reference/inventory/list-inventory-items"},{"title":"Create inventory item (alias)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/inventory","href":"/api-reference/inventory/create-inventory-item-alias"},{"title":"Create inventory item (manual or AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /inventories","href":"/api-reference/inventory/create-inventory-item-manual-or-ai"},{"title":"Get inventory item","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /inventories/{uuid}","href":"/api-reference/inventory/get-inventory-item"},{"title":"Update inventory item","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /inventories/{uuid}","href":"/api-reference/inventory/update-inventory-item"},{"title":"Update inventory item (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /inventories/{uuid}","href":"/api-reference/inventory/update-inventory-item-partial"},{"title":"Delete inventory item","description":null,"deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /inventories/{uuid}","href":"/api-reference/inventory/delete-inventory-item"},{"title":"Sell stock","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /inventories/sell","href":"/api-reference/inventory/sell-stock"},{"title":"Restock inventory","description":"Create a restock document that increases stock quantities. The payload follows the same line-item structure as a bill (`date`, `customer` (vendor), `items[]` with `item_name`, `quantity`, `selling_price` (unit cost), `category`). Stock is updated after save.","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /inventories/restock","href":"/api-reference/inventory/restock-inventory"}]},{"group":"Fixed Assets","pages":[{"title":"List fixed assets","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /assets","href":"/api-reference/fixed-assets/list-fixed-assets"},{"title":"Create fixed asset (alias)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/asset","href":"/api-reference/fixed-assets/create-fixed-asset-alias"},{"title":"Create fixed asset","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /assets","href":"/api-reference/fixed-assets/create-fixed-asset"},{"title":"Get fixed asset","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /assets/{uuid}","href":"/api-reference/fixed-assets/get-fixed-asset"},{"title":"Update fixed asset","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /assets/{uuid}","href":"/api-reference/fixed-assets/update-fixed-asset"},{"title":"Update fixed asset (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /assets/{uuid}","href":"/api-reference/fixed-assets/update-fixed-asset-partial"},{"title":"Delete fixed asset","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /assets/{uuid}","href":"/api-reference/fixed-assets/delete-fixed-asset"}]},{"group":"Quotes","pages":[{"title":"List quotes","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /quotes","href":"/api-reference/quotes/list-quotes"},{"title":"Create quote (alias)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/quote","href":"/api-reference/quotes/create-quote-alias"},{"title":"Create quote (manual or AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /quotes","href":"/api-reference/quotes/create-quote-manual-or-ai"},{"title":"Get quote","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /quotes/{uuid}","href":"/api-reference/quotes/get-quote"},{"title":"Update quote","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /quotes/{uuid}","href":"/api-reference/quotes/update-quote"},{"title":"Update quote (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /quotes/{uuid}","href":"/api-reference/quotes/update-quote-partial"},{"title":"Delete quote","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /quotes/{uuid}","href":"/api-reference/quotes/delete-quote"},{"title":"Convert quote to invoice","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /quotes/{uuid}/convert-to-invoice","href":"/api-reference/quotes/convert-quote-to-invoice"},{"title":"Convert quote to income","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /quotes/{uuid}/convert-to-income","href":"/api-reference/quotes/convert-quote-to-income"},{"title":"Convert quote to prepaid income","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /quotes/{uuid}/convert-to-prepaid-income","href":"/api-reference/quotes/convert-quote-to-prepaid-income"}]},{"group":"Purchase Orders","pages":[{"title":"List purchase orders","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /purchase-orders","href":"/api-reference/purchase-orders/list-purchase-orders"},{"title":"Create purchase order (alias)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /create/purchase_order","href":"/api-reference/purchase-orders/create-purchase-order-alias"},{"title":"Create purchase order (manual or AI)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /purchase-orders","href":"/api-reference/purchase-orders/create-purchase-order-manual-or-ai"},{"title":"Get purchase order","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /purchase-orders/{uuid}","href":"/api-reference/purchase-orders/get-purchase-order"},{"title":"Update purchase order","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /purchase-orders/{uuid}","href":"/api-reference/purchase-orders/update-purchase-order"},{"title":"Update purchase order (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /purchase-orders/{uuid}","href":"/api-reference/purchase-orders/update-purchase-order-partial"},{"title":"Delete purchase order","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /purchase-orders/{uuid}","href":"/api-reference/purchase-orders/delete-purchase-order"},{"title":"Convert purchase order to restock","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /purchase-orders/{uuid}/convert-to-restock","href":"/api-reference/purchase-orders/convert-purchase-order-to-restock"}]},{"group":"Departments","pages":[{"title":"List departments","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /departments","href":"/api-reference/departments/list-departments"},{"title":"Create department","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /departments","href":"/api-reference/departments/create-department"},{"title":"Update department","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /departments/{uuid}","href":"/api-reference/departments/update-department"},{"title":"Update department (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /departments/{uuid}","href":"/api-reference/departments/update-department-partial"},{"title":"Delete department","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /departments/{uuid}","href":"/api-reference/departments/delete-department"}]},{"group":"Projects","pages":[{"title":"List projects","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /projects","href":"/api-reference/projects/list-projects"},{"title":"Create project","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /projects","href":"/api-reference/projects/create-project"},{"title":"Get project","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /projects/{uuid}","href":"/api-reference/projects/get-project"},{"title":"Update project","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /projects/{uuid}","href":"/api-reference/projects/update-project"},{"title":"Update project (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /projects/{uuid}","href":"/api-reference/projects/update-project-partial"},{"title":"Delete project","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /projects/{uuid}","href":"/api-reference/projects/delete-project"}]},{"group":"Branches","pages":[{"title":"List branches","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /branches","href":"/api-reference/branches/list-branches"},{"title":"Create branch","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /branches","href":"/api-reference/branches/create-branch"},{"title":"Update branch","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json put /branches/{uuid}","href":"/api-reference/branches/update-branch"},{"title":"Update branch (partial)","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json patch /branches/{uuid}","href":"/api-reference/branches/update-branch-partial"},{"title":"Delete branch","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json delete /branches/{uuid}","href":"/api-reference/branches/delete-branch"}]},{"group":"Reports","pages":[{"title":"Income statement","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /reports/income-statement","href":"/api-reference/reports/income-statement"},{"title":"Balance sheet","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /reports/balance-sheet","href":"/api-reference/reports/balance-sheet"},{"title":"Trial balance","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /reports/trial-balance","href":"/api-reference/reports/trial-balance"},{"title":"Cash flow statement","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /reports/cash-flow-statement","href":"/api-reference/reports/cash-flow-statement"},{"title":"General ledger","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /reports/general-ledger","href":"/api-reference/reports/general-ledger"},{"title":"Account ledger","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /reports/account-ledger/{uuid}","href":"/api-reference/reports/account-ledger"},{"title":"Contact statement","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /reports/contact-statement/{uuid}","href":"/api-reference/reports/contact-statement"}]},{"group":"Distribution Partners","pages":[{"title":"Register business","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /register-business","href":"/api-reference/partners/register-business"},{"title":"List referred businesses","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /referred-businesses","href":"/api-reference/partners/list-referred-businesses"},{"title":"Billing status","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json get /referred-businesses/{business_uuid}/billing-status","href":"/api-reference/partners/billing-status"},{"title":"Add seats","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /referred-businesses/{business_uuid}/add-seats","href":"/api-reference/partners/add-seats"},{"title":"Add credits","deprecated":null,"version":null,"openapi":"/openapi/adam-v1.json post /referred-businesses/{business_uuid}/add-credits","href":"/api-reference/partners/add-credits"}]}]},{"tab":"MCP and AI","pages":[{"title":"MCP and AI","href":"/mcp/overview"}]}]},"title":"Sell stock - Tyms Developer API","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-rfhihCWU.js","utils-BmH1XFxk.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BcNsxPKB.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BAES3tkd.js","snippetPresets-DCMQBKLP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D6l_bzE9.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BOktbnNh.js","shallow-BCs8SgM7.js","getApiPlaygroundDisplay-DEmW5bJB.js","CodeSnippet-CpZOpB9C.js","CodeSnippets-BOBDqibl.js","Page-D5fEM6aW.js","getPastedJson-DH2JBvmr.js","icon-BBJH-kKh.js","MethodPill-D2Sd5NLC.js","DuplicateIcon-CGgfL2qN.js","createIcon-BKudBBzi.js","DynamicMarkdown-85clUA0i.js","SectionHeading-D0JiMgDx.js","axios-vUo_bRtp.js","Markdown-Cfiy0xZO.js","clsx-rL8ZCCw4.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-aeztFa9U.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BywkCr5C.js"]}