This route is a gateway proxy to a running workforce deployment (an agent or workflow). The platform forwards your HTTP request to the deployment; responses pass back through unchanged (aside from normal proxy behavior).
The reference below is for POST so the API playground and generated fields render. The same path and parameters apply to GET, PUT, PATCH, and DELETE — use the verb you need when calling the API directly.
Supported HTTP methods
Method
Use case
GET
Read-only calls (e.g. health, metadata).
POST
Typical RPC-style calls (e.g. …/run).
PUT / PATCH
Idempotent or partial updates when your component exposes them.
DELETE
Deletes or teardown actions your component exposes.
Path, query, and auth are the same for every method. The deployment must handle the method you send.
Path and query
workforce — Which component to hit: numeric id, manifest UUID, or name (same identifiers you use elsewhere in the project API).
path — Suffix on the deployment server after the component segment (for example run or healthcheck). Use the path your running app defines; can be empty for the deployment root.
rev (query, required) — Git branch the deployment is tied to (for example main).
Limits
WebSocket upgrades are not supported on this proxy route.
If nothing is running for that component on rev, you get 404. If the deployment returns an error upstream, you may see 502.
Authorizations
Authorization
string
header
required
Timbal API key. Obtain your API key from the Timbal platform settings. See Authentication for more information.
Path Parameters
org_id
string
required
Organization id
project_id
string
required
Project id
workforce
string
required
Workforce component: numeric id, manifest UUID, or name
path
string
required
Sub-path on the deployment server.
Query Parameters
rev
string
required
Git branch name (for example main).
Response
Response from the workforce deployment
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Timbal","colors":{"primary":"#000000","light":"#ffffff","dark":"#000000"},"logo":{"light":"https://mintcdn.com/timbaltechsl/pt3LfpScmY2Go19A/logo/light-small-1.svg?fit=max\u0026auto=format\u0026n=pt3LfpScmY2Go19A\u0026q=85\u0026s=fd26b0ce39e9e46d6dd08d81b611a9ea","dark":"https://mintcdn.com/timbaltechsl/pt3LfpScmY2Go19A/logo/dark-small-1.svg?fit=max\u0026auto=format\u0026n=pt3LfpScmY2Go19A\u0026q=85\u0026s=5739e93ab19cd4f38a7794d947cb547f"},"favicon":"https://mintcdn.com/timbaltechsl/SFKYoQkLzl5EA6mF/favicon.png?fit=max\u0026auto=format\u0026n=SFKYoQkLzl5EA6mF\u0026q=85\u0026s=426b0689f2269536b56cad9d7b4a8b2f","api":{"openapi":"api-reference/openapi.json"},"navbar":{"primary":{"type":"github","href":"https://github.com/timbal-ai/timbal"}},"footer":{"socials":{"website":"https://timbal.ai","github":"https://github.com/timbal-ai","linkedin":"https://linkedin.com/company/timbal-ai"}},"styling":{"codeblocks":"dark","latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"timbaltechsl","hasAudioNarration":false,"actualSubdomain":"timbaltechsl","customDomains":["docs.timbal.ai"],"gitSource":{"type":"github","owner":"timbal-ai","repo":"timbal","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6af832ce2e6041f078d76983","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API Reference","count":210},{"language":"default","tag":"Docs","count":56},{"language":"default","tag":"Organizations","count":54},{"language":"default","tag":"Projects","count":45},{"language":"default","tag":"Knowledge Bases","count":36},{"language":"default","tag":"Agents","count":31},{"language":"default","tag":"Examples","count":29},{"language":"default","tag":"Model Reference","count":28},{"language":"default","tag":"Connectors","count":26},{"language":"default","tag":"Evals","count":22}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/projects/workforce/call","slug":"/api-reference/projects/workforce/call","pageMetadata":{"title":"Call Workforce","openapi":"POST /orgs/{org_id}/projects/{project_id}/workforce/{workforce}/{*path}","description":"Proxy HTTP requests to a deployed workforce component.","href":"/api-reference/projects/workforce/call"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Proxy HTTP requests to a deployed workforce component.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Note,Table}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This route is a `,_jsx(_components.strong,{children:`gateway proxy`}),` to a `,_jsx(_components.strong,{children:`running`}),` workforce deployment (an agent or workflow). The platform forwards your HTTP request to the deployment; responses pass back through unchanged (aside from normal proxy behavior).`]}),`\n`,_jsx(Note,{children:_jsxs(_components.p,{children:[`The reference below is for `,_jsx(_components.strong,{children:`POST`}),` so the API playground and generated fields render. The same path and parameters apply to `,_jsx(_components.strong,{children:`GET`}),`, `,_jsx(_components.strong,{children:`PUT`}),`, `,_jsx(_components.strong,{children:`PATCH`}),`, and `,_jsx(_components.strong,{children:`DELETE`}),` — use the verb you need when calling the API directly.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`supported-http-methods`,children:`Supported HTTP methods`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Method`}),_jsx(_components.th,{children:`Use case`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`GET`})}),_jsx(_components.td,{children:`Read-only calls (e.g. health, metadata).`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`POST`})}),_jsxs(_components.td,{children:[`Typical RPC-style calls (e.g. `,_jsx(_components.code,{children:`…/run`}),`).`]})]}),_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`PUT`}),` / `,_jsx(_components.strong,{children:`PATCH`})]}),_jsx(_components.td,{children:`Idempotent or partial updates when your component exposes them.`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`DELETE`})}),_jsx(_components.td,{children:`Deletes or teardown actions your component exposes.`})]})]})]}),`\n`,_jsx(_components.p,{children:`Path, query, and auth are the same for every method. The deployment must handle the method you send.`}),`\n`,_jsx(Heading,{level:`2`,id:`path-and-query`,children:`Path and query`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`workforce`})}),` — Which component to hit: numeric id, manifest UUID, or name (same identifiers you use elsewhere in the project API).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`path`})}),` — Suffix on the deployment server after the component segment (for example `,_jsx(_components.code,{children:`run`}),` or `,_jsx(_components.code,{children:`healthcheck`}),`). Use the path your running app defines; can be empty for the deployment root.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:_jsx(_components.code,{children:`rev`})}),` (query, required) — Git branch the deployment is tied to (for example `,_jsx(_components.code,{children:`main`}),`).`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`limits`,children:`Limits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`WebSocket upgrades are not supported`}),` on this proxy route.`]}),`\n`,_jsxs(_components.li,{children:[`If nothing is running for that component on `,_jsx(_components.code,{children:`rev`}),`, you get `,_jsx(_components.strong,{children:`404`}),`. If the deployment returns an error upstream, you may see `,_jsx(_components.strong,{children:`502`}),`.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":"dark","config":{},"pageMetadata":{"title":"Call Workforce","openapi":"POST /orgs/{org_id}/projects/{project_id}/workforce/{workforce}/{*path}","description":"Proxy HTTP requests to a deployed workforce component.","href":"/api-reference/projects/workforce/call"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Supported HTTP methods","slug":"supported-http-methods","depth":2,"children":[]},{"title":"Path and query","slug":"path-and-query","depth":2,"children":[]},{"title":"Limits","slug":"limits","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["projects"],"description":"Proxy HTTP requests to a deployed workforce component.","operationId":"workforce_proxy_post","parameters":["4260fa53-a4c6-4521-b451-76e6f837104e","9fbea0a2-e138-4816-8d75-2db5addc9828","ec509202-1d1b-45b4-a523-a54bcebd3ba7","e3f1cbdb-7152-485d-83d6-219f5086e3a2","6542031f-74df-49be-a33f-0c82a0574c49"],"responses":{"200":"67b312cd-8982-46e8-af00-00d143071257","404":"857cea7e-fb35-428e-a0d9-8f872d3dd16a","502":"dfee734e-33b7-4364-aeb0-0d86232f0321","504":"46aa2ea5-251f-45bb-840b-bb00c6f8600d"},"security":["ff892221-1616-4da3-8770-b64304fae44e"],"method":"post","type":"path","servers":["063e6282-8e14-477c-a715-c7b30ccd340b","a9adc882-01d3-4459-9489-6baa7c24677b"],"path":"/orgs/{org_id}/projects/{project_id}/workforce/{workforce}/{*path}","baseUrlOptions":["https://api.timbal.ai","https://api.dev.timbal.ai"],"title":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"4260fa53-a4c6-4521-b451-76e6f837104e":{"name":"org_id","in":"path","description":"Organization id","required":true,"schema":{"type":"string","isRequired":true,"description":"Organization id","uniqueKey":"","typeLabel":"string"}},"9fbea0a2-e138-4816-8d75-2db5addc9828":{"name":"project_id","in":"path","description":"Project id","required":true,"schema":{"type":"string","isRequired":true,"description":"Project id","uniqueKey":"","typeLabel":"string"}},"ec509202-1d1b-45b4-a523-a54bcebd3ba7":{"name":"workforce","in":"path","description":"Workforce component: numeric id, manifest UUID, or name","required":true,"schema":{"type":"string","isRequired":true,"description":"Workforce component: numeric id, manifest UUID, or name","uniqueKey":"","typeLabel":"string"}},"e3f1cbdb-7152-485d-83d6-219f5086e3a2":{"name":"path","in":"path","description":"Sub-path on the deployment server.","required":true,"schema":{"type":"string","isRequired":true,"description":"Sub-path on the deployment server.","uniqueKey":"","typeLabel":"string"}},"6542031f-74df-49be-a33f-0c82a0574c49":{"name":"rev","in":"query","description":"Git branch name (for example `main`).","required":true,"schema":{"type":"string","isRequired":true,"description":"Git branch name (for example `main`).","uniqueKey":"","typeLabel":"string"}}},"responses":{"67b312cd-8982-46e8-af00-00d143071257":{"description":"Response from the workforce deployment","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"857cea7e-fb35-428e-a0d9-8f872d3dd16a":{"description":"No running deployment found for this component on this branch","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"dfee734e-33b7-4364-aeb0-0d86232f0321":{"description":"Bad gateway","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"46aa2ea5-251f-45bb-840b-bb00c6f8600d":{"description":"Gateway timeout","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"ff892221-1616-4da3-8770-b64304fae44e":{"bearer_auth":{"type":"http","scheme":"bearer","description":"Timbal API key. Obtain your API key from the Timbal platform settings. See [Authentication](/api-reference/authentication) for more information.","scopes":[]}}},"servers":{"063e6282-8e14-477c-a715-c7b30ccd340b":{"url":"https://api.timbal.ai","description":"Production"},"a9adc882-01d3-4459-9489-6baa7c24677b":{"url":"https://api.dev.timbal.ai","description":"Development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Timbal API key. Obtain your API key from the Timbal platform settings. See [Authentication](/api-reference/authentication) for more information.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Timbal API key. Obtain your API key from the Timbal platform settings. See [Authentication](/api-reference/authentication) for more information.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer_auth","name":"Authorization"}],"title":"bearer_auth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"timbaltechsl","siteName":"Timbal","title":"Call Workforce - Timbal","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-07-03T15:50:29.732Z","originalFileLocation":"api-reference/projects/workforce/call.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=\"Proxy HTTP requests to a deployed workforce component.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Timbal\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/timbaltechsl/HA5uMpfE6Se4k3W2/_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/timbaltechsl/HA5uMpfE6Se4k3W2/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/timbaltechsl/HA5uMpfE6Se4k3W2/_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/timbaltechsl/HA5uMpfE6Se4k3W2/_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/timbaltechsl/HA5uMpfE6Se4k3W2/_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/timbaltechsl/HA5uMpfE6Se4k3W2/_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/timbaltechsl/HA5uMpfE6Se4k3W2/_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/timbaltechsl/HA5uMpfE6Se4k3W2/_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/timbaltechsl/HA5uMpfE6Se4k3W2/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Call Workforce - Timbal\">\u003cmeta data-mint-head property=\"og:description\" content=\"Proxy HTTP requests to a deployed workforce component.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Timbal\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.timbal.ai/api-reference/projects/workforce/call\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://timbaltechsl.mintlify.site/_mintlify/api/og/v2?division=Workforce\u0026amp;title=Call+Workforce\u0026amp;description=Proxy+HTTP+requests+to+a+deployed+workforce+component.\u0026amp;theme=1096fd6d2ded85c8c6d37492\u0026amp;signature=07cba1102ec6f7a908e7342bbdf9802a62baebf18c9f07624a501b3e38191dec\">\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=\"Call Workforce - Timbal\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Proxy HTTP requests to a deployed workforce component.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://timbaltechsl.mintlify.site/_mintlify/api/og/v2?division=Workforce\u0026amp;title=Call+Workforce\u0026amp;description=Proxy+HTTP+requests+to+a+deployed+workforce+component.\u0026amp;theme=1096fd6d2ded85c8c6d37492\u0026amp;signature=07cba1102ec6f7a908e7342bbdf9802a62baebf18c9f07624a501b3e38191dec\">\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/timbaltechsl/HA5uMpfE6Se4k3W2/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Timbal\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.timbal.ai/api-reference/projects/workforce/call\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/projects/workforce/call.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.timbal.ai/#organization\",\"name\":\"Timbal\",\"url\":\"https://docs.timbal.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/timbaltechsl/pt3LfpScmY2Go19A/logo/light-small-1.svg?fit=max\u0026auto=format\u0026n=pt3LfpScmY2Go19A\u0026q=85\u0026s=fd26b0ce39e9e46d6dd08d81b611a9ea\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.timbal.ai#website\",\"name\":\"Timbal\",\"url\":\"https://docs.timbal.ai\",\"publisher\":{\"@id\":\"https://docs.timbal.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.timbal.ai/api-reference/projects/workforce/call#webpage\",\"url\":\"https://docs.timbal.ai/api-reference/projects/workforce/call\",\"name\":\"Call Workforce\",\"description\":\"Proxy HTTP requests to a deployed workforce component.\",\"dateModified\":\"2026-07-03T15:50:29.732Z\",\"isPartOf\":{\"@id\":\"https://docs.timbal.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.timbal.ai/api-reference/projects/workforce/call#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.timbal.ai/api-reference/projects/workforce/call#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Projects\",\"item\":\"https://docs.timbal.ai/api-reference/projects/list\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Workforce\",\"item\":\"https://docs.timbal.ai/api-reference/projects/workforce/list\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Call Workforce\",\"item\":\"https://docs.timbal.ai/api-reference/projects/workforce/call\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.timbal.ai/api-reference/projects/workforce/call#apireference\",\"headline\":\"Call Workforce\",\"name\":\"Call Workforce\",\"description\":\"Proxy HTTP requests to a deployed workforce component.\",\"url\":\"https://docs.timbal.ai/api-reference/projects/workforce/call\",\"mainEntityOfPage\":{\"@id\":\"https://docs.timbal.ai/api-reference/projects/workforce/call#webpage\"},\"dateModified\":\"2026-07-03T15:50:29.732Z\",\"publisher\":{\"@id\":\"https://docs.timbal.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.timbal.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Timbal\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Timbal\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/projects/workforce/call.md","siteName":"Timbal","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"Examples","pages":[{"title":"Examples","href":"/examples"}]},{"tab":"Model Reference","pages":[{"title":"Model Reference","href":"/models/overview"}]},{"tab":"API Reference","groups":[{"group":"API Documentation","pages":[{"title":"Introduction","href":"/api-reference/introduction"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Upload file (temporary)","openapi":"POST /files","href":"/api-reference/files/upload"}]},{"group":"Me","pages":[{"title":"List Organizations","openapi":"GET /me/orgs","href":"/api-reference/me/list-orgs"},{"title":"Update Profile","openapi":"PATCH /me","href":"/api-reference/me/update"},{"group":"Profile Photo","pages":[{"title":"Upload Profile Photo","openapi":"PUT /me/photo","href":"/api-reference/me/photo/upload"},{"title":"Delete Profile Photo","openapi":"DELETE /me/photo","href":"/api-reference/me/photo/delete"}]},{"group":"API Tokens","pages":[{"title":"List API Tokens","openapi":"GET /me/tokens","href":"/api-reference/me/tokens/list"},{"title":"Create API Token","openapi":"POST /me/tokens","href":"/api-reference/me/tokens/create"},{"title":"Revoke API Token","openapi":"DELETE /me/tokens/{token_id}","href":"/api-reference/me/tokens/revoke"}]}]},{"group":"Organizations","pages":[{"title":"Create Organization","openapi":"POST /orgs","href":"/api-reference/orgs/create"},{"title":"Get Organization","openapi":"GET /orgs/{org_id}","href":"/api-reference/orgs/get"},{"title":"Update Organization","openapi":"PATCH /orgs/{org_id}","href":"/api-reference/orgs/update"},{"title":"List Account Contacts","openapi":"GET /orgs/{org_id}/contacts","href":"/api-reference/orgs/contacts/list"},{"title":"List Embedding Models","openapi":"GET /orgs/{org_id}/embedding-models","href":"/api-reference/orgs/embedding-models/list"},{"group":"Analytics","pages":[{"title":"Org Analytics — Costs","openapi":"GET /orgs/{org_id}/analytics/costs","href":"/api-reference/orgs/analytics/costs"},{"title":"Org Analytics — Usage","openapi":"GET /orgs/{org_id}/analytics/usage","href":"/api-reference/orgs/analytics/usage"},{"title":"Org Analytics — Users","openapi":"GET /orgs/{org_id}/analytics/users","href":"/api-reference/orgs/analytics/users"}]},{"group":"Billing","pages":[{"title":"Get Overage Summary","openapi":"GET /orgs/{org_id}/billing/overage","href":"/api-reference/orgs/billing/overage-summary"},{"title":"Update Overage Billing","openapi":"POST /orgs/{org_id}/billing/overage","href":"/api-reference/orgs/billing/overage"},{"title":"Get Credit Budgets","openapi":"GET /orgs/{org_id}/billing/budgets","href":"/api-reference/orgs/billing/budgets/get"},{"title":"Replace Credit Budgets","openapi":"PUT /orgs/{org_id}/billing/budgets","href":"/api-reference/orgs/billing/budgets/replace"},{"title":"Patch Credit Budgets","openapi":"PATCH /orgs/{org_id}/billing/budgets","href":"/api-reference/orgs/billing/budgets/patch"},{"title":"Get Compute Billing","openapi":"GET /orgs/{org_id}/billing/compute","href":"/api-reference/orgs/billing/compute/get"},{"title":"Set Compute Billing","openapi":"PUT /orgs/{org_id}/billing/compute","href":"/api-reference/orgs/billing/compute/put"}]},{"group":"Content","pages":[{"title":"Sign Content URL","openapi":"POST /orgs/{org_id}/content/sign","href":"/api-reference/orgs/content/sign"}]},{"group":"Organization Logo","pages":[{"title":"Upload Organization Logo","openapi":"PUT /orgs/{org_id}/photo","href":"/api-reference/orgs/photo/upload"},{"title":"Delete Organization Logo","openapi":"DELETE /orgs/{org_id}/photo","href":"/api-reference/orgs/photo/delete"}]},{"group":"Credit Grants","pages":[{"title":"List Credit Grants","openapi":"GET /orgs/{org_id}/credit-grants","href":"/api-reference/orgs/credit-grants/list"}]},{"group":"Model Policies","pages":[{"title":"List Model Policies","openapi":"GET /orgs/{org_id}/models/policies","href":"/api-reference/orgs/models/policies/list"},{"title":"Create Model Policy","openapi":"POST /orgs/{org_id}/models/policies","href":"/api-reference/orgs/models/policies/create"},{"title":"Delete Model Policy","openapi":"DELETE /orgs/{org_id}/models/policies/{policy_id}","href":"/api-reference/orgs/models/policies/delete"}]},{"group":"Templates","pages":[{"title":"List Templates","openapi":"GET /orgs/{org_id}/templates","href":"/api-reference/orgs/templates/list"}]},{"group":"Domains","pages":[{"title":"List Domains","openapi":"GET /orgs/{org_id}/domains","href":"/api-reference/orgs/domains/list"},{"title":"Create Domain","openapi":"POST /orgs/{org_id}/domains","href":"/api-reference/orgs/domains/create"},{"title":"Get Domain","openapi":"GET /orgs/{org_id}/domains/{domain_id}","href":"/api-reference/orgs/domains/get"},{"title":"Delete Domain","openapi":"DELETE /orgs/{org_id}/domains/{domain_id}","href":"/api-reference/orgs/domains/delete"}]},{"group":"IAM","pages":[{"title":"List IAM Actions","openapi":"GET /orgs/{org_id}/iam/actions","href":"/api-reference/orgs/iam/actions/list"},{"title":"List Users by Action","openapi":"GET /orgs/{org_id}/iam/actions/{action}/users","href":"/api-reference/orgs/iam/actions/users"},{"title":"List Users by Resource","openapi":"GET /orgs/{org_id}/iam/resources/{resource}/users","href":"/api-reference/orgs/iam/resources/users"},{"title":"Check IAM Permissions","openapi":"POST /orgs/{org_id}/iam/check","href":"/api-reference/orgs/iam/check"},{"group":"Roles","pages":[{"title":"List Organization Roles","openapi":"GET /orgs/{org_id}/iam/roles","href":"/api-reference/orgs/roles/list"},{"title":"Create Organization Role","openapi":"POST /orgs/{org_id}/iam/roles","href":"/api-reference/orgs/roles/create"},{"title":"Get Organization Role","openapi":"GET /orgs/{org_id}/iam/roles/{role_id}","href":"/api-reference/orgs/roles/get"},{"title":"Update Organization Role","openapi":"PATCH /orgs/{org_id}/iam/roles/{role_id}","href":"/api-reference/orgs/roles/update"},{"title":"Delete Organization Role","openapi":"DELETE /orgs/{org_id}/iam/roles/{role_id}","href":"/api-reference/orgs/roles/delete"}]},{"group":"Users","pages":[{"title":"List Users","openapi":"GET /orgs/{org_id}/iam/users","href":"/api-reference/orgs/users/list"},{"title":"Add User","openapi":"POST /orgs/{org_id}/iam/users","href":"/api-reference/orgs/users/add"},{"title":"Remove User","openapi":"DELETE /orgs/{org_id}/iam/users","href":"/api-reference/orgs/users/delete"},{"title":"Update User Roles","openapi":"PUT /orgs/{org_id}/iam/users/{user_id}/roles","href":"/api-reference/orgs/users/update"},{"title":"Batch Update User Roles","openapi":"PUT /orgs/{org_id}/iam/users/roles","href":"/api-reference/orgs/iam/users/batch-roles"},{"title":"Get User Effective Grants","openapi":"GET /orgs/{org_id}/iam/users/{user_id}/effective-grants","href":"/api-reference/orgs/iam/users/effective-grants"}]}]},{"group":"Identity Providers","pages":[{"title":"List Identity Providers","openapi":"GET /orgs/{org_id}/identity-providers","href":"/api-reference/orgs/identity-providers/list"},{"title":"Create Identity Provider","openapi":"POST /orgs/{org_id}/identity-providers","href":"/api-reference/orgs/identity-providers/create"},{"title":"Get a single SSO connection (secret masked)","openapi":"GET /orgs/{org_id}/identity-providers/{provider_id}","href":"/api-reference/orgs/identity-providers/get"},{"title":"Update Identity Provider","openapi":"PATCH /orgs/{org_id}/identity-providers/{provider_id}","href":"/api-reference/orgs/identity-providers/update"},{"title":"Delete an SSO connection (cascades to its group mappings)","openapi":"DELETE /orgs/{org_id}/identity-providers/{provider_id}","href":"/api-reference/orgs/identity-providers/delete"},{"title":"Default Role","openapi":"PUT /orgs/{org_id}/identity-providers/{provider_id}/default-role","href":"/api-reference/orgs/identity-providers/default-role"},{"title":"List external-group to role mappings for a connection","openapi":"GET /orgs/{org_id}/identity-providers/{provider_id}/group-mappings","href":"/api-reference/orgs/identity-providers/group-mappings/list"},{"title":"Map an external IdP group to a role for this connection","openapi":"POST /orgs/{org_id}/identity-providers/{provider_id}/group-mappings","href":"/api-reference/orgs/identity-providers/group-mappings/create"},{"title":"Delete a group-to-role mapping","openapi":"DELETE /orgs/{org_id}/identity-providers/{provider_id}/group-mappings/{mapping_id}","href":"/api-reference/orgs/identity-providers/group-mappings/delete"}]},{"group":"SCIM","pages":[{"title":"List SCIM Tokens","openapi":"GET /orgs/{org_id}/scim-tokens","href":"/api-reference/orgs/scim-tokens/list"},{"title":"Create SCIM Token","openapi":"POST /orgs/{org_id}/scim-tokens","href":"/api-reference/orgs/scim-tokens/create"},{"title":"Revoke SCIM Token","openapi":"DELETE /orgs/{org_id}/scim-tokens/{token_id}","href":"/api-reference/orgs/scim-tokens/revoke"}]}]},{"group":"Projects","pages":[{"title":"List Projects","openapi":"GET /orgs/{org_id}/projects","href":"/api-reference/projects/list"},{"title":"Create Project","openapi":"POST /orgs/{org_id}/projects","href":"/api-reference/projects/create"},{"title":"Get Project","openapi":"GET /orgs/{org_id}/projects/{project_id}","href":"/api-reference/projects/get"},{"title":"Update Project","openapi":"PATCH /orgs/{org_id}/projects/{project_id}","href":"/api-reference/projects/update"},{"title":"Delete Project","openapi":"DELETE /orgs/{org_id}/projects/{project_id}","href":"/api-reference/projects/delete"},{"title":"Duplicate Project","openapi":"POST /orgs/{org_id}/projects/{project_id}/duplicate","href":"/api-reference/projects/duplicate"},{"title":"Link Knowledge Base","openapi":"PUT /orgs/{org_id}/projects/{project_id}/k2","href":"/api-reference/projects/link-knowledge-base"},{"title":"Unlink Knowledge Base","openapi":"DELETE /orgs/{org_id}/projects/{project_id}/k2","href":"/api-reference/projects/unlink-knowledge-base"},{"group":"App Auth","pages":[{"title":"Get App Auth Settings","openapi":"GET /orgs/{org_id}/projects/{project_id}/auth","href":"/api-reference/projects/auth/get"},{"title":"Update App Auth Settings","openapi":"PATCH /orgs/{org_id}/projects/{project_id}/auth","href":"/api-reference/projects/auth/update"},{"title":"Update Auth Provider","openapi":"PUT /orgs/{org_id}/projects/{project_id}/auth/providers/{provider}","href":"/api-reference/projects/auth/providers/update"}]},{"group":"Analytics","pages":[{"title":"Cost Analytics","openapi":"GET /orgs/{org_id}/projects/{project_id}/analytics/credits","href":"/api-reference/projects/analytics/credits"},{"title":"Usage Analytics","sidebarTitle":"General Analytics","openapi":"GET /orgs/{org_id}/projects/{project_id}/analytics/usage","href":"/api-reference/projects/analytics/usage"},{"title":"User Analytics","openapi":"GET /orgs/{org_id}/projects/{project_id}/analytics/users","href":"/api-reference/projects/analytics/users"}]},{"group":"Environments","pages":[{"title":"List Environments","openapi":"GET /orgs/{org_id}/projects/{project_id}/envs","href":"/api-reference/projects/environments/list"},{"title":"Create Environment","openapi":"POST /orgs/{org_id}/projects/{project_id}/envs","href":"/api-reference/projects/environments/create"},{"title":"Delete Environment","openapi":"DELETE /orgs/{org_id}/projects/{project_id}/envs/{env_id}","href":"/api-reference/projects/environments/delete"},{"title":"Update Branch","openapi":"PATCH /orgs/{org_id}/projects/{project_id}/envs/{env_id}/branch","href":"/api-reference/projects/environments/update-branch"},{"title":"Update Config","openapi":"PATCH /orgs/{org_id}/projects/{project_id}/envs/{env_id}/config","href":"/api-reference/projects/environments/update-config"},{"title":"Deploy","openapi":"POST /orgs/{org_id}/projects/{project_id}/envs/{env_id}/deploy","href":"/api-reference/projects/environments/deploy"},{"title":"Update Domain","openapi":"PATCH /orgs/{org_id}/projects/{project_id}/envs/{env_id}/domain","href":"/api-reference/projects/environments/update-domain"},{"title":"Get Metrics","openapi":"GET /orgs/{org_id}/projects/{project_id}/envs/{env_id}/metrics/{metric_type}","href":"/api-reference/projects/environments/get-metrics"},{"title":"Stop","openapi":"POST /orgs/{org_id}/projects/{project_id}/envs/{env_id}/stop","href":"/api-reference/projects/environments/stop"},{"title":"List Environment Deployments","openapi":"GET /orgs/{org_id}/projects/{project_id}/envs/{env_id}/deployments","href":"/api-reference/projects/environments/deployments/list"},{"title":"Get Environment Logs","openapi":"GET /orgs/{org_id}/projects/{project_id}/envs/{env_id}/logs","href":"/api-reference/projects/environments/logs"}]},{"group":"Runs","pages":[{"title":"List Runs","openapi":"GET /orgs/{org_id}/projects/{project_id}/runs","href":"/api-reference/projects/runs/list"},{"title":"Get Run","openapi":"GET /orgs/{org_id}/projects/{project_id}/runs/{run_id}","href":"/api-reference/projects/runs/get"},{"title":"List Reactions","openapi":"GET /orgs/{org_id}/projects/{project_id}/runs/{run_id}/reactions","href":"/api-reference/projects/runs/reactions-list"},{"title":"Add Reaction","openapi":"POST /orgs/{org_id}/projects/{project_id}/runs/{run_id}/reactions","href":"/api-reference/projects/runs/reactions-add"}]},{"group":"Variables","pages":[{"title":"List Variables","openapi":"GET /orgs/{org_id}/projects/{project_id}/vars","href":"/api-reference/projects/vars/list"},{"title":"Create Variable","openapi":"POST /orgs/{org_id}/projects/{project_id}/vars","href":"/api-reference/projects/vars/create"},{"title":"Batch Create Variables","openapi":"POST /orgs/{org_id}/projects/{project_id}/vars/batch","href":"/api-reference/projects/vars/batch-create"},{"title":"Get Variable","openapi":"GET /orgs/{org_id}/projects/{project_id}/vars/{var_id}","href":"/api-reference/projects/vars/get"},{"title":"Delete Variable","openapi":"DELETE /orgs/{org_id}/projects/{project_id}/vars/{var_id}","href":"/api-reference/projects/vars/delete"},{"title":"Update Variable","openapi":"PATCH /orgs/{org_id}/projects/{project_id}/vars/{var_id}","href":"/api-reference/projects/vars/update"}]},{"group":"Channels","pages":[{"title":"Upsert Channel","openapi":"PUT /orgs/{org_id}/projects/{project_id}/channels/{workforce}/{provider}","href":"/api-reference/projects/channels/put"},{"title":"Delete Channel","openapi":"DELETE /orgs/{org_id}/projects/{project_id}/channels/{workforce}/{provider}","href":"/api-reference/projects/channels/delete"}]},{"group":"Workforce","pages":[{"title":"List Workforce","openapi":"GET /orgs/{org_id}/projects/{project_id}/workforce","href":"/api-reference/projects/workforce/list"},{"title":"Create Workforce","openapi":"POST /orgs/{org_id}/projects/{project_id}/workforce","href":"/api-reference/projects/workforce/create"},{"title":"Delete Workforce","openapi":"DELETE /orgs/{org_id}/projects/{project_id}/workforce","description":"Delete a workforce component on a branch revision.","href":"/api-reference/projects/workforce/delete"},{"title":"Call Workforce","openapi":"POST /orgs/{org_id}/projects/{project_id}/workforce/{workforce}/{*path}","href":"/api-reference/projects/workforce/call"},{"title":"Call Workforce (GET)","openapi":"GET /orgs/{org_id}/projects/{project_id}/workforce/{workforce}/{*path}","description":"Proxy HTTP requests to a deployed workforce component.","href":"/api-reference/projects/workforce/call-get"},{"title":"Call Workforce (PUT)","openapi":"PUT /orgs/{org_id}/projects/{project_id}/workforce/{workforce}/{*path}","href":"/api-reference/projects/workforce/call-put"},{"title":"Call Workforce (PATCH)","openapi":"PATCH /orgs/{org_id}/projects/{project_id}/workforce/{workforce}/{*path}","href":"/api-reference/projects/workforce/call-patch"},{"title":"Call Workforce (DELETE)","openapi":"DELETE /orgs/{org_id}/projects/{project_id}/workforce/{workforce}/{*path}","href":"/api-reference/projects/workforce/call-delete"}]}]},{"group":"Knowledge Bases","pages":[{"title":"List Knowledge Bases","openapi":"GET /orgs/{org_id}/k2","href":"/api-reference/knowledge-bases/list"},{"title":"Create Knowledge Base","openapi":"POST /orgs/{org_id}/k2","href":"/api-reference/knowledge-bases/create"},{"title":"Get Knowledge Base","openapi":"GET /orgs/{org_id}/k2/{kb_id}","href":"/api-reference/knowledge-bases/get"},{"title":"Edit Knowledge Base","openapi":"PATCH /orgs/{org_id}/k2/{kb_id}","href":"/api-reference/knowledge-bases/update"},{"title":"Delete Knowledge Base","openapi":"DELETE /orgs/{org_id}/k2/{kb_id}","href":"/api-reference/knowledge-bases/delete"},{"title":"Query","openapi":"POST /orgs/{org_id}/k2/{kb_id}/query","href":"/api-reference/knowledge-bases/query"},{"title":"Get Schema","openapi":"GET /orgs/{org_id}/k2/{kb_id}/schema","href":"/api-reference/knowledge-bases/schema"},{"title":"Upload Data","openapi":"POST /orgs/{org_id}/k2/{kb_id}/upload","href":"/api-reference/knowledge-bases/upload"},{"group":"Policies","pages":[{"title":"List Policies","openapi":"GET /orgs/{org_id}/k2/{kb_id}/policies","href":"/api-reference/knowledge-bases/policies/list"},{"title":"Create Policy","openapi":"POST /orgs/{org_id}/k2/{kb_id}/policies","href":"/api-reference/knowledge-bases/policies/create"},{"title":"Get Policy","openapi":"GET /orgs/{org_id}/k2/{kb_id}/policies/{policy_id}","href":"/api-reference/knowledge-bases/policies/get"},{"title":"Update Policy","openapi":"PATCH /orgs/{org_id}/k2/{kb_id}/policies/{policy_id}","href":"/api-reference/knowledge-bases/policies/update"},{"title":"Delete Policy","openapi":"DELETE /orgs/{org_id}/k2/{kb_id}/policies/{policy_id}","href":"/api-reference/knowledge-bases/policies/delete"},{"title":"Set Governance Mode","openapi":"PUT /orgs/{org_id}/k2/{kb_id}/policies/governance-mode","href":"/api-reference/knowledge-bases/policies/governance-mode"},{"group":"Assignments","pages":[{"title":"List Policy Assignments","openapi":"GET /orgs/{org_id}/k2/{kb_id}/policies/{policy_id}/assignments","href":"/api-reference/knowledge-bases/policies/assignments/list"},{"title":"Create Policy Assignment","openapi":"POST /orgs/{org_id}/k2/{kb_id}/policies/{policy_id}/assignments","href":"/api-reference/knowledge-bases/policies/assignments/create"},{"title":"Get Policy Assignment","openapi":"GET /orgs/{org_id}/k2/{kb_id}/policies/{policy_id}/assignments/{assignment_id}","href":"/api-reference/knowledge-bases/policies/assignments/get"},{"title":"Delete Policy Assignment","openapi":"DELETE /orgs/{org_id}/k2/{kb_id}/policies/{policy_id}/assignments/{assignment_id}","href":"/api-reference/knowledge-bases/policies/assignments/delete"}]}]},{"group":"Backups","pages":[{"title":"List Backups","openapi":"GET /orgs/{org_id}/k2/{kb_id}/backups","href":"/api-reference/knowledge-bases/backups/list"},{"title":"Create Backup","openapi":"POST /orgs/{org_id}/k2/{kb_id}/backups","href":"/api-reference/knowledge-bases/backups/create"},{"title":"Get Backup","openapi":"GET /orgs/{org_id}/k2/{kb_id}/backups/{backup_id}","href":"/api-reference/knowledge-bases/backups/get"},{"title":"List Restores","openapi":"GET /orgs/{org_id}/k2/{kb_id}/restores","href":"/api-reference/knowledge-bases/restores/list"},{"title":"Restore","openapi":"POST /orgs/{org_id}/k2/{kb_id}/restores","href":"/api-reference/knowledge-bases/restores/create"},{"title":"Get Restore","openapi":"GET /orgs/{org_id}/k2/{kb_id}/restores/{restore_id}","href":"/api-reference/knowledge-bases/restores/get"}]},{"group":"Files","pages":[{"title":"List Files","openapi":"GET /orgs/{org_id}/k2/{kb_id}/files","href":"/api-reference/knowledge-bases/files/list"},{"title":"Add File","openapi":"POST /orgs/{org_id}/k2/{kb_id}/files","href":"/api-reference/knowledge-bases/files/add"},{"title":"Create Directory","openapi":"POST /orgs/{org_id}/k2/{kb_id}/directories","href":"/api-reference/knowledge-bases/files/create-dir"},{"title":"Get File","openapi":"GET /orgs/{org_id}/k2/{kb_id}/files/{file_id}","href":"/api-reference/knowledge-bases/files/get"},{"title":"Delete File","openapi":"DELETE /orgs/{org_id}/k2/{kb_id}/files/{file_id}","href":"/api-reference/knowledge-bases/files/delete"},{"group":"Chunks","pages":[{"title":"List Chunks","openapi":"GET /orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks","href":"/api-reference/knowledge-bases/files/chunks/list"},{"title":"Insert Chunk","openapi":"POST /orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks","href":"/api-reference/knowledge-bases/files/chunks/insert"},{"title":"Get Chunk","openapi":"GET /orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}","href":"/api-reference/knowledge-bases/files/chunks/get"},{"title":"Update Chunk","openapi":"PATCH /orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}","href":"/api-reference/knowledge-bases/files/chunks/update"},{"title":"Delete Chunk","openapi":"DELETE /orgs/{org_id}/k2/{kb_id}/files/{file_id}/chunks/{chunk_uid}","href":"/api-reference/knowledge-bases/files/chunks/delete"}]}]}]},{"group":"Evals","pages":[{"title":"List Eval Definitions","openapi":"GET /orgs/{org_id}/projects/{project_id}/envs/{env_id}/evals/definitions","href":"/api-reference/evals/definitions"},{"group":"Jobs","pages":[{"title":"List Eval Jobs","openapi":"GET /orgs/{org_id}/projects/{project_id}/envs/{env_id}/evals/jobs","href":"/api-reference/evals/jobs/list"},{"title":"Get Eval Job","openapi":"GET /orgs/{org_id}/projects/{project_id}/envs/{env_id}/evals/jobs/{job_uid}","href":"/api-reference/evals/jobs/get"},{"title":"Create Eval Job","openapi":"POST /orgs/{org_id}/projects/{project_id}/envs/{env_id}/evals/jobs","href":"/api-reference/evals/jobs/create"}]},{"group":"Runs","pages":[{"title":"List Eval Runs","openapi":"GET /orgs/{org_id}/projects/{project_id}/envs/{env_id}/evals/runs","href":"/api-reference/evals/runs/list"},{"title":"Get Eval Run","openapi":"GET /orgs/{org_id}/projects/{project_id}/envs/{env_id}/evals/runs/{eval_run_id}","href":"/api-reference/evals/runs/get"},{"title":"Stream Eval Run Events","openapi":"GET /orgs/{org_id}/projects/{project_id}/envs/{env_id}/evals/runs/{eval_run_id}/events","href":"/api-reference/evals/runs/events"},{"title":"Create Eval Run","openapi":"POST /orgs/{org_id}/projects/{project_id}/envs/{env_id}/evals/runs","href":"/api-reference/evals/runs/create"},{"title":"Delete Eval Run","openapi":"DELETE /orgs/{org_id}/projects/{project_id}/envs/{env_id}/evals/runs/{eval_run_id}","href":"/api-reference/evals/runs/delete"}]}]},{"group":"ACE","tag":"Pro","pages":[{"title":"Create from Agent","openapi":"POST /orgs/{org_id}/projects/{project_id}/workforce/{workforce}/ace","href":"/api-reference/ace/create-from-workforce"},{"title":"Link to Agent","openapi":"PUT /orgs/{org_id}/projects/{project_id}/workforce/{workforce}/ace","href":"/api-reference/ace/link"},{"title":"Unlink from Agent","openapi":"DELETE /orgs/{org_id}/projects/{project_id}/workforce/{workforce}/ace","href":"/api-reference/ace/unlink"},{"title":"List Policies","openapi":"GET /ace/{ace_uid}/policies","href":"/api-reference/ace/list-policies"},{"title":"List Context Variables","openapi":"GET /ace/{ace_uid}/vars","href":"/api-reference/ace/list-context-vars"},{"title":"Chat Completions","openapi":"POST /ace/{ace_uid}/v1/chat/completions","href":"/api-reference/ace/chat-completions"},{"group":"Jobs","pages":[{"title":"List Jobs","openapi":"GET /ace/{ace_uid}/jobs","href":"/api-reference/ace/jobs/list"},{"title":"Enqueue Job","openapi":"POST /ace/{ace_uid}/jobs","href":"/api-reference/ace/jobs/create"},{"title":"Get Job","openapi":"GET /ace/{ace_uid}/jobs/{job_uid}","href":"/api-reference/ace/jobs/get"},{"title":"Cancel Job","openapi":"POST /ace/{ace_uid}/jobs/{job_uid}/cancel","href":"/api-reference/ace/jobs/cancel"},{"title":"Retry Job","openapi":"POST /ace/{ace_uid}/jobs/{job_uid}/retry","href":"/api-reference/ace/jobs/retry"}]}]},{"group":"Alarms","pages":[{"title":"List Alarms","openapi":"GET /orgs/{org_id}/alarms","href":"/api-reference/alarms/list"},{"title":"Create Alarm","openapi":"POST /orgs/{org_id}/alarms","href":"/api-reference/alarms/create"},{"title":"Get Alarm","openapi":"GET /orgs/{org_id}/alarms/{alarm_id}","href":"/api-reference/alarms/get"},{"title":"Update Alarm","openapi":"PATCH /orgs/{org_id}/alarms/{alarm_id}","href":"/api-reference/alarms/update"},{"title":"Delete Alarm","openapi":"DELETE /orgs/{org_id}/alarms/{alarm_id}","href":"/api-reference/alarms/delete"},{"title":"Alarms Health","openapi":"GET /orgs/{org_id}/alarms/health","href":"/api-reference/alarms/health"},{"title":"Alarm History","openapi":"GET /orgs/{org_id}/alarms/{alarm_id}/history","href":"/api-reference/alarms/history"},{"title":"Attach Channel to Alarm","openapi":"POST /orgs/{org_id}/alarms/{alarm_id}/channels","href":"/api-reference/alarms/attach-channel"},{"title":"Detach Channel from Alarm","openapi":"DELETE /orgs/{org_id}/alarms/{alarm_id}/channels/{channel_id}","href":"/api-reference/alarms/detach-channel"},{"group":"Channels","pages":[{"title":"List Channels","openapi":"GET /orgs/{org_id}/channels","href":"/api-reference/alarms/channels/list"},{"title":"Create Channel","openapi":"POST /orgs/{org_id}/channels","href":"/api-reference/alarms/channels/create"},{"title":"Delete Channel","openapi":"DELETE /orgs/{org_id}/channels/{channel_id}","href":"/api-reference/alarms/channels/delete"}]},{"group":"Metrics","pages":[{"title":"Query Metric","openapi":"GET /orgs/{org_id}/metrics","href":"/api-reference/alarms/metrics/query"},{"title":"Metrics Catalog","openapi":"GET /orgs/{org_id}/metrics/catalog","href":"/api-reference/alarms/metrics/catalog"},{"group":"Definitions","pages":[{"title":"List Metric Definitions","openapi":"GET /orgs/{org_id}/metrics/definitions","href":"/api-reference/alarms/metrics/definitions/list"},{"title":"Create Metric Definition","openapi":"POST /orgs/{org_id}/metrics/definitions","href":"/api-reference/alarms/metrics/definitions/create"},{"title":"Preview Metric Definition","openapi":"POST /orgs/{org_id}/metrics/definitions/preview","href":"/api-reference/alarms/metrics/definitions/preview"},{"title":"Update Metric Definition","openapi":"PATCH /orgs/{org_id}/metrics/definitions/{definition_id}","href":"/api-reference/alarms/metrics/definitions/update"},{"title":"Delete Metric Definition","openapi":"DELETE /orgs/{org_id}/metrics/definitions/{definition_id}","href":"/api-reference/alarms/metrics/definitions/delete"}]}]}]},{"group":"Connectors","pages":[{"title":"List Connectors","openapi":"GET /orgs/{org_id}/connectors","href":"/api-reference/connectors/list"},{"title":"Get Connector","openapi":"GET /orgs/{org_id}/connectors/{connector_id}","href":"/api-reference/connectors/get"},{"title":"Update Connector","openapi":"POST /orgs/{org_id}/connectors/{connector_id}/update","href":"/api-reference/connectors/update"},{"title":"Push Local Config","openapi":"POST /orgs/{org_id}/connectors/{connector_id}/local-config","href":"/api-reference/connectors/local-config"},{"title":"Query Connector","openapi":"POST /orgs/{org_id}/connectors/{connector_id}/query","href":"/api-reference/connectors/query"},{"title":"Rebind Connector","openapi":"POST /orgs/{org_id}/connectors/{connector_id}/rebind","href":"/api-reference/connectors/rebind"},{"title":"Revoke Connector","openapi":"POST /orgs/{org_id}/connectors/{connector_id}/revoke","href":"/api-reference/connectors/revoke"},{"title":"Copy Filesystem to Knowledge Base","openapi":"POST /orgs/{org_id}/connectors/{connector_id}/filesystems/copy","href":"/api-reference/connectors/filesystems/copy"},{"group":"Enrollment Tokens","pages":[{"title":"Create Enrollment Token","openapi":"POST /orgs/{org_id}/connectors/enrollment-tokens","href":"/api-reference/connectors/enrollment-tokens/create"}]},{"group":"Jobs","pages":[{"title":"List Connector Jobs","openapi":"GET /orgs/{org_id}/connectors/jobs","href":"/api-reference/connectors/jobs/list"},{"title":"Create Connector Job","openapi":"POST /orgs/{org_id}/connectors/{connector_id}/jobs","href":"/api-reference/connectors/jobs/create"},{"title":"Stop Connector Job","openapi":"POST /orgs/{org_id}/connectors/{connector_id}/jobs/{job_id}/stop","href":"/api-reference/connectors/jobs/stop"}]},{"group":"Syncs","pages":[{"title":"List Connector Syncs","openapi":"GET /orgs/{org_id}/connectors/syncs","href":"/api-reference/connectors/syncs/list"},{"title":"Create Connector Sync","openapi":"POST /orgs/{org_id}/connectors/{connector_id}/syncs","href":"/api-reference/connectors/syncs/create"},{"title":"Get Connector Sync","openapi":"GET /orgs/{org_id}/connectors/{connector_id}/syncs/{sync_id}","href":"/api-reference/connectors/syncs/get"},{"title":"Update Connector Sync","openapi":"PATCH /orgs/{org_id}/connectors/{connector_id}/syncs/{sync_id}","href":"/api-reference/connectors/syncs/update"},{"title":"Delete Connector Sync","openapi":"DELETE /orgs/{org_id}/connectors/{connector_id}/syncs/{sync_id}","href":"/api-reference/connectors/syncs/delete"},{"title":"Run Sync Now","openapi":"POST /orgs/{org_id}/connectors/{connector_id}/syncs/{sync_id}/run","href":"/api-reference/connectors/syncs/run"}]},{"group":"Browse","pages":[{"title":"Browse Connections","openapi":"GET /orgs/{org_id}/connectors/{connector_id}/browse/connections","href":"/api-reference/connectors/browse/connections"},{"title":"Browse Tables","openapi":"GET /orgs/{org_id}/connectors/{connector_id}/browse/tables","href":"/api-reference/connectors/browse/tables"},{"title":"Browse Table","openapi":"GET /orgs/{org_id}/connectors/{connector_id}/browse/table","href":"/api-reference/connectors/browse/table"},{"title":"Browse Columns","openapi":"GET /orgs/{org_id}/connectors/{connector_id}/browse/columns","href":"/api-reference/connectors/browse/columns"},{"group":"Filesystems","pages":[{"title":"List Filesystems","openapi":"GET /orgs/{org_id}/connectors/{connector_id}/browse/filesystems","href":"/api-reference/connectors/browse/filesystems/list"},{"title":"List Filesystem Entries","openapi":"GET /orgs/{org_id}/connectors/{connector_id}/browse/filesystems/entries","href":"/api-reference/connectors/browse/filesystems/entries"},{"title":"Search Filesystem","openapi":"GET /orgs/{org_id}/connectors/{connector_id}/browse/filesystems/search","href":"/api-reference/connectors/browse/filesystems/search"},{"title":"Summarize Filesystem","openapi":"GET /orgs/{org_id}/connectors/{connector_id}/browse/filesystems/summary","href":"/api-reference/connectors/browse/filesystems/summary"}]}]}]}]},{"tab":"MCP Integration","pages":[{"title":"MCP Integration","href":"/mcp-integration"}]},{"tab":"Data Gateway","pages":[{"title":"Data Gateway","href":"/connect"}]}]},"basePath":"","title":"Call Workforce - Timbal","deploymentId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","buildId":"dpl_HhUetB7eHHDAmK9T1Teip38TgFx9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-jJHA3WSo.js","utils-DbZn3Mjn.js","cloneDeep-CnBnaSyy.js","_Uint8Array-CMQtTgBR.js","isObject-FP1Yky1u.js","utils-Bl2DvzOJ.js","addUniqueKeysToSchema-BwOLo9p1.js","snippetPresets-BBiPpKa-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C0px4Tml.js","isEqual-zAyttAAO.js","usePlaygroundInputsStore-Dell6dGw.js","shallow-0VKqkSqN.js","getApiPlaygroundDisplay-CP_ctPEB.js","CodeSnippet-5L35ic0s.js","CodeSnippets-DOXbNhJw.js","Page-DRLI_2Ue.js","getPastedJson-VhzT9m2P.js","icon-CD8_AtCO.js","MethodPill-DGgOMftG.js","DuplicateIcon-DZ6A_EtN.js","createIcon-DUl4oM5f.js","DynamicMarkdown-BGHukeRM.js","SectionHeading-ChrEUs8u.js","axios-vUo_bRtp.js","Markdown-Dj-na-_-.js","dist-C5gjFYHe.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-DEBW87tT.js"]}