Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
workspaceId
string
required
Workspace ID.
Example:
"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"
toolSetId
string
required
Tool set ID. Accepts the canonical ts_… form or the
external_id: form.
Example:
"toolset_01HXKD2E5NQM3T9AYWCFNRMN74"
Body
application/json
metadata
object
required
CreateResourceMetadata contains the user-provided fields for creating
a workspace-scoped resource. Read-only fields (id, account_id, workspace_id, profile_id,
created_at) are excluded since they are set by the server.
Show child attributes
spec
object
required
Show child attributes
Response
OK
metadata
object
required
Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
Show child attributes
spec
object
required
Show child attributes
state
enum<string>
required
read-only
The current lifecycle state of the tool. Output only. Use the :omit and
:restore actions to transition; tool set syncs may also update it.
Available options:
STATE_UNSPECIFIED,
STATE_AVAILABLE,
STATE_OMITTED,
STATE_ARCHIVED
info
object
Show child attributes
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Cadenya","colors":{"primary":"#165B41","light":"#165B41","dark":"#E1EE9A"},"logo":{"light":"https://mintcdn.com/cadenya/jC_UqeyZ_EgHWKnX/logo/light.svg?fit=max\u0026auto=format\u0026n=jC_UqeyZ_EgHWKnX\u0026q=85\u0026s=163995d0cd296848f58b95d41cfbb847","dark":"https://mintcdn.com/cadenya/jC_UqeyZ_EgHWKnX/logo/dark.svg?fit=max\u0026auto=format\u0026n=jC_UqeyZ_EgHWKnX\u0026q=85\u0026s=3a0a588c1ea4bb31882a0eb52df74362","href":"https://cadenya.com"},"favicon":"https://mintcdn.com/cadenya/jC_UqeyZ_EgHWKnX/favicon.svg?fit=max\u0026auto=format\u0026n=jC_UqeyZ_EgHWKnX\u0026q=85\u0026s=88bfdd038a09cd476e2dd90fa68f8074","api":{"examples":{"languages":["shell","ruby","go","typescript","python"],"autogenerate":false}},"navbar":{"links":[{"href":"https://app.cadenya.com/signup","label":"Sign Up"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.cadenya.com/login"}},"footer":{"socials":{"x":"https://x.com/cadenya","github":"https://github.com/cadenya"}},"fonts":{"heading":{"family":"ABC Arizona Flare Light","weight":300,"source":"fonts/ABCArizonaFlare-Light.woff2","format":"woff2"},"body":{"family":"Berkeley Mono","weight":400}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"cadenya","hasAudioNarration":false,"actualSubdomain":"cadenya","customDomains":["cadenya.com"],"gitSource":{"type":"github","owner":"cadenya","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6afa0bb8c11f076dcacd5539","clientVersion":"0.0.4177","searchFilterCounts":[{"language":"default","tag":"API Reference","count":156},{"language":"default","tag":"Objectives","count":19},{"language":"default","tag":"Webhook Events","count":15},{"language":"default","tag":"Widgets API","count":15},{"language":"default","tag":"Guides","count":14},{"language":"default","tag":"Agents","count":11},{"language":"default","tag":"API Keys","count":11},{"language":"default","tag":"Agent Variations","count":10},{"language":"default","tag":"Tool Sets","count":10},{"language":"default","tag":"Workspace Admin","count":9}]},"assistantConfig":{"enableStarterQuestions":false},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"brand.css","content":"@font-face{font-family:\"ABC Arizona Sans\";src:url(\"/fonts/ABCArizonaSansVariable.woff2\") format(\"woff2\");font-weight:100 700;font-style:normal;font-display:swap}@font-face{font-family:\"ABC Arizona Flare Light\";src:url(\"/fonts/ABCArizonaFlare-Light.woff2\") format(\"woff2\");font-weight:300;font-style:normal;font-display:swap}@font-face{font-family:\"ABC Arizona Sans\";src:url(\"/fonts/ABCArizonaSans-RegularItalic.woff2\") format(\"woff2\");font-weight:400;font-style:italic;font-display:swap}@font-face{font-family:\"ABC Arizona Sans\";src:url(\"/fonts/ABCArizonaSans-BoldItalic.woff2\") format(\"woff2\");font-weight:700;font-style:italic;font-display:swap}@font-face{font-family:\"Berkeley Mono\";src:url(\"/fonts/BerkeleyMono-Regular.otf\") format(\"opentype\");font-weight:400;font-style:normal;font-display:swap}:root{--cadenya-soil: #1d2c2f;--cadenya-sky: #ffffff;--cadenya-mycelium: #165b41;--cadenya-canopy: #e1ee9a;--cadenya-table-border: rgba(29, 44, 47, 0.18);--cadenya-table-header: rgba(22, 91, 65, 0.08);--cadenya-mermaid-node: var(--cadenya-canopy);--cadenya-mermaid-border: var(--cadenya-mycelium);--cadenya-mermaid-text: var(--cadenya-soil);--cadenya-mermaid-edge: var(--cadenya-mycelium);--cadenya-mermaid-label: rgba(255, 255, 255, 0.92)}html.dark,[data-theme=\"dark\"]{--cadenya-table-border: rgba(255, 255, 255, 0.2);--cadenya-table-header: rgba(225, 238, 154, 0.1);--cadenya-mermaid-node: var(--cadenya-mycelium);--cadenya-mermaid-border: var(--cadenya-canopy);--cadenya-mermaid-text: var(--cadenya-canopy);--cadenya-mermaid-edge: var(--cadenya-canopy);--cadenya-mermaid-label: rgba(29, 44, 47, 0.94)}body{font-family:\"Berkeley Mono\", ui-monospace, \"Cascadia Code\", monospace}h1,h2,h3,h4,h5,h6{font-family:\"ABC Arizona Flare Light\", Georgia, serif!important;font-weight:300!important;letter-spacing:-0.01em}#topbar-cta-button a[href=\"https://app.cadenya.com/login\"] span,#topbar-cta-button a[href=\"https://app.cadenya.com/login\"] svg{color:var(--cadenya-soil)!important}@font-face{font-family:\"Berkeley Mono\";src:url(\"/fonts/BerkeleyMono-Bold.otf\") format(\"opentype\");font-weight:600;font-style:normal;font-display:swap}@font-face{font-family:\"Berkeley Mono\";src:url(\"/fonts/BerkeleyMono-Bold.otf\") format(\"opentype\");font-weight:700;font-style:normal;font-display:swap}@font-face{font-family:\"Berkeley Mono\";src:url(\"/fonts/BerkeleyMono-Oblique.otf\") format(\"opentype\");font-weight:400;font-style:italic;font-display:swap}code,kbd,samp,pre,pre *{font-family:\"Berkeley Mono\", ui-monospace, \"Cascadia Code\", monospace}#content-area a.link>code{padding:0!important}strong,b{font-weight:700!important}#content-container table{border:1px solid var(--cadenya-table-border);border-collapse:separate;border-spacing:0;border-radius:0.5rem;overflow:hidden}#content-container table th,#content-container table td{border-right:1px solid var(--cadenya-table-border);border-bottom:1px solid var(--cadenya-table-border);padding-left:1rem;padding-right:1rem}#content-container table thead{background-color:var(--cadenya-table-header)}#content-container table thead th{padding-top:0.75rem;padding-bottom:0.75rem;vertical-align:middle}#content-container table th:last-child,#content-container table td:last-child{border-right:0}#content-container table tbody tr:last-child td{border-bottom:0}#content-container table.objective-events-table{width:100%;table-layout:fixed}#content-container table.objective-events-table th:first-child,#content-container table.objective-events-table td:first-child{width:25%}#content-container table.objective-events-table th:nth-child(2),#content-container table.objective-events-table td:nth-child(2){width:75%}#content-container table.objective-events-table td:first-child code{overflow-wrap:anywhere;white-space:normal}#content-container .mermaid svg{fill:var(--cadenya-mermaid-text)!important}#content-container .mermaid svg .node rect,#content-container .mermaid svg .node polygon,#content-container .mermaid svg .node path,#content-container .mermaid svg g.stateGroup rect,#content-container .mermaid svg .statediagram-cluster rect{fill:var(--cadenya-mermaid-node)!important;stroke:var(--cadenya-mermaid-border)!important}#content-container .mermaid svg .nodeLabel,#content-container .mermaid svg .cluster-label,#content-container .mermaid svg .stateLabel text,#content-container .mermaid svg g.stateGroup text,#content-container .mermaid svg g.stateGroup .state-title,#content-container .mermaid svg .edgeLabel,#content-container .mermaid svg .edgeLabel text,#content-container .mermaid svg .edgeLabel p{color:var(--cadenya-mermaid-text)!important;fill:var(--cadenya-mermaid-text)!important}#content-container .mermaid svg .transition,#content-container .mermaid svg .flowchart-link,#content-container .mermaid svg .edgePath path,#content-container .mermaid svg g.stateGroup line{stroke:var(--cadenya-mermaid-edge)!important}#content-container .mermaid svg marker path,#content-container .mermaid svg .marker,#content-container .mermaid svg [id$=\"-barbEnd\"],#content-container .mermaid svg [id$=\"-dependencyStart\"],#content-container .mermaid svg [id$=\"-dependencyEnd\"]{fill:var(--cadenya-mermaid-edge)!important;stroke:var(--cadenya-mermaid-edge)!important}#content-container .mermaid svg .edgeLabel,#content-container .mermaid svg .edgeLabel p{background-color:var(--cadenya-mermaid-label)!important}#content-container .mermaid svg .edgeLabel rect,#content-container .mermaid svg .stateLabel .box{fill:var(--cadenya-mermaid-label)!important;opacity:1!important}#content-container .mermaid svg .node circle.state-start,#content-container .mermaid svg .node .fork-join{fill:var(--cadenya-mermaid-edge)!important;stroke:var(--cadenya-mermaid-edge)!important}#content-container .mermaid svg .node circle.state-end{fill:var(--cadenya-mermaid-border)!important;stroke:var(--cadenya-mermaid-node)!important}#content-container .mermaid svg .end-state-inner{fill:var(--cadenya-mermaid-node)!important}#content-container .mermaid svg rect.actor{fill:var(--cadenya-mermaid-node)!important;stroke:var(--cadenya-mermaid-border)!important}#content-container .mermaid svg text.actor,#content-container .mermaid svg text.actor>tspan,#content-container .mermaid svg .messageText,#content-container .mermaid svg .messageText>tspan,#content-container .mermaid svg .labelText,#content-container .mermaid svg .labelText>tspan,#content-container .mermaid svg .loopText,#content-container .mermaid svg .loopText>tspan,#content-container .mermaid svg .noteText,#content-container .mermaid svg .noteText>tspan{color:var(--cadenya-mermaid-text)!important;fill:var(--cadenya-mermaid-text)!important;stroke:none!important}#content-container .mermaid svg .actor-line,#content-container .mermaid svg .messageLine0,#content-container .mermaid svg .messageLine1,#content-container .mermaid svg .loopLine{stroke:var(--cadenya-mermaid-edge)!important}#content-container .mermaid svg .labelBox,#content-container .mermaid svg .note,#content-container .mermaid svg .activation0,#content-container .mermaid svg .activation1,#content-container .mermaid svg .activation2,#content-container .mermaid svg g rect.rect{fill:var(--cadenya-mermaid-label)!important;stroke:var(--cadenya-mermaid-border)!important}#content-container .mermaid svg [id$=\"-sequencenumber\"] circle{fill:var(--cadenya-mermaid-edge)!important;stroke:var(--cadenya-mermaid-edge)!important}#content-container .mermaid svg .sequenceNumber{fill:var(--cadenya-mermaid-label)!important;stroke:none!important}.max-w-8xl,#body-content{max-width:106rem!important}#content-container{max-width:86rem!important}"}],"page":{"pagePath":"api-reference/toolservice/create-a-new-tool","slug":"/api-reference/toolservice/create-a-new-tool","pageMetadata":{"title":"Create a new tool","description":"Creates a new tool in the tool set","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools","href":"/api-reference/toolservice/create-a-new-tool","autogeneratedByOpenApi":true},"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: \"Creates a new tool in the tool set\"\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":"Create a new tool","description":"Creates a new tool in the tool set","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools","href":"/api-reference/toolservice/create-a-new-tool","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["ToolService","Tools"],"summary":"Create a new tool","description":"Creates a new tool in the tool set","operationId":"ToolService_CreateTool","parameters":["7e2f316f-3627-4205-8c71-30925ffb5911","05a54941-5e0f-4b04-b325-f2647dfcd719"],"requestBody":"d523ea8b-8bbb-4364-a01f-267c4695b0a5","responses":{"200":"3c1265c4-572f-470d-8c8d-56ac856561a2","default":"d50d5341-ef25-4b46-b339-9119745a38b4"},"x-codeSamples":[{"lang":"typescript","label":"TypeScript","source":"import Cadenya from '@cadenya/cadenya';\n\nconst client = new Cadenya();\nconst result = await client.toolSets.tools.create('tool_set_123', { metadata: {\"name\":\"sample\"}, spec: {\"config\":{\"http\":{\"requestMethod\":\"GET\"},\"type\":\"http\"},\"description\":\"sample\",\"parameters\":{},\"requiresApproval\":true} });"},{"lang":"go","label":"Go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"log\"\n\n\tcadenya \"go.cadenya.com/cadenya-go\"\n)\n\nfunc main() {\n\tclient, err := cadenya.NewClient()\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tctx := context.Background()\n\tparams := \u0026cadenya.ToolCreateParams{\n\t\tMetadata: \u0026cadenya.CreateResourceMetadata{Name: \"sample\"},\n\t\tSpec: \u0026cadenya.ToolSpecParam{Description: \"sample\", RequiresApproval: true, Parameters: map[string]any{}, Config: \u0026cadenya.ToolSpec_ConfigParam{HTTP: \u0026cadenya.ToolSpec_Config_HTTP{Type: \"http\", HTTP: \u0026cadenya.Config_HTTP{RequestMethod: cadenya.ConfigHTTPRequestMethod(\"GET\")}}}},\n\t}\n\tresult, err := client.ToolSets().Tools().Create(ctx, \"tool_set_123\", params)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", result)\n}"},{"lang":"python","label":"Python","source":"from cadenya import Cadenya\n\nwith Cadenya() as client:\n result = client.tool_sets.tools.create(\"tool_set_123\", metadata={\"name\": \"sample\"}, spec={\"config\": {\"http\": {\"request_method\": \"GET\"}, \"type\": \"http\"}, \"description\": \"sample\", \"parameters\": {}, \"requires_approval\": True})\n print(result)"},{"lang":"ruby","label":"Ruby","source":"require \"cadenya\"\n\nclient = Cadenya::Client.new\nresult = client.tool_sets.tools.create(\"tool_set_123\", metadata: {\"name\" => \"sample\"}, spec: {\"config\" => {\"http\" => {\"request_method\" => \"GET\"}, \"type\" => \"http\"}, \"description\" => \"sample\", \"parameters\" => {}, \"requires_approval\" => true})\nputs result.inspect"},{"lang":"bash","label":"CLI","source":"cadenya tool-sets tools create tool_set_123 \\\n --name sample \\\n --description sample \\\n --requires-approval \\\n --parameter '{}' \\\n --http-request-method get"},{"lang":"shell","label":"curl","source":"curl --request POST \\\n --url 'https://api.cadenya.com/v1/workspaces/workspace_123/tool_sets/tool_set_123/tools' \\\n --header \"Authorization: Bearer ${CADENYA_API_KEY}\" \\\n --header 'Content-Type: application/json' \\\n --data '{\"metadata\":{\"name\":\"sample\"},\"spec\":{\"config\":{\"http\":{\"requestMethod\":\"GET\"},\"type\":\"http\"},\"description\":\"sample\",\"parameters\":{},\"requiresApproval\":true}}'"}],"method":"post","type":"path","servers":["a2273d97-7234-4afb-a819-e55eda5e09e0"],"security":["3ca901ac-a242-46fa-adfa-914f40bb8d0f"],"path":"/v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools","baseUrlOptions":["https://api.cadenya.com"],"title":"Create a new tool","codeSamples":[{"label":"TypeScript","lang":"typescript","source":"import Cadenya from '@cadenya/cadenya';\n\nconst client = new Cadenya();\nconst result = await client.toolSets.tools.create('tool_set_123', { metadata: {\"name\":\"sample\"}, spec: {\"config\":{\"http\":{\"requestMethod\":\"GET\"},\"type\":\"http\"},\"description\":\"sample\",\"parameters\":{},\"requiresApproval\":true} });"},{"label":"Go","lang":"go","source":"package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\t\"log\"\n\n\tcadenya \"go.cadenya.com/cadenya-go\"\n)\n\nfunc main() {\n\tclient, err := cadenya.NewClient()\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tctx := context.Background()\n\tparams := \u0026cadenya.ToolCreateParams{\n\t\tMetadata: \u0026cadenya.CreateResourceMetadata{Name: \"sample\"},\n\t\tSpec: \u0026cadenya.ToolSpecParam{Description: \"sample\", RequiresApproval: true, Parameters: map[string]any{}, Config: \u0026cadenya.ToolSpec_ConfigParam{HTTP: \u0026cadenya.ToolSpec_Config_HTTP{Type: \"http\", HTTP: \u0026cadenya.Config_HTTP{RequestMethod: cadenya.ConfigHTTPRequestMethod(\"GET\")}}}},\n\t}\n\tresult, err := client.ToolSets().Tools().Create(ctx, \"tool_set_123\", params)\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\tfmt.Printf(\"%+v\\n\", result)\n}"},{"label":"Python","lang":"python","source":"from cadenya import Cadenya\n\nwith Cadenya() as client:\n result = client.tool_sets.tools.create(\"tool_set_123\", metadata={\"name\": \"sample\"}, spec={\"config\": {\"http\": {\"request_method\": \"GET\"}, \"type\": \"http\"}, \"description\": \"sample\", \"parameters\": {}, \"requires_approval\": True})\n print(result)"},{"label":"Ruby","lang":"ruby","source":"require \"cadenya\"\n\nclient = Cadenya::Client.new\nresult = client.tool_sets.tools.create(\"tool_set_123\", metadata: {\"name\" => \"sample\"}, spec: {\"config\" => {\"http\" => {\"request_method\" => \"GET\"}, \"type\" => \"http\"}, \"description\" => \"sample\", \"parameters\" => {}, \"requires_approval\" => true})\nputs result.inspect"},{"label":"CLI","lang":"bash","source":"cadenya tool-sets tools create tool_set_123 \\\n --name sample \\\n --description sample \\\n --requires-approval \\\n --parameter '{}' \\\n --http-request-method get"},{"label":"curl","lang":"shell","source":"curl --request POST \\\n --url 'https://api.cadenya.com/v1/workspaces/workspace_123/tool_sets/tool_set_123/tools' \\\n --header \"Authorization: Bearer ${CADENYA_API_KEY}\" \\\n --header 'Content-Type: application/json' \\\n --data '{\"metadata\":{\"name\":\"sample\"},\"spec\":{\"config\":{\"http\":{\"requestMethod\":\"GET\"},\"type\":\"http\"},\"description\":\"sample\",\"parameters\":{},\"requiresApproval\":true}}'"}],"requestExampleLanguages":["bash","ruby","go","typescript","python"],"requiredOnlyExamples":false,"disableCodeSampleGeneration":true,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"7e2f316f-3627-4205-8c71-30925ffb5911":{"name":"workspaceId","in":"path","description":"Workspace ID.","required":true,"schema":{"type":"string","example":"workspace_01HXKD2E5NQM3T9AYWCF133E3Q","isRequired":true,"description":"Workspace ID.","uniqueKey":"","typeLabel":"string"}},"05a54941-5e0f-4b04-b325-f2647dfcd719":{"name":"toolSetId","in":"path","description":"Tool set ID. Accepts the canonical ts_… form or the\n external_id:\u003cvalue> form.","required":true,"schema":{"type":"string","example":"toolset_01HXKD2E5NQM3T9AYWCFNRMN74","isRequired":true,"description":"Tool set ID. Accepts the canonical ts_… form or the\n external_id:\u003cvalue> form.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"content":{"application/json":{"schema":{"required":["metadata","spec"],"type":"object","properties":{"metadata":{"required":["name"],"type":"object","properties":{"name":{"type":"string","description":"Human-readable name for the resource (e.g., \"Customer Support Agent\", \"Email Tool\")","isRequired":true,"uniqueKey":"metadata.name","typeLabel":"string"},"externalId":{"type":"string","description":"External ID for the resource (e.g., a workflow ID from an external system)","uniqueKey":"metadata.externalId","typeLabel":"string"},"labels":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"metadata.labels.additionalProperties","typeLabel":"string"},"description":"Key-value pairs for categorization and filtering. Values are 0-63\n alphanumeric characters with \"-\", \"_\", or \".\" allowed between; keys\n follow the same shape and additionally accept an optional DNS-subdomain\n prefix (e.g. \"cadenya.com/\") of at most 253 characters.\n Examples: {\"environment\": \"production\", \"team\": \"platform\", \"version\": \"v2\"}","uniqueKey":"metadata.labels","typeLabel":"object"}},"description":"CreateResourceMetadata contains the user-provided fields for creating\n a workspace-scoped resource. Read-only fields (id, account_id, workspace_id, profile_id,\n created_at) are excluded since they are set by the server.","isRequired":true,"uniqueKey":"metadata","typeLabel":"object"},"spec":{"required":["description","parameters","config","requiresApproval"],"type":"object","properties":{"description":{"type":"string","isRequired":true,"uniqueKey":"spec.description","typeLabel":"string"},"requiresApproval":{"type":"boolean","isRequired":true,"uniqueKey":"spec.requiresApproval","typeLabel":"boolean"},"parameters":{"type":"object","additionalProperties":true,"description":"The tool's JSON Schema, as handed to the LLM. Required, but may be the\n empty object `{}` for a tool that takes no arguments. Requiring it rather\n than defaulting it means a misspelled field name (`inputSchema`, say) is a\n 400 instead of a silently parameterless tool.","isRequired":true,"uniqueKey":"spec.parameters","typeLabel":"object"},"config":{"oneOf":[{"type":"object","description":"Configuration for this specific tool. Its transport is derived from the\n tool set adapter, while details such as endpoint and method are stored on\n the tool itself.\n\n Required, and exactly one adapter must be set.","required":["type","http"],"properties":{"type":{"type":"string","enum":["http"],"isRequired":true,"uniqueKey":"spec.config.oneOf.0.type","typeLabel":"enum\u003cstring>"},"http":{"required":["requestMethod"],"type":"object","properties":{"requestMethod":{"enum":["HTTP_METHOD_UNSPECIFIED","GET","POST","PUT","PATCH","DELETE"],"type":"string","format":"enum","isRequired":true,"uniqueKey":"spec.config.oneOf.0.http.requestMethod","typeLabel":"enum\u003cstring>"},"path":{"type":"string","uniqueKey":"spec.config.oneOf.0.http.path","typeLabel":"string"},"query":{"type":"string","uniqueKey":"spec.config.oneOf.0.http.query","typeLabel":"string"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"spec.config.oneOf.0.http.headers.additionalProperties","typeLabel":"string"},"uniqueKey":"spec.config.oneOf.0.http.headers","typeLabel":"object"},"requestBodyTemplate":{"type":"string","description":"These are only used when the request method is a POST, PUT, or PATCH","uniqueKey":"spec.config.oneOf.0.http.requestBodyTemplate","typeLabel":"string"},"requestBodyContentType":{"type":"string","uniqueKey":"spec.config.oneOf.0.http.requestBodyContentType","typeLabel":"string"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.0.http","typeLabel":"object"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.0","typeLabel":"object"},{"type":"object","description":"Configuration for this specific tool. Its transport is derived from the\n tool set adapter, while details such as endpoint and method are stored on\n the tool itself.\n\n Required, and exactly one adapter must be set.","required":["type","mcp"],"properties":{"type":{"type":"string","enum":["mcp"],"isRequired":true,"uniqueKey":"spec.config.oneOf.1.type","typeLabel":"enum\u003cstring>"},"mcp":{"type":"object","properties":{"annotations":{"type":"object","description":"Tool behavior annotations from the MCP server, captured during sync.","properties":{"title":{"type":"string","description":"A human-readable title for the tool.","uniqueKey":"spec.config.oneOf.1.mcp.annotations.title","typeLabel":"string"},"readOnlyHint":{"type":"boolean","description":"If true, the tool does not modify its environment.","uniqueKey":"spec.config.oneOf.1.mcp.annotations.readOnlyHint","typeLabel":"boolean"},"destructiveHint":{"type":"boolean","description":"If true, the tool may perform destructive updates to its environment.\n Only meaningful when read_only_hint is false.","uniqueKey":"spec.config.oneOf.1.mcp.annotations.destructiveHint","typeLabel":"boolean"},"idempotentHint":{"type":"boolean","description":"If true, calling the tool repeatedly with the same arguments has no\n additional effect. Only meaningful when read_only_hint is false.","uniqueKey":"spec.config.oneOf.1.mcp.annotations.idempotentHint","typeLabel":"boolean"},"openWorldHint":{"type":"boolean","description":"If true, the tool may interact with an \"open world\" of external\n entities (e.g. web search); if false, its domain is closed.","uniqueKey":"spec.config.oneOf.1.mcp.annotations.openWorldHint","typeLabel":"boolean"}},"uniqueKey":"spec.config.oneOf.1.mcp.annotations","typeLabel":"object"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.1.mcp","typeLabel":"object"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.1","typeLabel":"object"},{"type":"object","description":"Configuration for this specific tool. Its transport is derived from the\n tool set adapter, while details such as endpoint and method are stored on\n the tool itself.\n\n Required, and exactly one adapter must be set.","required":["type","openapi"],"properties":{"type":{"type":"string","enum":["openapi"],"isRequired":true,"uniqueKey":"spec.config.oneOf.2.type","typeLabel":"enum\u003cstring>"},"openapi":{"type":"object","properties":{"path":{"type":"string","uniqueKey":"spec.config.oneOf.2.openapi.path","typeLabel":"string"},"method":{"type":"string","uniqueKey":"spec.config.oneOf.2.openapi.method","typeLabel":"string"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.2.openapi","typeLabel":"object"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.2","typeLabel":"object"},{"type":"object","description":"Configuration for this specific tool. Its transport is derived from the\n tool set adapter, while details such as endpoint and method are stored on\n the tool itself.\n\n Required, and exactly one adapter must be set.","required":["type","bare"],"properties":{"type":{"type":"string","enum":["bare"],"isRequired":true,"uniqueKey":"spec.config.oneOf.3.type","typeLabel":"enum\u003cstring>"},"bare":{"type":"object","properties":{"alwaysSetResult":{"type":"string","description":"When set, the tool call's result is recorded immediately as this\n fixed text instead of parking the call to wait for externally\n supplied content. The tool_called event is still emitted. Useful for\n tools whose dispatch is the intent (e.g. a frontend renders a\n component from the call parameters) but whose LLM turn still needs\n tool-result content.","uniqueKey":"spec.config.oneOf.3.bare.alwaysSetResult","typeLabel":"string"}},"description":"Marks the tool as bare: it has no execution adapter of its own and\n relies on the parent tool set being a Bare tool set. Present so a\n webhook consumer can tell a tool is bare from the tool data alone,\n without cross-referencing the tool set.","isRequired":true,"uniqueKey":"spec.config.oneOf.3.bare","typeLabel":"object"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"spec.config","typeLabel":"object"},"llmToolName":{"type":"string","description":"The name provided to the LLM, which may differ from the metadata.name on the tool.\n LLMs have specific length and format requirements, and tool set sources may not comply\n with them, so Cadenya does its best to format names into a usable format.","uniqueKey":"spec.llmToolName","typeLabel":"string"}},"isRequired":true,"uniqueKey":"spec","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"metadata":{"name":"\u003cstring>","externalId":"\u003cstring>","labels":{}},"spec":{"description":"\u003cstring>","requiresApproval":true,"parameters":{},"config":{"type":"http","http":{"path":"\u003cstring>","query":"\u003cstring>","headers":{},"requestBodyTemplate":"\u003cstring>","requestBodyContentType":"\u003cstring>"}},"llmToolName":"\u003cstring>"}}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"3c1265c4-572f-470d-8c8d-56ac856561a2":{"description":"OK","content":{"application/json":{"schema":{"required":["metadata","spec","state"],"type":"object","properties":{"metadata":{"required":["id","accountId","workspaceId","name","profileId","createdAt","externalId","labels"],"type":"object","properties":{"id":{"readOnly":true,"type":"string","description":"Unique identifier for the resource (prefixed ULID, e.g., \"agent_01HXK...\")","isRequired":true,"uniqueKey":"metadata.id","typeLabel":"string"},"accountId":{"readOnly":true,"example":"account_01HXKD2E5NQM3T9AYWCFTJHJVF","type":"string","description":"Account this resource belongs to for multi-tenant isolation (prefixed ULID)","isRequired":true,"uniqueKey":"metadata.accountId","typeLabel":"string"},"workspaceId":{"readOnly":true,"example":"workspace_01HXKD2E5NQM3T9AYWCF133E3Q","type":"string","description":"Workspace this resource belongs to for organizational grouping (prefixed ULID)","isRequired":true,"uniqueKey":"metadata.workspaceId","typeLabel":"string"},"name":{"type":"string","description":"Human-readable name for the resource (e.g., \"Customer Support Agent\", \"Email Tool\")\n Required for resources that users interact with directly","isRequired":true,"uniqueKey":"metadata.name","typeLabel":"string"},"externalId":{"type":"string","description":"External ID for the resource (e.g., a workflow ID from an external system)","isRequired":true,"uniqueKey":"metadata.externalId","typeLabel":"string"},"labels":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"metadata.labels.additionalProperties","typeLabel":"string"},"description":"Key-value pairs for categorization and filtering. Values are 0-63\n alphanumeric characters with \"-\", \"_\", or \".\" allowed between; keys\n follow the same shape and additionally accept an optional DNS-subdomain\n prefix (e.g. \"cadenya.com/\") of at most 253 characters.\n Examples: {\"environment\": \"production\", \"team\": \"platform\", \"version\": \"v2\"}","isRequired":true,"uniqueKey":"metadata.labels","typeLabel":"object"},"profileId":{"readOnly":true,"example":"profile_01HXKD2E5NQM3T9AYWCFS0AP08","type":"string","description":"ID of the actor (user or service account) that created this resource","isRequired":true,"uniqueKey":"metadata.profileId","typeLabel":"string"},"createdAt":{"readOnly":true,"type":"string","description":"Timestamp when this resource was created","format":"date-time","isRequired":true,"uniqueKey":"metadata.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"readOnly":true,"type":"string","description":"Timestamp when this resource was last updated","format":"date-time","uniqueKey":"metadata.updatedAt","typeLabel":"string\u003cdate-time>"}},"description":"Standard metadata for persistent, named resources (e.g., agents, tools, prompts)","isRequired":true,"uniqueKey":"metadata","typeLabel":"object"},"spec":{"required":["description","parameters","config","requiresApproval"],"type":"object","properties":{"description":{"type":"string","isRequired":true,"uniqueKey":"spec.description","typeLabel":"string"},"requiresApproval":{"type":"boolean","isRequired":true,"uniqueKey":"spec.requiresApproval","typeLabel":"boolean"},"parameters":{"type":"object","additionalProperties":true,"description":"The tool's JSON Schema, as handed to the LLM. Required, but may be the\n empty object `{}` for a tool that takes no arguments. Requiring it rather\n than defaulting it means a misspelled field name (`inputSchema`, say) is a\n 400 instead of a silently parameterless tool.","isRequired":true,"uniqueKey":"spec.parameters","typeLabel":"object"},"config":{"oneOf":[{"type":"object","description":"Configuration for this specific tool. Its transport is derived from the\n tool set adapter, while details such as endpoint and method are stored on\n the tool itself.\n\n Required, and exactly one adapter must be set.","required":["type","http"],"properties":{"type":{"type":"string","enum":["http"],"isRequired":true,"uniqueKey":"spec.config.oneOf.0.type","typeLabel":"enum\u003cstring>"},"http":{"required":["requestMethod"],"type":"object","properties":{"requestMethod":{"enum":["HTTP_METHOD_UNSPECIFIED","GET","POST","PUT","PATCH","DELETE"],"type":"string","format":"enum","isRequired":true,"uniqueKey":"spec.config.oneOf.0.http.requestMethod","typeLabel":"enum\u003cstring>"},"path":{"type":"string","uniqueKey":"spec.config.oneOf.0.http.path","typeLabel":"string"},"query":{"type":"string","uniqueKey":"spec.config.oneOf.0.http.query","typeLabel":"string"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"spec.config.oneOf.0.http.headers.additionalProperties","typeLabel":"string"},"uniqueKey":"spec.config.oneOf.0.http.headers","typeLabel":"object"},"requestBodyTemplate":{"type":"string","description":"These are only used when the request method is a POST, PUT, or PATCH","uniqueKey":"spec.config.oneOf.0.http.requestBodyTemplate","typeLabel":"string"},"requestBodyContentType":{"type":"string","uniqueKey":"spec.config.oneOf.0.http.requestBodyContentType","typeLabel":"string"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.0.http","typeLabel":"object"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.0","typeLabel":"object"},{"type":"object","description":"Configuration for this specific tool. Its transport is derived from the\n tool set adapter, while details such as endpoint and method are stored on\n the tool itself.\n\n Required, and exactly one adapter must be set.","required":["type","mcp"],"properties":{"type":{"type":"string","enum":["mcp"],"isRequired":true,"uniqueKey":"spec.config.oneOf.1.type","typeLabel":"enum\u003cstring>"},"mcp":{"type":"object","properties":{"annotations":{"type":"object","description":"Tool behavior annotations from the MCP server, captured during sync.","properties":{"title":{"type":"string","description":"A human-readable title for the tool.","uniqueKey":"spec.config.oneOf.1.mcp.annotations.title","typeLabel":"string"},"readOnlyHint":{"type":"boolean","description":"If true, the tool does not modify its environment.","uniqueKey":"spec.config.oneOf.1.mcp.annotations.readOnlyHint","typeLabel":"boolean"},"destructiveHint":{"type":"boolean","description":"If true, the tool may perform destructive updates to its environment.\n Only meaningful when read_only_hint is false.","uniqueKey":"spec.config.oneOf.1.mcp.annotations.destructiveHint","typeLabel":"boolean"},"idempotentHint":{"type":"boolean","description":"If true, calling the tool repeatedly with the same arguments has no\n additional effect. Only meaningful when read_only_hint is false.","uniqueKey":"spec.config.oneOf.1.mcp.annotations.idempotentHint","typeLabel":"boolean"},"openWorldHint":{"type":"boolean","description":"If true, the tool may interact with an \"open world\" of external\n entities (e.g. web search); if false, its domain is closed.","uniqueKey":"spec.config.oneOf.1.mcp.annotations.openWorldHint","typeLabel":"boolean"}},"uniqueKey":"spec.config.oneOf.1.mcp.annotations","typeLabel":"object"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.1.mcp","typeLabel":"object"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.1","typeLabel":"object"},{"type":"object","description":"Configuration for this specific tool. Its transport is derived from the\n tool set adapter, while details such as endpoint and method are stored on\n the tool itself.\n\n Required, and exactly one adapter must be set.","required":["type","openapi"],"properties":{"type":{"type":"string","enum":["openapi"],"isRequired":true,"uniqueKey":"spec.config.oneOf.2.type","typeLabel":"enum\u003cstring>"},"openapi":{"type":"object","properties":{"path":{"type":"string","uniqueKey":"spec.config.oneOf.2.openapi.path","typeLabel":"string"},"method":{"type":"string","uniqueKey":"spec.config.oneOf.2.openapi.method","typeLabel":"string"},"serverUrl":{"readOnly":true,"type":"string","description":"The server URL this operation's requests are sent to when the tool set has\n no base_url, resolved from the spec on every sync: the operation's\n servers, else its path's, else the spec's top-level servers (the entry\n named by the tool set's server_name, else the first), with server\n variables set to their defaults and a relative URL resolved against the\n spec URL. A spec without servers resolves to the spec URL's origin.\n Empty when it cannot be resolved, such as a relative server in an\n uploaded spec. Set by sync.","uniqueKey":"spec.config.oneOf.2.openapi.serverUrl","typeLabel":"string"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.2.openapi","typeLabel":"object"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.2","typeLabel":"object"},{"type":"object","description":"Configuration for this specific tool. Its transport is derived from the\n tool set adapter, while details such as endpoint and method are stored on\n the tool itself.\n\n Required, and exactly one adapter must be set.","required":["type","bare"],"properties":{"type":{"type":"string","enum":["bare"],"isRequired":true,"uniqueKey":"spec.config.oneOf.3.type","typeLabel":"enum\u003cstring>"},"bare":{"type":"object","properties":{"alwaysSetResult":{"type":"string","description":"When set, the tool call's result is recorded immediately as this\n fixed text instead of parking the call to wait for externally\n supplied content. The tool_called event is still emitted. Useful for\n tools whose dispatch is the intent (e.g. a frontend renders a\n component from the call parameters) but whose LLM turn still needs\n tool-result content.","uniqueKey":"spec.config.oneOf.3.bare.alwaysSetResult","typeLabel":"string"}},"description":"Marks the tool as bare: it has no execution adapter of its own and\n relies on the parent tool set being a Bare tool set. Present so a\n webhook consumer can tell a tool is bare from the tool data alone,\n without cross-referencing the tool set.","isRequired":true,"uniqueKey":"spec.config.oneOf.3.bare","typeLabel":"object"}},"isRequired":true,"uniqueKey":"spec.config.oneOf.3","typeLabel":"object"}],"isRequired":true,"uniqueKey":"spec.config","typeLabel":"object"},"llmToolName":{"type":"string","description":"The name provided to the LLM, which may differ from the metadata.name on the tool.\n LLMs have specific length and format requirements, and tool set sources may not comply\n with them, so Cadenya does its best to format names into a usable format.","uniqueKey":"spec.llmToolName","typeLabel":"string"}},"isRequired":true,"uniqueKey":"spec","typeLabel":"object"},"state":{"readOnly":true,"enum":["STATE_UNSPECIFIED","STATE_AVAILABLE","STATE_OMITTED","STATE_ARCHIVED"],"type":"string","description":"The current lifecycle state of the tool. Output only. Use the :omit and\n :restore actions to transition; tool set syncs may also update it.","format":"enum","isRequired":true,"uniqueKey":"state","typeLabel":"enum\u003cstring>"},"info":{"required":["signature"],"type":"object","properties":{"signature":{"readOnly":true,"type":"string","description":"Content signature identifying the tool within its tool set: a hash of the\n sanitized llm_tool_name, description, and canonical parameters. Two tools\n with the same llm_tool_name but different parameters or description (as\n MCP servers may return per user) have distinct signatures. Computed over\n the raw spec — overlays do not change a tool's signature.","isRequired":true,"uniqueKey":"info.signature","typeLabel":"string"},"toolSet":{"required":["id","accountId","workspaceId","name","profileId","createdAt","externalId","labels"],"type":"object","properties":{"id":{"readOnly":true,"type":"string","description":"Unique identifier for the resource (prefixed ULID, e.g., \"agent_01HXK...\")","isRequired":true,"uniqueKey":"info.toolSet.id","typeLabel":"string"},"accountId":{"readOnly":true,"example":"account_01HXKD2E5NQM3T9AYWCFTJHJVF","type":"string","description":"Account this resource belongs to for multi-tenant isolation (prefixed ULID)","isRequired":true,"uniqueKey":"info.toolSet.accountId","typeLabel":"string"},"workspaceId":{"readOnly":true,"example":"workspace_01HXKD2E5NQM3T9AYWCF133E3Q","type":"string","description":"Workspace this resource belongs to for organizational grouping (prefixed ULID)","isRequired":true,"uniqueKey":"info.toolSet.workspaceId","typeLabel":"string"},"name":{"type":"string","description":"Human-readable name for the resource (e.g., \"Customer Support Agent\", \"Email Tool\")\n Required for resources that users interact with directly","isRequired":true,"uniqueKey":"info.toolSet.name","typeLabel":"string"},"externalId":{"type":"string","description":"External ID for the resource (e.g., a workflow ID from an external system)","isRequired":true,"uniqueKey":"info.toolSet.externalId","typeLabel":"string"},"labels":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"info.toolSet.labels.additionalProperties","typeLabel":"string"},"description":"Key-value pairs for categorization and filtering. Values are 0-63\n alphanumeric characters with \"-\", \"_\", or \".\" allowed between; keys\n follow the same shape and additionally accept an optional DNS-subdomain\n prefix (e.g. \"cadenya.com/\") of at most 253 characters.\n Examples: {\"environment\": \"production\", \"team\": \"platform\", \"version\": \"v2\"}","isRequired":true,"uniqueKey":"info.toolSet.labels","typeLabel":"object"},"profileId":{"readOnly":true,"example":"profile_01HXKD2E5NQM3T9AYWCFS0AP08","type":"string","description":"ID of the actor (user or service account) that created this resource","isRequired":true,"uniqueKey":"info.toolSet.profileId","typeLabel":"string"},"createdAt":{"readOnly":true,"type":"string","description":"Timestamp when this resource was created","format":"date-time","isRequired":true,"uniqueKey":"info.toolSet.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"readOnly":true,"type":"string","description":"Timestamp when this resource was last updated","format":"date-time","uniqueKey":"info.toolSet.updatedAt","typeLabel":"string\u003cdate-time>"}},"description":"Standard metadata for persistent, named resources (e.g., agents, tools, prompts)","uniqueKey":"info.toolSet","typeLabel":"object"},"createdBy":{"required":["metadata","spec"],"type":"object","properties":{"metadata":{"required":["id","accountId","name","profileId","externalId","labels"],"type":"object","properties":{"id":{"readOnly":true,"type":"string","description":"Unique identifier for the resource (prefixed ULID, e.g., \"apikey_01HXK...\")","isRequired":true,"uniqueKey":"info.createdBy.metadata.id","typeLabel":"string"},"accountId":{"readOnly":true,"example":"account_01HXKD2E5NQM3T9AYWCFTJHJVF","type":"string","description":"Account this resource belongs to for multi-tenant isolation (prefixed ULID)","isRequired":true,"uniqueKey":"info.createdBy.metadata.accountId","typeLabel":"string"},"name":{"type":"string","description":"Human-readable name for the resource (e.g., \"Customer Support Agent\", \"Email Tool\")\n Required for resources that users interact with directly","isRequired":true,"uniqueKey":"info.createdBy.metadata.name","typeLabel":"string"},"externalId":{"type":"string","description":"External ID for the resource (e.g., a workflow ID from an external system)","isRequired":true,"uniqueKey":"info.createdBy.metadata.externalId","typeLabel":"string"},"labels":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"info.createdBy.metadata.labels.additionalProperties","typeLabel":"string"},"description":"Key-value pairs for categorization and filtering. Values are 0-63\n alphanumeric characters with \"-\", \"_\", or \".\" allowed between; keys\n follow the same shape and additionally accept an optional DNS-subdomain\n prefix (e.g. \"cadenya.com/\") of at most 253 characters.\n Examples: {\"environment\": \"production\", \"team\": \"platform\", \"version\": \"v2\"}","isRequired":true,"uniqueKey":"info.createdBy.metadata.labels","typeLabel":"object"},"profileId":{"readOnly":true,"example":"profile_01HXKD2E5NQM3T9AYWCFS0AP08","type":"string","isRequired":true,"uniqueKey":"info.createdBy.metadata.profileId","typeLabel":"string"},"createdAt":{"readOnly":true,"type":"string","format":"date-time","uniqueKey":"info.createdBy.metadata.createdAt","typeLabel":"string\u003cdate-time>"}},"description":"AccountResourceMetadata is used to represent a resource that is associated to an account but not to a workspace.","isRequired":true,"uniqueKey":"info.createdBy.metadata","typeLabel":"object"},"spec":{"required":["type","email","name"],"type":"object","properties":{"email":{"type":"string","description":"Email address of the profile. Required and unique within an account for\n user profiles.","isRequired":true,"uniqueKey":"info.createdBy.spec.email","typeLabel":"string"},"name":{"type":"string","description":"Display name (e.g., \"Bobby Tables\").","isRequired":true,"uniqueKey":"info.createdBy.spec.name","typeLabel":"string"},"type":{"enum":["PROFILE_TYPE_UNSPECIFIED","PROFILE_TYPE_USER","PROFILE_TYPE_API_KEY","PROFILE_TYPE_SYSTEM"],"type":"string","description":"Whether this profile represents a human user, an API key, or a system\n principal.","format":"enum","isRequired":true,"uniqueKey":"info.createdBy.spec.type","typeLabel":"enum\u003cstring>"}},"description":"Configuration for a profile.","isRequired":true,"uniqueKey":"info.createdBy.spec","typeLabel":"object"}},"description":"A profile identifies a user or non-human principal (such as an API key)\n at the account level. Profiles are account-scoped and can be granted access\n to multiple workspaces.","uniqueKey":"info.createdBy","typeLabel":"object"},"overlays":{"readOnly":true,"type":"array","items":{"type":"string","uniqueKey":"info.overlays.items.[INDEX]","typeLabel":"string"},"description":"Keys of the tool set's overlays whose selectors match this tool\n (ToolSetSpec.overlays), in evaluation order. Disabled overlays are\n excluded. An overlay is listed when its selector matches even if none\n of its actions changed this tool's schema (all its paths were absent),\n so this answers \"which policies apply to this tool\" — diff\n effective_parameters against spec.parameters for \"what changed\".\n Empty when no overlay applies.","uniqueKey":"info.overlays","typeLabel":"string[]"},"effectiveParameters":{"readOnly":true,"type":"object","additionalProperties":true,"description":"The parameter schema as presented to the model: spec.parameters after\n every matching overlay's parameter actions have been applied, in order,\n including maintenance of the schema's `required` list. Actions whose\n outcome depends on the objective (pin with ON_MISSING_SKIP) are applied\n as if the pinned key were present, so this reflects the intended steady\n state rather than any one objective. Equals spec.parameters when no\n overlay applies. Result actions have no effect here.","uniqueKey":"info.effectiveParameters","typeLabel":"object"}},"uniqueKey":"info","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"metadata":{"id":"\u003cstring>","accountId":"account_01HXKD2E5NQM3T9AYWCFTJHJVF","workspaceId":"workspace_01HXKD2E5NQM3T9AYWCF133E3Q","name":"\u003cstring>","externalId":"\u003cstring>","labels":{},"profileId":"profile_01HXKD2E5NQM3T9AYWCFS0AP08","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"},"spec":{"description":"\u003cstring>","requiresApproval":true,"parameters":{},"config":{"type":"http","http":{"requestMethod":"HTTP_METHOD_UNSPECIFIED","path":"\u003cstring>","query":"\u003cstring>","headers":{},"requestBodyTemplate":"\u003cstring>","requestBodyContentType":"\u003cstring>"}},"llmToolName":"\u003cstring>"},"state":"STATE_UNSPECIFIED","info":{"signature":"\u003cstring>","toolSet":{"id":"\u003cstring>","accountId":"account_01HXKD2E5NQM3T9AYWCFTJHJVF","workspaceId":"workspace_01HXKD2E5NQM3T9AYWCF133E3Q","name":"\u003cstring>","externalId":"\u003cstring>","labels":{},"profileId":"profile_01HXKD2E5NQM3T9AYWCFS0AP08","createdAt":"2023-11-07T05:31:56Z","updatedAt":"2023-11-07T05:31:56Z"},"createdBy":{"metadata":{"id":"\u003cstring>","accountId":"account_01HXKD2E5NQM3T9AYWCFTJHJVF","name":"\u003cstring>","externalId":"\u003cstring>","labels":{},"profileId":"profile_01HXKD2E5NQM3T9AYWCFS0AP08","createdAt":"2023-11-07T05:31:56Z"},"spec":{"email":"\u003cstring>","name":"\u003cstring>","type":"PROFILE_TYPE_UNSPECIFIED"}},"overlays":["\u003cstring>"],"effectiveParameters":{}}}}},"exampleType":"generated"}},"exampleType":"generated"},"d50d5341-ef25-4b46-b339-9119745a38b4":{"description":"Default error response","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"integer","description":"The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].","format":"int32","uniqueKey":"code","typeLabel":"integer\u003cint32>"},"message":{"type":"string","description":"A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.","uniqueKey":"message","typeLabel":"string"},"details":{"type":"array","items":{"oneOf":[{"type":"object","description":"google.rpc.ErrorInfo detail for widget lifecycle failures. Match both domain and reason; ignore unknown reasons rather than renewing automatically.","required":["@type","domain","reason"],"properties":{"@type":{"type":"string","enum":["type.googleapis.com/google.rpc.ErrorInfo"],"isRequired":true,"uniqueKey":"details.items.[INDEX].oneOf.0.@type","typeLabel":"enum\u003cstring>"},"domain":{"type":"string","enum":["api.cadenya.com"],"isRequired":true,"uniqueKey":"details.items.[INDEX].oneOf.0.domain","typeLabel":"enum\u003cstring>"},"reason":{"type":"string","description":"TOKEN_EXPIRED identifies access-token expiry beyond the 60-second clock-skew tolerance. That token cannot renew; use already-installed newer credentials or require explicit app reauthentication. SESSION_* reasons are terminal. Never infer renewability from HTTP status alone.","enum":["TOKEN_EXPIRED","SESSION_REVOKED","SESSION_EXPIRED","SESSION_EXHAUSTED"],"isRequired":true,"uniqueKey":"details.items.[INDEX].oneOf.0.reason","typeLabel":"enum\u003cstring>"},"metadata":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"details.items.[INDEX].oneOf.0.metadata.additionalProperties","typeLabel":"string"},"description":"Optional non-sensitive context. Never contains tokens or secrets.","uniqueKey":"details.items.[INDEX].oneOf.0.metadata","typeLabel":"object"}},"uniqueKey":"details.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"Contains an arbitrary serialized message along with a @type that describes the type of the serialized message.","properties":{"@type":{"type":"string","description":"The type of the serialized message.","uniqueKey":"details.items.[INDEX].oneOf.1.@type","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"details.items.[INDEX].oneOf.1","typeLabel":"object"}],"uniqueKey":"details.items.[INDEX]","typeLabel":"object"},"description":"A list of messages that carry the error details. There is a common set of message types for APIs to use.","uniqueKey":"details","typeLabel":"object[]"}},"description":"The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":123,"message":"\u003cstring>","details":[{"@type":"type.googleapis.com/google.rpc.ErrorInfo","domain":"api.cadenya.com","reason":"TOKEN_EXPIRED","metadata":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"3ca901ac-a242-46fa-adfa-914f40bb8d0f":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"a2273d97-7234-4afb-a819-e55eda5e09e0":{"url":"https://api.cadenya.com","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://openapi.cadenya.com/api-spec.yml"},"subdomain":"cadenya","siteName":"Cadenya","title":"Create a new tool - Cadenya","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-15T18:49:53.877Z","originalFileLocation":"api-reference/toolservice/create-a-new-tool.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=\"Creates a new tool in the tool set\">\u003cmeta data-mint-head name=\"application-name\" content=\"Cadenya\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/cadenya/LWU29iiUTwEZ-Irb/_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=\"/docs/mintlify-assets/_mintlify/favicons/cadenya/LWU29iiUTwEZ-Irb/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/cadenya/LWU29iiUTwEZ-Irb/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/cadenya/LWU29iiUTwEZ-Irb/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/cadenya/LWU29iiUTwEZ-Irb/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/cadenya/LWU29iiUTwEZ-Irb/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/cadenya/LWU29iiUTwEZ-Irb/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/cadenya/LWU29iiUTwEZ-Irb/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/cadenya/LWU29iiUTwEZ-Irb/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create a new tool - Cadenya\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new tool in the tool set\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Cadenya\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://cadenya.com/docs/api-reference/toolservice/create-a-new-tool\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://cadenya.mintlify.site/docs/_mintlify/api/og/v2?division=Tools\u0026amp;title=Create+a+new+tool\u0026amp;description=Creates+a+new+tool+in+the+tool+set\u0026amp;theme=5f66039c69522c5b0d37ea0d\u0026amp;signature=c95f27135533b774b88f97ff15754f7ec5e7a7d577bf231416f0021a9df2ad65\">\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=\"Create a new tool - Cadenya\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new tool in the tool set\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://cadenya.mintlify.site/docs/_mintlify/api/og/v2?division=Tools\u0026amp;title=Create+a+new+tool\u0026amp;description=Creates+a+new+tool+in+the+tool+set\u0026amp;theme=5f66039c69522c5b0d37ea0d\u0026amp;signature=c95f27135533b774b88f97ff15754f7ec5e7a7d577bf231416f0021a9df2ad65\">\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=\"/docs/mintlify-assets/_mintlify/favicons/cadenya/LWU29iiUTwEZ-Irb/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Cadenya\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#165B41\">\u003clink data-mint-head rel=\"canonical\" href=\"https://cadenya.com/docs/api-reference/toolservice/create-a-new-tool\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/toolservice/create-a-new-tool.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://cadenya.com/#organization\",\"name\":\"Cadenya\",\"url\":\"https://cadenya.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/cadenya/jC_UqeyZ_EgHWKnX/logo/light.svg?fit=max\u0026auto=format\u0026n=jC_UqeyZ_EgHWKnX\u0026q=85\u0026s=163995d0cd296848f58b95d41cfbb847\"}},{\"@type\":\"WebSite\",\"@id\":\"https://cadenya.com/docs#website\",\"name\":\"Cadenya\",\"url\":\"https://cadenya.com/docs\",\"publisher\":{\"@id\":\"https://cadenya.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://cadenya.com/docs/api-reference/toolservice/create-a-new-tool#webpage\",\"url\":\"https://cadenya.com/docs/api-reference/toolservice/create-a-new-tool\",\"name\":\"Create a new tool\",\"description\":\"Creates a new tool in the tool set\",\"dateModified\":\"2026-11-15T18:49:53.877Z\",\"isPartOf\":{\"@id\":\"https://cadenya.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://cadenya.com/docs/api-reference/toolservice/create-a-new-tool#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://cadenya.com/docs/api-reference/toolservice/create-a-new-tool#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tools\",\"item\":\"https://cadenya.com/docs/api-reference/toolservice/list-tools\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a new tool\",\"item\":\"https://cadenya.com/docs/api-reference/toolservice/create-a-new-tool\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://cadenya.com/docs/api-reference/toolservice/create-a-new-tool#apireference\",\"headline\":\"Create a new tool\",\"name\":\"Create a new tool\",\"description\":\"Creates a new tool in the tool set\",\"url\":\"https://cadenya.com/docs/api-reference/toolservice/create-a-new-tool\",\"mainEntityOfPage\":{\"@id\":\"https://cadenya.com/docs/api-reference/toolservice/create-a-new-tool#webpage\"},\"dateModified\":\"2026-11-15T18:49:53.877Z\",\"publisher\":{\"@id\":\"https://cadenya.com/#organization\"},\"isPartOf\":{\"@id\":\"https://cadenya.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Cadenya\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Cadenya\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/toolservice/create-a-new-tool.md","siteName":"Cadenya","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/setup-from-a-coding-agent"}]},{"tab":"API Reference","icon":"brackets-curly","groups":[{"group":"Overview","pages":[{"title":"API reference","href":"/api-reference"}]},{"group":"Tool Sets","pages":[{"title":"List tool sets","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tool_sets","href":"/api-reference/toolservice/list-tool-sets"},{"title":"Create a new tool set","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/tool_sets","href":"/api-reference/toolservice/create-a-new-tool-set"},{"title":"Get a tool set by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tool_sets/{id}","href":"/api-reference/toolservice/get-a-tool-set-by-id"},{"title":"Update a tool set","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/tool_sets/{id}","href":"/api-reference/toolservice/update-a-tool-set"},{"title":"Delete a tool set","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/tool_sets/{id}","href":"/api-reference/toolservice/delete-a-tool-set"},{"title":"Archive a tool set","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/tool_sets/{id}:archive","href":"/api-reference/toolservice/archive-a-tool-set"},{"title":"Unarchive a tool set","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/tool_sets/{id}:unarchive","href":"/api-reference/toolservice/unarchive-a-tool-set"},{"title":"List tool set events","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/events","href":"/api-reference/toolservice/list-tool-set-events"},{"title":"Get consumed OpenAPI spec","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/openapi_spec","href":"/api-reference/toolservice/get-consumed-openapi-spec"},{"title":"List tool set usage","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/usage","href":"/api-reference/toolservice/list-tool-set-usage"}]},{"group":"Tools","pages":[{"title":"List tools","description":"Lists all tools in the tool set","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools","href":"/api-reference/toolservice/list-tools"},{"title":"Create a new tool","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools","href":"/api-reference/toolservice/create-a-new-tool"},{"title":"Get a tool by ID","description":"Retrieves a tool by ID from the workspace","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools/{id}","href":"/api-reference/toolservice/get-a-tool-by-id"},{"title":"Update a tool","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools/{id}","href":"/api-reference/toolservice/update-a-tool"},{"title":"Delete a tool","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools/{id}","href":"/api-reference/toolservice/delete-a-tool"},{"title":"Omit a tool","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools/{id}:omit","href":"/api-reference/toolservice/omit-a-tool"},{"title":"Restore a tool","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/tools/{id}:restore","href":"/api-reference/toolservice/restore-a-tool"},{"title":"Search for tools or tool sets","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/search/tools_or_tool_sets","href":"/api-reference/searchservice/search-for-tools-or-tool-sets"}]},{"group":"Tool Set Secrets","pages":[{"title":"List tool set secrets","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/secrets","href":"/api-reference/toolservice/list-tool-set-secrets"},{"title":"Create a new tool set secret","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/secrets","href":"/api-reference/toolservice/create-a-new-tool-set-secret"},{"title":"Get a tool set secret by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/secrets/{id}","href":"/api-reference/toolservice/get-a-tool-set-secret-by-id"},{"title":"Update a tool set secret","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/secrets/{id}","href":"/api-reference/toolservice/update-a-tool-set-secret"},{"title":"Delete a tool set secret","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/tool_sets/{toolSetId}/secrets/{id}","href":"/api-reference/toolservice/delete-a-tool-set-secret"}]},{"group":"Agents","pages":[{"title":"List agents","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/agents","href":"/api-reference/agentservice/list-agents"},{"title":"Create a new agent","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents","href":"/api-reference/agentservice/create-a-new-agent"},{"title":"List feedback for an agent","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/agents/{agentId}/feedback","href":"/api-reference/agentservice/list-feedback-for-an-agent"},{"title":"List webhook deliveries","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/agents/{agentId}/webhook_deliveries","href":"/api-reference/agentservice/list-webhook-deliveries"},{"title":"Get an agent by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/agents/{id}","href":"/api-reference/agentservice/get-an-agent-by-id"},{"title":"Delete an agent","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/agents/{id}","href":"/api-reference/agentservice/delete-an-agent"},{"title":"Update an agent","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/agents/{id}","href":"/api-reference/agentservice/update-an-agent"},{"title":"Publish an agent","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{id}:publish","href":"/api-reference/agentservice/publish-an-agent"},{"title":"Unpublish an agent","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{id}:unpublish","href":"/api-reference/agentservice/unpublish-an-agent"},{"title":"Archive an agent","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{id}:archive","href":"/api-reference/agentservice/archive-an-agent"},{"title":"Unarchive an agent","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{id}:unarchive","href":"/api-reference/agentservice/unarchive-an-agent"}]},{"group":"Agent Variations","pages":[{"title":"List variations","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/agents/{agentId}/variations","href":"/api-reference/agentvariationservice/list-variations"},{"title":"Create a new variation","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{agentId}/variations","href":"/api-reference/agentvariationservice/create-a-new-variation"},{"title":"Get a variation by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/agents/{agentId}/variations/{id}","href":"/api-reference/agentvariationservice/get-a-variation-by-id"},{"title":"Delete a variation","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/agents/{agentId}/variations/{id}","href":"/api-reference/agentvariationservice/delete-a-variation"},{"title":"Update a variation","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/agents/{agentId}/variations/{id}","href":"/api-reference/agentvariationservice/update-a-variation"},{"title":"Add an assignment to a variation","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{agentId}/variations/{variationId}:addAssignment","href":"/api-reference/agentvariationservice/add-an-assignment-to-a-variation"},{"title":"Remove an assignment from a variation","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{agentId}/variations/{variationId}:removeAssignment","href":"/api-reference/agentvariationservice/remove-an-assignment-from-a-variation"},{"title":"Attach a memory layer to a variation","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{agentId}/variations/{variationId}:addMemoryLayer","href":"/api-reference/agentvariationservice/attach-a-memory-layer-to-a-variation"},{"title":"Remove a memory layer assignment from a variation","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{agentId}/variations/{variationId}:removeMemoryLayer","href":"/api-reference/agentvariationservice/remove-a-memory-layer-assignment-from-a-variation"},{"title":"Update a variation's memory layer assignment","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{agentId}/variations/{variationId}:updateMemoryLayer","href":"/api-reference/agentvariationservice/update-a-variations-memory-layer-assignment"}]},{"group":"Agent Schedules","pages":[{"title":"List schedules","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/agents/{agentId}/schedules","href":"/api-reference/agentscheduleservice/list-schedules"},{"title":"Create a new schedule","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{agentId}/schedules","href":"/api-reference/agentscheduleservice/create-a-new-schedule"},{"title":"Get a schedule by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/agents/{agentId}/schedules/{id}","href":"/api-reference/agentscheduleservice/get-a-schedule-by-id"},{"title":"Delete a schedule","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/agents/{agentId}/schedules/{id}","href":"/api-reference/agentscheduleservice/delete-a-schedule"},{"title":"Update a schedule","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/agents/{agentId}/schedules/{id}","href":"/api-reference/agentscheduleservice/update-a-schedule"},{"title":"Pause a schedule","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{agentId}/schedules/{id}:pause","href":"/api-reference/agentscheduleservice/pause-a-schedule"},{"title":"Resume a schedule","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{agentId}/schedules/{id}:resume","href":"/api-reference/agentscheduleservice/resume-a-schedule"},{"title":"Archive a schedule","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/agents/{agentId}/schedules/{id}:archive","href":"/api-reference/agentscheduleservice/archive-a-schedule"}]},{"group":"Objectives","pages":[{"title":"List objectives","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/objectives","href":"/api-reference/objectiveservice/list-objectives"},{"title":"Create a new objective","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/objectives","href":"/api-reference/objectiveservice/create-a-new-objective"},{"title":"Create an objective and stream its events","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/objectives:stream","href":"/api-reference/objectiveeventstreamsservice/create-an-objective-and-stream-its-events"},{"title":"Get an objective by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/objectives/{id}","href":"/api-reference/objectiveservice/get-an-objective-by-id"},{"title":"Cancel an objective","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/objectives/{objectiveId}:cancel","href":"/api-reference/objectiveservice/cancel-an-objective"},{"title":"Compact an objective","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/objectives/{objectiveId}:compact","href":"/api-reference/objectiveservice/compact-an-objective"},{"title":"List objective context windows","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/objectives/{objectiveId}/context_windows","href":"/api-reference/objectiveservice/list-objective-context-windows"},{"title":"Continue an objective","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/objectives/{objectiveId}:continue","href":"/api-reference/objectiveservice/continue-an-objective"},{"title":"List objective events","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/objectives/{objectiveId}/events","href":"/api-reference/objectiveservice/list-objective-events"},{"title":"Stream objective events","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/objectives/{objectiveId}/events:stream","href":"/api-reference/objectiveeventstreamsservice/stream-objective-events"},{"title":"Get objective context usage","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/objectives/{objectiveId}/diagnostics","href":"/api-reference/objectiveservice/get-objective-context-usage"},{"title":"List feedback for an objective","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/objectives/{objectiveId}/feedback","href":"/api-reference/objectiveservice/list-feedback-for-an-objective"},{"title":"Submit feedback for an objective","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/objectives/{objectiveId}/feedback","href":"/api-reference/objectiveservice/submit-feedback-for-an-objective"},{"title":"List objective tool calls","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls","href":"/api-reference/objectiveservice/list-objective-tool-calls"},{"title":"Get an objective tool call by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls/{toolCallId}","href":"/api-reference/objectiveservice/get-an-objective-tool-call-by-id"},{"title":"Approve a tool call","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls/{toolCallId}:approve","href":"/api-reference/objectiveservice/approve-a-tool-call"},{"title":"Deny a tool call","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls/{toolCallId}:deny","href":"/api-reference/objectiveservice/deny-a-tool-call"},{"title":"Set a bare tool call's content","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/objectives/{objectiveId}/tool_calls/{toolCallId}:setContent","href":"/api-reference/objectiveservice/set-a-bare-tool-calls-content"},{"title":"List objective tools","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/objectives/{objectiveId}/tools","href":"/api-reference/objectiveservice/list-objective-tools"}]},{"group":"Widgets","pages":[{"title":"List widgets","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/widgets","href":"/api-reference/widgetservice/list-widgets"},{"title":"Create a new widget","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/widgets","href":"/api-reference/widgetservice/create-a-new-widget"},{"title":"Get a widget by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/widgets/{id}","href":"/api-reference/widgetservice/get-a-widget-by-id"},{"title":"Update a widget","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/widgets/{id}","href":"/api-reference/widgetservice/update-a-widget"},{"title":"Delete a widget","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/widgets/{id}","href":"/api-reference/widgetservice/delete-a-widget"},{"title":"Archive a widget","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/widgets/{id}:archive","href":"/api-reference/widgetservice/archive-a-widget"},{"title":"Unarchive a widget","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/widgets/{id}:unarchive","href":"/api-reference/widgetservice/unarchive-a-widget"}]},{"group":"Widget Sessions","pages":[{"title":"List widget sessions","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/widget_sessions","href":"/api-reference/widgetsessionservice/list-widget-sessions"},{"title":"Create a widget session","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/widget_sessions","href":"/api-reference/widgetsessionservice/create-a-widget-session"},{"title":"Get a widget session by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/widget_sessions/{id}","href":"/api-reference/widgetsessionservice/get-a-widget-session-by-id"},{"title":"Revoke a widget session","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/widget_sessions/{id}:revoke","href":"/api-reference/widgetsessionservice/revoke-a-widget-session"},{"title":"Delete a widget session","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/widget_sessions/{id}","href":"/api-reference/widgetsessionservice/delete-a-widget-session"},{"title":"Delete all of a tenant's widget sessions","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/widget_sessions","href":"/api-reference/widgetsessionservice/delete-all-of-a-tenants-widget-sessions"}]},{"group":"Tenants","pages":[{"title":"List tenants","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tenants","href":"/api-reference/tenantservice/list-tenants"},{"title":"Get a tenant by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tenants/{id}","href":"/api-reference/tenantservice/get-a-tenant-by-id"},{"title":"List a tenant's subjects","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/tenants/{tenantId}/subjects","href":"/api-reference/tenantservice/list-a-tenants-subjects"},{"title":"Erase a tenant","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/tenants/{id}","href":"/api-reference/tenantservice/erase-a-tenant"}]},{"group":"Memory Layers","pages":[{"title":"List memory layers","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/memory_layers","href":"/api-reference/memoryservice/list-memory-layers"},{"title":"Create a new memory layer","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/memory_layers","href":"/api-reference/memoryservice/create-a-new-memory-layer"},{"title":"Get a memory layer by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/memory_layers/{id}","href":"/api-reference/memoryservice/get-a-memory-layer-by-id"},{"title":"Delete a memory layer","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/memory_layers/{id}","href":"/api-reference/memoryservice/delete-a-memory-layer"},{"title":"Update a memory layer","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/memory_layers/{id}","href":"/api-reference/memoryservice/update-a-memory-layer"}]},{"group":"Memory Entries","pages":[{"title":"List memory entries","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries","href":"/api-reference/memoryservice/list-memory-entries"},{"title":"Create a new memory entry","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries","href":"/api-reference/memoryservice/create-a-new-memory-entry"},{"title":"Get a memory entry by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id}","href":"/api-reference/memoryservice/get-a-memory-entry-by-id"},{"title":"Delete a memory entry","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id}","href":"/api-reference/memoryservice/delete-a-memory-entry"},{"title":"Update a memory entry","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/memory_layers/{memoryLayerId}/entries/{id}","href":"/api-reference/memoryservice/update-a-memory-entry"}]},{"group":"Models","pages":[{"title":"List models","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/models","href":"/api-reference/modelservice/list-models"},{"title":"Get a model by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/models/{id}","href":"/api-reference/modelservice/get-a-model-by-id"},{"title":"Enable a model","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/models/{id}:enable","href":"/api-reference/modelservice/enable-a-model"},{"title":"Disable a model","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/models/{id}:disable","href":"/api-reference/modelservice/disable-a-model"},{"title":"Swap models on agent variations","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/models:swapModelOnVariations","href":"/api-reference/modelservice/swap-models-on-agent-variations"}]},{"group":"Uploads","pages":[{"title":"Create an upload","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/uploads","href":"/api-reference/uploadservice/create-an-upload"},{"title":"Get an upload by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/uploads/{id}","href":"/api-reference/uploadservice/get-an-upload-by-id"}]},{"group":"Workspaces","pages":[{"title":"List workspaces","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces","href":"/api-reference/workspaceservice/list-workspaces"}]},{"group":"Workspace Secrets","pages":[{"title":"List workspace secrets","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/workspace_secrets","href":"/api-reference/workspacesecretservice/list-workspace-secrets"},{"title":"Create a new workspace secret","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/workspace_secrets","href":"/api-reference/workspacesecretservice/create-a-new-workspace-secret"},{"title":"Get a workspace secret by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/workspace_secrets/{id}","href":"/api-reference/workspacesecretservice/get-a-workspace-secret-by-id"},{"title":"Delete a workspace secret","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/workspace_secrets/{id}","href":"/api-reference/workspacesecretservice/delete-a-workspace-secret"},{"title":"Update a workspace secret","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/workspace_secrets/{id}","href":"/api-reference/workspacesecretservice/update-a-workspace-secret"}]},{"group":"Workspace Admin","pages":[{"title":"Search account profiles","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/account/profiles","href":"/api-reference/workspaceadminservice/search-account-profiles"},{"title":"List all workspaces in the account","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/account/workspaces","href":"/api-reference/workspaceadminservice/list-all-workspaces-in-the-account"},{"title":"Create a workspace","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account/workspaces","href":"/api-reference/workspaceadminservice/create-a-workspace"},{"title":"Get a workspace by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/account/workspaces/{workspaceId}","href":"/api-reference/workspaceadminservice/get-a-workspace-by-id"},{"title":"Archive a workspace","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/account/workspaces/{workspaceId}","href":"/api-reference/workspaceadminservice/archive-a-workspace"},{"title":"Update a workspace","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/account/workspaces/{workspaceId}","href":"/api-reference/workspaceadminservice/update-a-workspace"},{"title":"List workspace members","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/account/workspaces/{workspaceId}/members","href":"/api-reference/workspaceadminservice/list-workspace-members"},{"title":"Add a member to a workspace","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account/workspaces/{workspaceId}/members","href":"/api-reference/workspaceadminservice/add-a-member-to-a-workspace"},{"title":"Remove a member from a workspace","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/account/workspaces/{workspaceId}/members/{profileId}","href":"/api-reference/workspaceadminservice/remove-a-member-from-a-workspace"}]},{"group":"Accounts","pages":[{"title":"Retrieves the current account for the token accessing the API","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/account","href":"/api-reference/accountservice/retrieves-the-current-account-for-the-token-accessing-the-api"},{"title":"Retrieves the profile for the credentials accessing the API","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/whoami","href":"/api-reference/profilesservice/retrieves-the-profile-for-the-credentials-accessing-the-api"},{"title":"Rotates the webhook signing key for the account","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account:rotateWebhookSigningKey","href":"/api-reference/accountservice/rotates-the-webhook-signing-key-for-the-account"},{"title":"Rotates the challenge token for the account","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account:rotateChallengeToken","href":"/api-reference/accountservice/rotates-the-challenge-token-for-the-account"}]},{"group":"API Keys","pages":[{"title":"List API keys","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/account/api_keys","href":"/api-reference/apikeyservice/list-api-keys"},{"title":"Create a new API key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account/api_keys","href":"/api-reference/apikeyservice/create-a-new-api-key"},{"title":"Get an API key by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/account/api_keys/{id}","href":"/api-reference/apikeyservice/get-an-api-key-by-id"},{"title":"Update an API key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/account/api_keys/{id}","href":"/api-reference/apikeyservice/update-an-api-key"},{"title":"Delete an API key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/account/api_keys/{id}","href":"/api-reference/apikeyservice/delete-an-api-key"},{"title":"Rotate an API key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account/api_keys/{id}:rotate","href":"/api-reference/apikeyservice/rotate-an-api-key"},{"title":"Disable an API key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account/api_keys/{id}:disable","href":"/api-reference/apikeyservice/disable-an-api-key"},{"title":"Enable an API key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account/api_keys/{id}:enable","href":"/api-reference/apikeyservice/enable-an-api-key"},{"title":"Assign a workspace to an API key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account/api_keys/{id}:addWorkspace","href":"/api-reference/apikeyservice/assign-a-workspace-to-an-api-key"},{"title":"Remove a workspace from an API key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account/api_keys/{id}:removeWorkspace","href":"/api-reference/apikeyservice/remove-a-workspace-from-an-api-key"},{"title":"Reveal an API key's token","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/account/api_keys/{id}:reveal","href":"/api-reference/apikeyservice/reveal-an-api-keys-token"}]},{"group":"AI Provider Keys","pages":[{"title":"List AI provider keys","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/ai_provider_keys","href":"/api-reference/aiproviderkeyservice/list-ai-provider-keys"},{"title":"Create a new AI provider key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml post /v1/workspaces/{workspaceId}/ai_provider_keys","href":"/api-reference/aiproviderkeyservice/create-a-new-ai-provider-key"},{"title":"Get an AI provider key by ID","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml get /v1/workspaces/{workspaceId}/ai_provider_keys/{id}","href":"/api-reference/aiproviderkeyservice/get-an-ai-provider-key-by-id"},{"title":"Update an AI provider key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml patch /v1/workspaces/{workspaceId}/ai_provider_keys/{id}","href":"/api-reference/aiproviderkeyservice/update-an-ai-provider-key"},{"title":"Delete an AI provider key","deprecated":null,"version":null,"openapi":"https://openapi.cadenya.com/api-spec.yml delete /v1/workspaces/{workspaceId}/ai_provider_keys/{id}","href":"/api-reference/aiproviderkeyservice/delete-an-ai-provider-key"}]},{"group":"Webhook Events","pages":[{"title":"Webhook events","sidebarTitle":"Overview","href":"/api-reference/webhook-events"},{"title":"User message","sidebarTitle":"User message","href":"/api-reference/objective-user-message-event"},{"title":"Assistant message","sidebarTitle":"Assistant message","href":"/api-reference/objective-assistant-message-event"},{"title":"Tool called","sidebarTitle":"Tool called","href":"/api-reference/objective-tool-called-event"},{"title":"Tool result","sidebarTitle":"Tool result","href":"/api-reference/objective-tool-result-event"},{"title":"Tool approval requested","sidebarTitle":"Tool approval requested","href":"/api-reference/objective-tool-approval-requested-event"},{"title":"Tool approved","sidebarTitle":"Tool approved","href":"/api-reference/objective-tool-approved-event"},{"title":"Tool denied","sidebarTitle":"Tool denied","href":"/api-reference/objective-tool-denied-event"},{"title":"Tool error","sidebarTitle":"Tool error","href":"/api-reference/objective-tool-error-event"},{"title":"Sub-agent spawned","sidebarTitle":"Sub-agent spawned","href":"/api-reference/objective-sub-agent-spawned-event"},{"title":"Sub-agent updated","sidebarTitle":"Sub-agent updated","href":"/api-reference/objective-sub-agent-updated-event"},{"title":"Memory read","sidebarTitle":"Memory read","href":"/api-reference/objective-memory-read-event"},{"title":"Reasoning","sidebarTitle":"Reasoning","href":"/api-reference/objective-reasoning-event"},{"title":"Objective finalized","sidebarTitle":"Objective finalized","href":"/api-reference/objective-finalized-event"},{"title":"Error","sidebarTitle":"Error","href":"/api-reference/objective-error-event"}]}]},{"tab":"Widgets API","icon":"comments","pages":[{"title":"Widgets API","href":"/widgets-api-reference"}]}]},"basePath":"","title":"Create a new tool - Cadenya","deploymentId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","buildId":"dpl_81ettUQ5G7NASN425B6JKU3FX1Rg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-GKHRyhW5.js","utils-CXMoydtj.js","cloneDeep-Cl7CR73B.js","_Uint8Array-7sQhd3aE.js","isObject-FP1Yky1u.js","utils-ABJ_F6Yn.js","addUniqueKeysToSchema-B7v39GOQ.js","snippetPresets-CgibLHmh.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-C2n3VqMC.js","isEqual-BKe3Q7nP.js","usePlaygroundInputsStore-Iji6acs6.js","shallow-Db9K5ulX.js","getApiPlaygroundDisplay-BGnJQBSj.js","CodeSnippet-DlQqWRja.js","CodeSnippets-JF3Bj6-U.js","Page-Ctn-BHcp.js","getPastedJson-B0pIrOza.js","icon-UPBYC1Wr.js","MethodPill-CoVRW5MG.js","DuplicateIcon-BuNnsqwg.js","createIcon-Cj9cJegl.js","DynamicMarkdown-C_R66tyH.js","SectionHeading-C6RB-y9f.js","axios-vUo_bRtp.js","Markdown-g2PbGssl.js","dist-DbZ3bm7k.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-BGnit25E.js"]}