Returns a single tool by its tool_id. Works for both user-owned tools and built-in system tools. Secret fields (token, password, value, secret, client_secret) are replaced with ******** in the response.
GET
/
v2
/
tools
/
{tool_id}
Get Tool
curl --request GET \ --url https://tavusapi.com/v2/tools/{tool_id} \ --header 'x-api-key: <api-key>'
How the tool call is dispatched. Exactly one channel must be enabled:
app_message: true alone - the call is delivered to your frontend over the Daily data channel as a conversation.tool_call event.
api set with app_message: false - Tavus makes an HTTPS request to api.url.
If delivery is omitted on create, the default is { "app_message": true }.
Show child attributes
is_system_tool
boolean
Whether this is a built-in system tool. System tools cannot be modified or deleted.
Example:
false
trigger_type
enum<string>
When the tool runs. post_call tools execute server-side after the conversation ends via delivery.api (HTTPS webhook).
Available options:
in_call,
post_call
Example:
"in_call"
origin
enum<string> | null
Live modality for in-call tools. screen identifies Raven-2 shared-screen tools. Null for post-call tools.
Available options:
llm,
vision,
screen,
audio
Example:
"llm"
on_call
enum<string> | null
What the PAL does while the tool call is in flight. Always null for perception tools.
Available options:
generate_filler,
static_filler,
silent,
passthrough
Example:
"generate_filler"
on_resolve
enum<string> | null
What the PAL does after the tool returns.
Available options:
generate_response,
response_in_result,
add_to_context,
fire_and_forget
Example:
"generate_response"
static_filler
string | null
Phrase the PAL speaks while the tool call is in flight. Set when on_call is static_filler.
Example:
"Sure, let me grab that for you."
created_at
string
ISO 8601 timestamp of when the tool was created.
Example:
"2026-05-15T10:30:00"
updated_at
string
ISO 8601 timestamp of when the tool was last updated.
Example:
"2026-05-15T10:30:00"
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tavus","colors":{"primary":"#FA3862","light":"#FA3862","dark":"#FA3862"},"logo":{"light":"https://mintcdn.com/tavus/mlBBb4gkXXhWTLQi/logo/light_logo.png?fit=max\u0026auto=format\u0026n=mlBBb4gkXXhWTLQi\u0026q=85\u0026s=892e020f9d0afc49e64011dcae9d3dd6","dark":"https://mintcdn.com/tavus/mlBBb4gkXXhWTLQi/logo/dark_logo.png?fit=max\u0026auto=format\u0026n=mlBBb4gkXXhWTLQi\u0026q=85\u0026s=1268f09533ab55791e8ef8200d4a669f"},"favicon":{"light":"https://mintcdn.com/tavus/yC-TYEqHye998xbI/favicon_light.png?fit=max\u0026auto=format\u0026n=yC-TYEqHye998xbI\u0026q=85\u0026s=25642e844d8f4aaad82e6cb0d0cf44c3","dark":"https://mintcdn.com/tavus/yC-TYEqHye998xbI/favicon_dark.png?fit=max\u0026auto=format\u0026n=yC-TYEqHye998xbI\u0026q=85\u0026s=42861da3c81323c222cd6182eee43175"},"api":{"openapi":"openapi.yaml"},"navbar":{"links":[{"href":"https://discord.gg/5Y9Er6WNN5","label":"Community"},{"href":"https://status.tavus.io","label":"Status"},{"href":"mailto:support@tavus.io","label":"Get Support"}],"primary":{"type":"button","label":"Get Started","href":"https://maker.tavus.io/auth/sign-up?is_developer=true"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/tavus-io","discord":"https://discord.gg/5Y9Er6WNN5"}},"integrations":{"ga4":{"measurementId":"G-SBQHZWT4FS"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","mcp"],"display":"header"},"interaction":{"drilldown":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tavus","hasAudioNarration":false,"actualSubdomain":"tavus","customDomains":["docs.tavus.io"],"gitSource":{"type":"github","owner":"tavus-engineering","repo":"platform-api-developer-documentation","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af3e848c8b2b73a8df981df","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"CVI","count":138},{"language":"default","tag":"Build","count":93},{"language":"default","tag":"API","count":90},{"language":"default","tag":"Skills","count":27},{"language":"default","tag":"Deploy","count":23},{"language":"default","tag":"Interaction Events","count":21},{"language":"default","tag":"Face","count":20},{"language":"default","tag":"Magic Canvas","count":17},{"language":"default","tag":"Tools","count":14},{"language":"default","tag":"PAL","count":14}]},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/tools/get-tool","slug":"/api-reference/tools/get-tool","pageMetadata":{"openapi":"get /v2/tools/{tool_id}","title":"Get Tool","description":"Returns a single tool by its `tool_id`. Works for both user-owned tools and built-in system tools. Secret fields (`token`, `password`, `value`, `secret`, `client_secret`) are replaced with `********` in the response.","href":"/api-reference/tools/get-tool"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns a single tool by its \", _jsx(_components.code, {\n children: \"tool_id\"\n }), \". Works for both user-owned tools and built-in system tools. Secret fields (\", _jsx(_components.code, {\n children: \"token\"\n }), \", \", _jsx(_components.code, {\n children: \"password\"\n }), \", \", _jsx(_components.code, {\n children: \"value\"\n }), \", \", _jsx(_components.code, {\n children: \"secret\"\n }), \", \", _jsx(_components.code, {\n children: \"client_secret\"\n }), \") are replaced with \", _jsx(_components.code, {\n children: \"********\"\n }), \" in the response.\"]\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":{"openapi":"get /v2/tools/{tool_id}","title":"Get Tool","description":"Returns a single tool by its `tool_id`. Works for both user-owned tools and built-in system tools. Secret fields (`token`, `password`, `value`, `secret`, `client_secret`) are replaced with `********` in the response.","href":"/api-reference/tools/get-tool"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Tools"],"summary":"Get Tool","description":"Returns a single tool by its `tool_id`. Works for both user-owned tools and built-in system tools. Secret fields (`token`, `password`, `value`, `secret`, `client_secret`) are replaced with `********` in the response.","operationId":"getTool","responses":{"200":"7a95f2e7-77ba-4e15-a63a-09ce2f1bb3c4","400":"c15272c0-1517-4e33-a9cf-e72d0fb74335","401":"dfb675f9-e4eb-42ca-98b2-baffda75e6a2"},"security":["226500e7-15c3-4b63-af13-696381a1a6b2"],"method":"get","type":"path","servers":["85d71bf2-5e1e-463b-9ae5-3e0bd738f356"],"path":"/v2/tools/{tool_id}","baseUrlOptions":["https://tavusapi.com"],"title":"Get Tool","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"70fe69d9-0eac-40b2-a3dc-d9c1fe4d0443":{"name":"tool_id","in":"path","required":true,"description":"The unique identifier of the tool. For system tools this is the tool's `name` (e.g. `end_call`).","schema":{"type":"string","example":"tabc123def456","isRequired":true,"description":"The unique identifier of the tool. For system tools this is the tool's `name` (e.g. `end_call`).","uniqueKey":"","typeLabel":"string"}}},"responses":{"7a95f2e7-77ba-4e15-a63a-09ce2f1bb3c4":{"description":"Tool returned","content":{"application/json":{"schema":{"type":"object","description":"A standalone tool definition. Returned by every tool endpoint and embedded in the `data` array of the PAL-tool endpoints.","properties":{"tool_id":{"type":"string","description":"Unique identifier for the tool. System tools use their `name` as the `tool_id` (e.g. `end_call`).","example":"tabc123def456","uniqueKey":"tool_id","typeLabel":"string"},"owner_id":{"oneOf":[{"type":"integer","description":"Internal user ID that owns the tool. `null` for built-in system tools.","example":3675,"uniqueKey":"owner_id.oneOf.0","typeLabel":"integer"},{"type":"null","description":"Internal user ID that owns the tool. `null` for built-in system tools.","example":3675,"uniqueKey":"owner_id.oneOf.1","typeLabel":"null"}],"uniqueKey":"owner_id","typeLabel":"integer | null"},"name":{"type":"string","description":"Function name the LLM uses to call the tool.","example":"get_weather","uniqueKey":"name","typeLabel":"string"},"description":{"type":"string","description":"Natural-language description of the tool.","example":"Get the current weather for a city","uniqueKey":"description","typeLabel":"string"},"parameters":{"type":"object","description":"JSON Schema describing the tool's arguments.","example":{"type":"object","properties":{"city":{"type":"string","description":"City name"}},"required":["city"]},"uniqueKey":"parameters","typeLabel":"object"},"delivery":{"type":"object","description":"How the tool call is dispatched. Exactly one channel must be enabled:\n\n- `app_message: true` alone - the call is delivered to your frontend over the Daily data channel as a `conversation.tool_call` event.\n- `api` set with `app_message: false` - Tavus makes an HTTPS request to `api.url`.\n\nIf `delivery` is omitted on create, the default is `{ \"app_message\": true }`.\n","properties":{"app_message":{"type":"boolean","default":true,"description":"Set to `true` to deliver tool calls to your frontend as `conversation.tool_call` events. Mutually exclusive with `api`.","uniqueKey":"delivery.app_message","typeLabel":"boolean"},"api":{"type":"object","required":["url"],"description":"HTTPS request configuration for tool calls delivered via API.","properties":{"url":{"type":"string","description":"HTTPS URL Tavus calls. Must use `https://`. Hostname must not point at private / loopback / link-local / metadata-server IP space and must not contain `{placeholder}` substitutions - placeholders are only resolved in the path, query string, and body.\n","example":"https://api.example.com/v1/weather/{city}","isRequired":true,"uniqueKey":"delivery.api.url","typeLabel":"string"},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE","HEAD"],"default":"POST","description":"HTTP method. `GET`, `HEAD`, and `DELETE` reject `body_template`.","uniqueKey":"delivery.api.method","typeLabel":"enum\u003cstring>"},"timeout":{"type":"number","minimum":0,"exclusiveMinimum":true,"maximum":60,"default":10,"description":"Request timeout in seconds. Must be greater than 0 and at most 60. Default 10.","uniqueKey":"delivery.api.timeout","typeLabel":"number"},"headers":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"delivery.api.headers.additionalProperties","typeLabel":"string"},"description":"Static HTTP headers sent with every request. Keys and values must be strings.","example":{"X-Service":"weather-bot"},"uniqueKey":"delivery.api.headers","typeLabel":"object"},"auth":{"type":"object","required":["type"],"description":"Outbound authentication for API delivery. The required fields depend on `type`:\n\n- `none` - no auth.\n- `bearer` - `token` is sent as `Authorization: Bearer \u003ctoken>`.\n- `basic` - `username` + `password` are encoded into `Authorization: Basic ...`.\n- `api_key` - `name` + `value` are sent as a header (`location: header`, default) or query parameter (`location: query`).\n- `hmac` - `secret` signs a fixed Tavus envelope body with HMAC-SHA256; the signature is sent in the `X-Tavus-Signature` header. HMAC mode ignores `body_template`, `query_params`, and URL placeholders.\n- `oauth2_client_credentials` - Tavus does a client-credentials exchange against `token_url` using `client_id` + `client_secret` (and optional `scope`) and uses the returned bearer token to call the tool URL.\n\nOn response, all secret fields (`token`, `password`, `value`, `secret`, `client_secret`) are scrubbed to `********`. Echoing that back on PATCH is rejected; omit the field instead to keep the stored secret.\n","properties":{"type":{"type":"string","enum":["none","bearer","basic","api_key","hmac","oauth2_client_credentials"],"description":"Auth strategy.","isRequired":true,"uniqueKey":"delivery.api.auth.type","typeLabel":"enum\u003cstring>"},"token":{"type":"string","description":"Bearer token. Required when `type=bearer`.","uniqueKey":"delivery.api.auth.token","typeLabel":"string"},"username":{"type":"string","description":"HTTP Basic username. Required when `type=basic`.","uniqueKey":"delivery.api.auth.username","typeLabel":"string"},"password":{"type":"string","description":"HTTP Basic password. Required when `type=basic`.","uniqueKey":"delivery.api.auth.password","typeLabel":"string"},"name":{"type":"string","description":"API key header / query parameter name. Required when `type=api_key`.","example":"X-API-Key","uniqueKey":"delivery.api.auth.name","typeLabel":"string"},"value":{"type":"string","description":"API key value. Required when `type=api_key`.","uniqueKey":"delivery.api.auth.value","typeLabel":"string"},"location":{"type":"string","enum":["header","query"],"default":"header","description":"Where the API key is sent. Used only when `type=api_key`.","uniqueKey":"delivery.api.auth.location","typeLabel":"enum\u003cstring>"},"secret":{"type":"string","description":"HMAC shared secret. Required when `type=hmac`.","uniqueKey":"delivery.api.auth.secret","typeLabel":"string"},"token_url":{"type":"string","description":"OAuth2 token endpoint. Must use HTTPS and pass the same SSRF rules as the tool URL. Required when `type=oauth2_client_credentials`.","example":"https://auth.example.com/oauth/token","uniqueKey":"delivery.api.auth.token_url","typeLabel":"string"},"client_id":{"type":"string","description":"OAuth2 client ID. Required when `type=oauth2_client_credentials`.","uniqueKey":"delivery.api.auth.client_id","typeLabel":"string"},"client_secret":{"type":"string","description":"OAuth2 client secret. Required when `type=oauth2_client_credentials`.","uniqueKey":"delivery.api.auth.client_secret","typeLabel":"string"},"scope":{"type":"string","description":"Optional OAuth2 scope string. Used only when `type=oauth2_client_credentials`.","uniqueKey":"delivery.api.auth.scope","typeLabel":"string"}},"uniqueKey":"delivery.api.auth","typeLabel":"object"},"body_template":{"type":"object","description":"Optional JSON object used as the request body. String values support `{placeholder}` substitutions referencing keys declared in the tool's `parameters.properties`. Rejected when `method` is `GET`, `HEAD`, or `DELETE`, and ignored when `auth.type` is `hmac` (which uses a fixed Tavus envelope).","uniqueKey":"delivery.api.body_template","typeLabel":"object"},"query_params":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"delivery.api.query_params.additionalProperties","typeLabel":"string"},"description":"Static query parameters appended to the URL. Keys and values must be strings; values support `{placeholder}` substitutions. Ignored when `auth.type` is `hmac`.","example":{"units":"metric"},"uniqueKey":"delivery.api.query_params","typeLabel":"object"},"content_type":{"type":"string","description":"Override the request `Content-Type` header. Defaults to `application/json` when not set.","example":"application/json","uniqueKey":"delivery.api.content_type","typeLabel":"string"}},"uniqueKey":"delivery.api","typeLabel":"object"}},"uniqueKey":"delivery","typeLabel":"object"},"is_system_tool":{"type":"boolean","description":"Whether this is a built-in system tool. System tools cannot be modified or deleted.","example":false,"uniqueKey":"is_system_tool","typeLabel":"boolean"},"trigger_type":{"type":"string","enum":["in_call","post_call"],"description":"When the tool runs. `post_call` tools execute server-side after the conversation ends via `delivery.api` (HTTPS webhook).","example":"in_call","uniqueKey":"trigger_type","typeLabel":"enum\u003cstring>"},"origin":{"oneOf":[{"type":"string","enum":["llm","vision","screen","audio"],"description":"Live modality for in-call tools. `screen` identifies Raven-2 shared-screen tools. Null for post-call tools.","example":"llm","uniqueKey":"origin.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["llm","vision","screen","audio"],"description":"Live modality for in-call tools. `screen` identifies Raven-2 shared-screen tools. Null for post-call tools.","example":"llm","uniqueKey":"origin.oneOf.1","typeLabel":"null"}],"uniqueKey":"origin","typeLabel":"enum\u003cstring> | null"},"on_call":{"oneOf":[{"type":"string","enum":["generate_filler","static_filler","silent","passthrough"],"description":"What the PAL does while the tool call is in flight. Always null for perception tools.","example":"generate_filler","uniqueKey":"on_call.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["generate_filler","static_filler","silent","passthrough"],"description":"What the PAL does while the tool call is in flight. Always null for perception tools.","example":"generate_filler","uniqueKey":"on_call.oneOf.1","typeLabel":"null"}],"uniqueKey":"on_call","typeLabel":"enum\u003cstring> | null"},"on_resolve":{"oneOf":[{"type":"string","enum":["generate_response","response_in_result","add_to_context","fire_and_forget"],"description":"What the PAL does after the tool returns.","example":"generate_response","uniqueKey":"on_resolve.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["generate_response","response_in_result","add_to_context","fire_and_forget"],"description":"What the PAL does after the tool returns.","example":"generate_response","uniqueKey":"on_resolve.oneOf.1","typeLabel":"null"}],"uniqueKey":"on_resolve","typeLabel":"enum\u003cstring> | null"},"static_filler":{"oneOf":[{"type":"string","description":"Phrase the PAL speaks while the tool call is in flight. Set when `on_call` is `static_filler`.","example":"Sure, let me grab that for you.","uniqueKey":"static_filler.oneOf.0","typeLabel":"string"},{"type":"null","description":"Phrase the PAL speaks while the tool call is in flight. Set when `on_call` is `static_filler`.","example":"Sure, let me grab that for you.","uniqueKey":"static_filler.oneOf.1","typeLabel":"null"}],"uniqueKey":"static_filler","typeLabel":"string | null"},"created_at":{"type":"string","description":"ISO 8601 timestamp of when the tool was created.","example":"2026-05-15T10:30:00","uniqueKey":"created_at","typeLabel":"string"},"updated_at":{"type":"string","description":"ISO 8601 timestamp of when the tool was last updated.","example":"2026-05-15T10:30:00","uniqueKey":"updated_at","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"tool_id":"tabc123def456","owner_id":3675,"name":"get_weather","description":"Get the current weather for a city","parameters":{"type":"object","properties":{"city":{"type":"string","description":"City name"}},"required":["city"]},"delivery":{"app_message":true,"api":{"url":"https://api.example.com/v1/weather/{city}","method":"POST","timeout":10,"headers":{"X-Service":"weather-bot"},"auth":{"type":"none","token":"\u003cstring>","username":"\u003cstring>","password":"\u003cstring>","name":"X-API-Key","value":"\u003cstring>","location":"header","secret":"\u003cstring>","token_url":"https://auth.example.com/oauth/token","client_id":"\u003cstring>","client_secret":"\u003cstring>","scope":"\u003cstring>"},"body_template":{},"query_params":{"units":"metric"},"content_type":"application/json"}},"is_system_tool":false,"trigger_type":"in_call","origin":"llm","on_call":"generate_filler","on_resolve":"generate_response","static_filler":"Sure, let me grab that for you.","created_at":"2026-05-15T10:30:00","updated_at":"2026-05-15T10:30:00"}}},"exampleType":"generated"}},"exampleType":"generated"},"c15272c0-1517-4e33-a9cf-e72d0fb74335":{"description":"Tool not found","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","example":"Bad Request. Tool not found","uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Bad Request. Tool not found"}}},"exampleType":"generated"}},"exampleType":"generated"},"dfb675f9-e4eb-42ca-98b2-baffda75e6a2":{"description":"Unauthorized","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","example":"Invalid access token","uniqueKey":"message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"Invalid access token"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"226500e7-15c3-4b63-af13-696381a1a6b2":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKey"}}},"servers":{"85d71bf2-5e1e-463b-9ae5-3e0bd738f356":{"url":"https://tavusapi.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"tavus","siteName":"Tavus","title":"Get Tool - Tavus","contextualStarterQuestions":[{"_id":"6a3ecac8d80e0e9f33107a3a","deploymentId":"65baa7516ce8cd46ab1aa877","questionText":"Can I access built-in tools?","status":"active","generatedBy":"contextual","path":"api-reference/tools/get-tool","createdAt":"2026-06-26T18:54:00.559Z","updatedAt":"2026-06-26T18:54:00.559Z","__v":0},{"_id":"6a3ecac8d80e0e9f33107a39","deploymentId":"65baa7516ce8cd46ab1aa877","questionText":"What data is hidden in responses?","status":"active","generatedBy":"contextual","path":"api-reference/tools/get-tool","createdAt":"2026-06-26T18:54:00.559Z","updatedAt":"2026-06-26T18:54:00.559Z","__v":0},{"_id":"6a3ecac8d80e0e9f33107a38","deploymentId":"65baa7516ce8cd46ab1aa877","questionText":"How do I retrieve a tool by ID?","status":"active","generatedBy":"contextual","path":"api-reference/tools/get-tool","createdAt":"2026-06-26T18:54:00.559Z","updatedAt":"2026-06-26T18:54:00.559Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-26T18:51:25.249Z","originalFileLocation":"api-reference/tools/get-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=\"Returns a single tool by its tool_id. Works for both user-owned tools and built-in system tools. Secret fields (token, password, value, secret, client_secret) are replaced with ******** in the response.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tavus\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tavus/Gv5r0opZCeHlefXw/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/tavus/Gv5r0opZCeHlefXw/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tavus/Gv5r0opZCeHlefXw/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tavus/Gv5r0opZCeHlefXw/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tavus/Gv5r0opZCeHlefXw/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tavus/Gv5r0opZCeHlefXw/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tavus/Gv5r0opZCeHlefXw/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/tavus/Gv5r0opZCeHlefXw/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/tavus/Gv5r0opZCeHlefXw/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Tool - Tavus\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a single tool by its tool_id. Works for both user-owned tools and built-in system tools. Secret fields (token, password, value, secret, client_secret) are replaced with ******** in the response.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tavus\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.tavus.io/api-reference/tools/get-tool\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tavus.mintlify.site/_mintlify/api/og/v2?division=Tools\u0026amp;title=Get+Tool\u0026amp;description=Returns+a+single+tool+by+its+%60tool_id%60.+Works+for+both+user-owned+tools+and+built-in+system+tools.+Secret+fields+%28%60token%60%2C+%60password%60%2C+%60value%60%2C+%60secret%60%2C+%60clien\u0026amp;theme=abfefcbacd6b71a9185f0e19\u0026amp;signature=a0634d99b1632949e82ce5ea4830860be26b39f5f470c1dc74ce18c12236b0a7\">\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=\"Get Tool - Tavus\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a single tool by its tool_id. Works for both user-owned tools and built-in system tools. Secret fields (token, password, value, secret, client_secret) are replaced with ******** in the response.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tavus.mintlify.site/_mintlify/api/og/v2?division=Tools\u0026amp;title=Get+Tool\u0026amp;description=Returns+a+single+tool+by+its+%60tool_id%60.+Works+for+both+user-owned+tools+and+built-in+system+tools.+Secret+fields+%28%60token%60%2C+%60password%60%2C+%60value%60%2C+%60secret%60%2C+%60clien\u0026amp;theme=abfefcbacd6b71a9185f0e19\u0026amp;signature=a0634d99b1632949e82ce5ea4830860be26b39f5f470c1dc74ce18c12236b0a7\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/tavus/Gv5r0opZCeHlefXw/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tavus\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FA3862\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.tavus.io/api-reference/tools/get-tool\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tools/get-tool.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.tavus.io/#organization\",\"name\":\"Tavus\",\"url\":\"https://docs.tavus.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tavus/mlBBb4gkXXhWTLQi/logo/light_logo.png?fit=max\u0026auto=format\u0026n=mlBBb4gkXXhWTLQi\u0026q=85\u0026s=892e020f9d0afc49e64011dcae9d3dd6\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.tavus.io#website\",\"name\":\"Tavus\",\"url\":\"https://docs.tavus.io\",\"publisher\":{\"@id\":\"https://docs.tavus.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.tavus.io/api-reference/tools/get-tool#webpage\",\"url\":\"https://docs.tavus.io/api-reference/tools/get-tool\",\"name\":\"Get Tool\",\"description\":\"Returns a single tool by its tool_id. Works for both user-owned tools and built-in system tools. Secret fields (token, password, value, secret, client_secret) are replaced with ******** in the response.\",\"dateModified\":\"2026-06-26T18:51:25.249Z\",\"isPartOf\":{\"@id\":\"https://docs.tavus.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.tavus.io/api-reference/tools/get-tool#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.tavus.io/api-reference/tools/get-tool#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Tools\",\"item\":\"https://docs.tavus.io/api-reference/tools/create-tool\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Tool\",\"item\":\"https://docs.tavus.io/api-reference/tools/get-tool\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.tavus.io/api-reference/tools/get-tool#apireference\",\"headline\":\"Get Tool\",\"name\":\"Get Tool\",\"description\":\"Returns a single tool by its tool_id. Works for both user-owned tools and built-in system tools. Secret fields (token, password, value, secret, client_secret) are replaced with ******** in the response.\",\"url\":\"https://docs.tavus.io/api-reference/tools/get-tool\",\"mainEntityOfPage\":{\"@id\":\"https://docs.tavus.io/api-reference/tools/get-tool#webpage\"},\"dateModified\":\"2026-06-26T18:51:25.249Z\",\"publisher\":{\"@id\":\"https://docs.tavus.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.tavus.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tavus\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tavus\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/tools/get-tool.md","siteName":"Tavus","nav":{"global":null,"tabs":[{"tab":"CVI","pages":[{"title":"CVI","href":"/sections/introduction"}]},{"tab":"API","groups":[{"group":"Introduction","pages":[{"title":"Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"}]},{"group":"Conversation","pages":[{"openapi":"post /v2/conversations","title":null,"href":"/api-reference/conversations/create-conversation"},{"openapi":"get /v2/conversations/{conversation_id}","title":"Get Conversation","href":"/api-reference/conversations/get-conversation"},{"openapi":"get /v2/conversations","title":"List Conversations","href":"/api-reference/conversations/get-conversations"},{"openapi":"post /v2/conversations/{conversation_id}/end","title":"End Conversation","href":"/api-reference/conversations/end-conversation"},{"openapi":"delete /v2/conversations/{conversation_id}","title":"Delete Conversation","href":"/api-reference/conversations/delete-conversation"}]},{"group":"PAL","pages":[{"openapi":"post /v2/pals","title":"Create PAL","href":"/api-reference/pals/create-pal"},{"openapi":"get /v2/pals/{pal_id}","title":"Get PAL","href":"/api-reference/pals/get-pal"},{"openapi":"get /v2/pals","title":"List PALs","href":"/api-reference/pals/list-pals"},{"openapi":"patch /v2/pals/{pal_id}","title":"Patch PAL","href":"/api-reference/pals/patch-pal"},{"title":"Publish PAL","sidebarTitle":"Publish PAL (removed)","href":"/api-reference/pals/publish-pal"},{"openapi":"delete /v2/pals/{pal_id}","title":"Delete PAL","href":"/api-reference/pals/delete-pal"},{"openapi":"get /v2/pals/check-username","title":"Check Conferencing Username Availability","href":"/api-reference/pals/check-conferencing-username"}]},{"group":"Face","pages":[{"openapi":"post /v2/faces","title":"Create Face","href":"/api-reference/faces/create-face"},{"openapi":"post /v2/faces/image-validation","title":"Validate Face Image","href":"/api-reference/faces/validate-face-image"},{"openapi":"get /v2/faces/{face_id}","title":"Get Face","href":"/api-reference/faces/get-face"},{"openapi":"get /v2/faces","title":"List Faces","href":"/api-reference/faces/list-faces"},{"openapi":"patch /v2/faces/{face_id}","title":"Update Face","href":"/api-reference/faces/update-face"},{"openapi":"delete /v2/faces/{face_id}","title":"Delete Face","href":"/api-reference/faces/delete-face"}]},{"group":"Voices","pages":[{"openapi":"post /v2/voices","title":"Create Voice","href":"/api-reference/voices/create-voice"},{"openapi":"get /v2/voices/{voice_id}","title":"Get Voice","href":"/api-reference/voices/get-voice"},{"openapi":"get /v2/voices","title":"List Voices","href":"/api-reference/voices/list-voices"},{"openapi":"patch /v2/voices/{voice_id}","title":"Update Voice","href":"/api-reference/voices/update-voice"},{"openapi":"delete /v2/voices/{voice_id}","title":"Delete Voice","href":"/api-reference/voices/delete-voice"}]},{"group":"Tools","pages":[{"openapi":"post /v2/tools","title":"Create Tool","href":"/api-reference/tools/create-tool"},{"openapi":"get /v2/tools","title":"Get Tools","description":"Returns a paginated list of tools. The `type` query parameter controls which tools are returned:\n\n- `type=user` (default) - tools you created via [Create Tool](/api-reference/tools/create-tool).\n- `type=system` - built-in system tools Tavus provides. These are always available to every conversation; you do not need to attach them. The only system tool today is `end_call`, which lets the PAL hang up at a natural stopping point.\n- `type=all` - both, with system tools listed first.\n\nSystem tools have `is_system_tool: true`, an `owner_id` of `null`, and use their `name` as the `tool_id` (e.g. `end_call`). They cannot be created, updated, or deleted.\n","href":"/api-reference/tools/get-tools"},{"openapi":"get /v2/tools/{tool_id}","title":"Get Tool","href":"/api-reference/tools/get-tool"},{"openapi":"patch /v2/tools/{tool_id}","title":"Update Tool","description":"Update one or more fields on a tool. Only fields present in the body are changed; omitted fields keep their stored value. System tools cannot be updated.\n\n**Secrets and the `********` placeholder.** [Get Tool](/api-reference/tools/get-tool) returns secret fields scrubbed to `********`. If you do a read-modify-write and PATCH that exact value back, the request is rejected - re-encrypting the placeholder would silently corrupt the stored secret. To keep the existing secret, **omit** the field from the auth object on PATCH.\n\nSending `delivery: null` resets delivery to the default `{ app_message: true }`.\n","href":"/api-reference/tools/update-tool"},{"openapi":"delete /v2/tools/{tool_id}","title":"Delete Tool","href":"/api-reference/tools/delete-tool"},{"openapi":"post /v2/pals/{pal_id}/tools","title":"Attach Tools To PAL","href":"/api-reference/pal-tools/attach-tools-to-pal"},{"openapi":"get /v2/pals/{pal_id}/tools","title":"List PAL Tools","href":"/api-reference/pal-tools/list-pal-tools"},{"openapi":"delete /v2/pals/{pal_id}/tools/{tool_id}","title":"Detach Tool From PAL","href":"/api-reference/pal-tools/detach-tool-from-pal"}]},{"group":"Connectors","pages":[{"openapi":"post /v2/connectors","title":"Create Connector","href":"/api-reference/connectors/create-connector"},{"openapi":"get /v2/connectors","title":"List Connectors","href":"/api-reference/connectors/list-connectors"},{"openapi":"get /v2/connectors/{connector_id}","title":"Get Connector","href":"/api-reference/connectors/get-connector"},{"openapi":"patch /v2/connectors/{connector_id}","title":"Update Connector","href":"/api-reference/connectors/update-connector"},{"openapi":"delete /v2/connectors/{connector_id}","title":"Delete Connector","href":"/api-reference/connectors/delete-connector"},{"openapi":"get /v2/connectors/{connector_id}/preview","title":"Preview Connector Tools","href":"/api-reference/connectors/preview-connector-tools"},{"openapi":"post /v2/connectors/{connector_id}/runtime_check","title":"Runtime Check Connector","href":"/api-reference/connectors/runtime-check-connector"},{"openapi":"post /v2/connectors/{connector_id}/oauth/reconnect","title":"Reconnect OAuth","href":"/api-reference/connectors/reconnect-connector-oauth"}]},{"group":"Skills","pages":[{"openapi":"get /v2/skills","title":"List Skills","href":"/api-reference/skills/list-skills"},{"openapi":"get /v2/skills/{skill_id}","title":"Get Skill","href":"/api-reference/skills/get-skill"},{"openapi":"get /v2/pals/{pal_id}/skills","title":"List PAL Skills","href":"/api-reference/pal-skills/list-pal-skills"},{"openapi":"get /v2/pals/{pal_id}/skills/{skill_id}","title":"Get PAL Skill","href":"/api-reference/pal-skills/get-pal-skill"},{"openapi":"put /v2/pals/{pal_id}/skills/{skill_id}","title":"Attach Skill to PAL","href":"/api-reference/pal-skills/attach-skill-to-pal"},{"openapi":"patch /v2/pals/{pal_id}/skills/{skill_id}","title":"Update PAL Skill","href":"/api-reference/pal-skills/update-pal-skill"},{"openapi":"delete /v2/pals/{pal_id}/skills/{skill_id}","title":"Detach Skill from PAL","href":"/api-reference/pal-skills/detach-skill-from-pal"},{"openapi":"put /v2/pals/{pal_id}/skills","title":"Replace PAL Skills","href":"/api-reference/pal-skills/replace-pal-skills"}]},{"group":"Memory Stores","pages":[{"group":"Store management","pages":[{"openapi":"post /v2/memory-stores","title":"Create Memory Store","href":"/api-reference/memory-stores/create-memory-store"},{"openapi":"get /v2/memory-stores","title":"List Memory Stores","href":"/api-reference/memory-stores/list-memory-stores"},{"openapi":"get /v2/memory-stores/{memory_store_id}","title":"Get Memory Store","href":"/api-reference/memory-stores/get-memory-store"},{"openapi":"delete /v2/memory-stores/{memory_store_id}","title":"Delete Memory Store","href":"/api-reference/memory-stores/delete-memory-store"}]},{"group":"Pinned memories","pages":[{"openapi":"post /v2/memory-stores/{memory_store_id}/pinned","title":"Create Pinned Memory","href":"/api-reference/memory-stores/create-pinned-memory"},{"openapi":"get /v2/memory-stores/{memory_store_id}/pinned","title":"List Pinned Memories","href":"/api-reference/memory-stores/list-pinned-memories"},{"openapi":"patch /v2/memory-stores/{memory_store_id}/pinned/{memory_id}","title":"Update Pinned Memory","href":"/api-reference/memory-stores/update-pinned-memory"},{"openapi":"delete /v2/memory-stores/{memory_store_id}/pinned/{memory_id}","title":"Delete Pinned Memory","href":"/api-reference/memory-stores/delete-pinned-memory"}]},{"group":"Learned memory","pages":[{"openapi":"get /v2/memory-stores/{memory_store_id}/learned","title":"Get Learned Memory","href":"/api-reference/memory-stores/get-learned-memory"},{"openapi":"delete /v2/memory-stores/{memory_store_id}/learned/profile","title":"Delete Learned Profile Memory","href":"/api-reference/memory-stores/delete-learned-profile-memory"},{"openapi":"delete /v2/memory-stores/{memory_store_id}/learned/timeline","title":"Delete Learned Timeline Memory","href":"/api-reference/memory-stores/delete-learned-timeline-memory"}]}]},{"group":"Magic Canvas","pages":[{"openapi":"post /v2/conversations/{conversation_id}/canvas/interactions","title":"Record Canvas Interaction","href":"/api-reference/canvas-interactions/record-canvas-interaction"},{"openapi":"get /v2/conversations/{conversation_id}/canvas/interactions","title":"List Canvas Interactions","href":"/api-reference/canvas-interactions/list-canvas-interactions"}]},{"group":"Objectives","pages":[{"openapi":"post /v2/objectives","title":"Create Objectives","href":"/api-reference/objectives/create-objectives"},{"openapi":"get /v2/objectives/{objectives_id}","title":"Get Objective","href":"/api-reference/objectives/get-objectives"},{"openapi":"get /v2/objectives","title":"Get Objectives","href":"/api-reference/objectives/get-objectives-list"},{"openapi":"patch /v2/objectives/{objectives_id}","title":"Patch Objective","href":"/api-reference/objectives/patch-objectives"},{"openapi":"delete /v2/objectives/{objectives_id}","title":"Delete Objective","href":"/api-reference/objectives/delete-objectives"}]},{"group":"Guardrails","pages":[{"openapi":"post /v2/guardrails","title":"Create Guardrails","href":"/api-reference/guardrails/create-guardrails"},{"openapi":"get /v2/guardrails/{guardrail_id}","title":"Get Guardrails","href":"/api-reference/guardrails/get-guardrails"},{"openapi":"get /v2/guardrails","title":"List Guardrails","href":"/api-reference/guardrails/list-guardrails"},{"openapi":"patch /v2/guardrails/{guardrail_id}","title":"Patch Guardrails","href":"/api-reference/guardrails/patch-guardrails"},{"openapi":"delete /v2/guardrails/{guardrail_id}","title":"Delete Guardrails","href":"/api-reference/guardrails/delete-guardrails"}]},{"group":"Knowledge Base","pages":[{"title":"Create Document","openapi":"post /v2/documents","href":"/api-reference/documents/create-document"},{"title":"Get Document","openapi":"get /v2/documents/{document_id}","href":"/api-reference/documents/get-document"},{"title":"List Documents","openapi":"get /v2/documents","href":"/api-reference/documents/get-documents"},{"title":"Delete Document","openapi":"delete /v2/documents/{document_id}","href":"/api-reference/documents/delete-document"},{"title":"Update Document","openapi":"patch /v2/documents/{document_id}","href":"/api-reference/documents/patch-document"},{"title":"Recrawl Document","openapi":"post /v2/documents/{document_id}/recrawl","href":"/api-reference/documents/recrawl-document"}]},{"group":"Pronunciation Dictionaries","pages":[{"openapi":"post /v2/pronunciation-dictionaries","title":"Create Pronunciation Dictionary","href":"/api-reference/pronunciation-dictionaries/create-pronunciation-dictionary"},{"openapi":"get /v2/pronunciation-dictionaries/{dictionary_id}","title":"Get Pronunciation Dictionary","href":"/api-reference/pronunciation-dictionaries/get-pronunciation-dictionary"},{"openapi":"get /v2/pronunciation-dictionaries","title":"List Pronunciation Dictionaries","href":"/api-reference/pronunciation-dictionaries/list-pronunciation-dictionaries"},{"openapi":"patch /v2/pronunciation-dictionaries/{dictionary_id}","title":"Update Pronunciation Dictionary","href":"/api-reference/pronunciation-dictionaries/update-pronunciation-dictionary"},{"openapi":"delete /v2/pronunciation-dictionaries/{dictionary_id}","title":"Delete Pronunciation Dictionary","href":"/api-reference/pronunciation-dictionaries/delete-pronunciation-dictionary"}]},{"group":"Deployments","pages":[{"openapi":"post /v2/deployments","title":"Create Deployment","href":"/api-reference/deployments/create-deployment"},{"openapi":"get /v2/deployments","title":"List Deployments","href":"/api-reference/deployments/list-deployments"},{"openapi":"get /v2/deployments/{deployment_id}","title":"Get Deployment","href":"/api-reference/deployments/get-deployment"},{"openapi":"patch /v2/deployments/{deployment_id}","title":"Patch Deployment","href":"/api-reference/deployments/patch-deployment"},{"openapi":"delete /v2/deployments/{deployment_id}","title":"Delete Deployment","href":"/api-reference/deployments/delete-deployment"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/sections/changelog/changelog"}]},{"tab":"Other Products","pages":[{"title":"Other Products","href":"/sections/video/overview"}]},{"tab":"Enablement Docs","hidden":true,"pages":[{"title":"Enablement Docs","href":"/sections/enablement-docs"}]}]},"basePath":"","title":"Get Tool - Tavus","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DdEMm2kG.js","utils-BMo572L7.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C-4m9KAx.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DPLK2Oq9.js","snippetPresets-BKjfJMC9.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-DTsgtCEj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C8vmhyQM.js","shallow-r9w8LQGS.js","getApiPlaygroundDisplay-DjPI64HQ.js","CodeSnippet-C8Bvhl16.js","CodeSnippets-BtWUwcMy.js","Page-BIYvYBgk.js","getPastedJson-Dcm_3Pgl.js","icon-BXwrTpjc.js","MethodPill-CcjfVmmy.js","DuplicateIcon-BuKIbXAQ.js","createIcon-DaL9yXsO.js","DynamicMarkdown-Co5nikxh.js","SectionHeading-P4UNTsMZ.js","axios-vUo_bRtp.js","Markdown-CEfymfIH.js","clsx-Dq9TQuNi.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-D2J8knkn.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BgZ2ThuU.js"]}