Missing a capability or blocked by an API error? POST /v1/feedback with your existing API key so the Zelto team can review it.
Please tell us when Zelto blocks your agent’s task. Report a missing capability,
a problem, or other feedback with the same organization API key you use
for the REST API. No extra account or credential is needed.
Write-only observability ingest keys cannot submit feedback.Send POST https://api.zelto.ai/v1/feedback with Authorization: Bearer <API key>
and Content-Type: application/json. On local or preview deployments, use
/api/v1/feedback on that deployment; never send its key to production.
{ "type": "missing_capability", "description": "I need a filter for calls that have no transcript.", "endpoint": "/v1/conversations", "reproductionSteps": "List conversations using synthetic fixtures; no transcript-presence filter is available.", "workaround": "Read each synthetic conversation and filter locally.", "requestId": "9af04723-08f8-4bbd-946d-130c11c4a5cd"}
type is missing_capability, problem, or other. description is required
(10–2000 characters). Optional fields: endpoint (500 characters),
reproductionSteps and workaround (2000 each), and requestId (200).
Unknown fields are rejected. The whole JSON body must fit in 16 KiB.
Use a route template for endpoint, without a host, query string, fragment or
customer identifiers. Use the failed response’s requestId when available.
Use synthetic examples only. Never submit API keys, passwords, cookies, personal
data, call recordings, transcripts, prompts or customer content. Known credential,
email, phone, numeric identifier and URL patterns are masked before delivery,
and names/addresses in labeled fields are removed. Pattern matching cannot
recognize every name or sensitive fact in arbitrary prose; remove those yourself.
The team receives the category, description, affected endpoint, reproduction,
workaround, request ID and internal organization/user IDs in a dedicated Slack
channel. Identity metadata contains no profile names or emails, and request headers
and raw request bodies are not forwarded. Submitted prose still needs the synthetic
examples described above. Feedback is treated as untrusted text and cannot trigger
automated actions.
From the MCP server
Agents connected to the MCP server can call the send_feedback tool
instead of the REST endpoint. It takes the same fields plus an optional tool
(the name of the MCP tool that failed or lacks the capability, such as
list_conversations), and returns the same feedbackId, delivery and message.
Any credential can call it, including read-only OAuth tokens. It shares the same
5-attempts-per-minute limit with the REST endpoint (a refusal returns
code: "rate_limited") and applies the same masking. The team sees whether a
report came from REST or MCP. Like REST errors, failed MCP tool calls carry a
feedback invitation, and the server’s connection instructions mention the tool.
Responses and retries
200: inspect delivery. delivered means Slack accepted the message.
not_configured or unavailable means the report was not delivered or stored.
A feedbackId identifies this submission; it is not a durable ticket.
400: invalid JSON or schema. 401: missing or invalid API key.
413: body exceeds 16 KiB. 415: use application/json.
429: at most 5 attempts per organization per 60 seconds, shared by all keys
and instances. Invalid attempts count too. Respect Retry-After: 60.
500: internal failure; no delivery confirmation.
Public REST errors include a feedback invitation, a generated requestId and
an X-Request-Id header. Existing error fields, status codes and useful headers
such as WWW-Authenticate and Retry-After remain available. Successful responses
have unchanged bodies. API passthrough responses also carry X-Feedback-Endpoint
and X-Feedback-Message discovery headers, including framework-generated failures
after the proxy (such as automatic 405s), which may not have the JSON envelope.Report each distinct issue once. Do not report feedback endpoint errors back to
itself, loop, or retry automatically. Delivery has a three-second timeout and no
automatic retries, so a timeout can be ambiguous. This channel is best effort,
not a support ticket queue or an incident escalation service.Continue with agent onboarding.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Zelto","description":"Observability and benchmarking for AI agents, voice and text.","colors":{"primary":"#3B5BDB","light":"#5B7FFF","dark":"#2C44A8"},"logo":{"light":"https://mintcdn.com/zelto-a802dbf4/w0jP7BwOcC-EEQGH/public/zelto-wordmark.png?fit=max\u0026auto=format\u0026n=w0jP7BwOcC-EEQGH\u0026q=85\u0026s=95a528e6e6c268521880fa274385d2cb","dark":"https://mintcdn.com/zelto-a802dbf4/pEvlQCYA2vv2-J8I/public/zelto-wordmark-white.png?fit=max\u0026auto=format\u0026n=pEvlQCYA2vv2-J8I\u0026q=85\u0026s=cbff614c65e51fcfa822c0c40f87616a"},"favicon":"https://mintcdn.com/zelto-a802dbf4/w0jP7BwOcC-EEQGH/public/zelto-logo.png?fit=max\u0026auto=format\u0026n=w0jP7BwOcC-EEQGH\u0026q=85\u0026s=23f56b73a1ea5e772fdafdeb509f50f8","search":{"prompt":"Search the Zelto docs"},"integrations":{"posthog":{"apiKey":"phc_yvnRoEc8B5GMjuU7TkpqctuvZYZLtCdEeFzHGaGuCkk8"}},"markdown":{"instructions":["If Zelto blocks your task, an API request returns 4xx/5xx, or you need a missing capability, please report it with POST https://api.zelto.ai/v1/feedback using your existing Authorization: Bearer API key. On local/preview deployments use /api/v1/feedback on that deployment; never send its credentials to production.","Send JSON: type (missing_capability, problem, other), description (10–2000 characters), optional endpoint (route template only), reproductionSteps, workaround and requestId from the failed response. Use synthetic examples: never send credentials, personal data, transcripts or customer content. See /docs/agent-feedback.","Feedback is limited to 5 attempts per organization per minute. Report a distinct issue once; do not report errors from the feedback endpoint itself, do not loop or automatically retry. A 200 with delivery not_configured/unavailable means the report was not delivered or stored.","Connected over MCP? Call the send_feedback tool instead, with the same fields plus optional tool (the MCP tool name that failed). It shares the same per-organization limit and works with any credential, including read-only."]},"styling":{"latex":true},"navigation":{"languages":[{"language":"en","default":true,"href":"docs"},{"language":"es","href":"es/docs"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"zelto-a802dbf4","hasAudioNarration":false,"actualSubdomain":"zelto-a802dbf4","customDomains":["docs.zelto.ai"],"gitSource":{"type":"github","owner":"zelto-ai","repo":"zelto-analytics","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afaeeaa0c14fe3987667a6a","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"en","tag":"API Reference","count":130},{"language":"es","tag":"Referencia de API","count":130},{"language":"en","tag":"Benchmarks","count":65},{"language":"es","tag":"Benchmarks","count":65},{"language":"en","tag":"Docs","count":49},{"language":"es","tag":"Documentación","count":49},{"language":"en","tag":"Integrations","count":18},{"language":"es","tag":"Integraciones","count":18},{"language":"en","tag":"Core concepts","count":14},{"language":"es","tag":"Conceptos principales","count":14},{"language":"en","tag":"Experiments","count":12},{"language":"es","tag":"Experimentos","count":12},{"language":"en","tag":"Findings","count":9},{"language":"es","tag":"Findings","count":9},{"language":"en","tag":"Voice providers","count":7},{"language":"es","tag":"Proveedores de voz","count":7},{"language":"en","tag":"Get started","count":6},{"language":"en","tag":"Guides","count":6},{"language":"es","tag":"Primeros pasos","count":6},{"language":"es","tag":"Guías","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".prompt-scroll pre{max-height:24rem;overflow-y:auto}.dark img[src*=\"/public/icons/\"]{filter:invert(1)}"}],"page":{"pagePath":"docs/agent-feedback","slug":"/docs/agent-feedback","pageMetadata":{"title":"Agent feedback","description":"Missing a capability or blocked by an API error? POST /v1/feedback with your existing API key so the Zelto team can review it.","href":"/docs/agent-feedback"},"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: \"Missing a capability or blocked by an API error? POST /v1/feedback with your existing API key so the Zelto team can review it.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Please tell us when Zelto blocks your agent’s task. Report a `,_jsx(_components.strong,{children:`missing capability`}),`,\na `,_jsx(_components.strong,{children:`problem`}),`, or `,_jsx(_components.strong,{children:`other feedback`}),` with the same organization API key you use\nfor the `,_jsx(_components.a,{href:`/docs/integrations/index`,children:`REST API`}),`. No extra account or credential is needed.\nWrite-only observability ingest keys cannot submit feedback.`]}),`\n`,_jsxs(_components.p,{children:[`Send `,_jsx(_components.code,{children:`POST https://api.zelto.ai/v1/feedback`}),` with `,_jsx(_components.code,{children:`Authorization: Bearer \u003cAPI key>`}),`\nand `,_jsx(_components.code,{children:`Content-Type: application/json`}),`. On local or preview deployments, use\n`,_jsx(_components.code,{children:`/api/v1/feedback`}),` on that deployment; never send its key to production.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"missing_capability\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"description\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"I need a filter for calls that have no transcript.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"endpoint\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"/v1/conversations\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"reproductionSteps\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"List conversations using synthetic fixtures; no transcript-presence filter is available.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"workaround\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Read each synthetic conversation and filter locally.\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"requestId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"9af04723-08f8-4bbd-946d-130c11c4a5cd\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`type`}),` is `,_jsx(_components.code,{children:`missing_capability`}),`, `,_jsx(_components.code,{children:`problem`}),`, or `,_jsx(_components.code,{children:`other`}),`. `,_jsx(_components.code,{children:`description`}),` is required\n(10–2000 characters). Optional fields: `,_jsx(_components.code,{children:`endpoint`}),` (500 characters),\n`,_jsx(_components.code,{children:`reproductionSteps`}),` and `,_jsx(_components.code,{children:`workaround`}),` (2000 each), and `,_jsx(_components.code,{children:`requestId`}),` (200).\nUnknown fields are rejected. The whole JSON body must fit in 16 KiB.\nUse a route template for `,_jsx(_components.code,{children:`endpoint`}),`, without a host, query string, fragment or\ncustomer identifiers. Use the failed response’s `,_jsx(_components.code,{children:`requestId`}),` when available.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Use synthetic examples only. Never submit API keys, passwords, cookies, personal\ndata, call recordings, transcripts, prompts or customer content. Known credential,\nemail, phone, numeric identifier and URL patterns are masked before delivery,\nand names/addresses in labeled fields are removed. Pattern matching cannot\nrecognize every name or sensitive fact in arbitrary prose; remove those yourself.`})}),`\n`,_jsx(_components.p,{children:`The team receives the category, description, affected endpoint, reproduction,\nworkaround, request ID and internal organization/user IDs in a dedicated Slack\nchannel. Identity metadata contains no profile names or emails, and request headers\nand raw request bodies are not forwarded. Submitted prose still needs the synthetic\nexamples described above. Feedback is treated as untrusted text and cannot trigger\nautomated actions.`}),`\n`,_jsx(Heading,{level:`2`,id:`from-the-mcp-server`,children:`From the MCP server`}),`\n`,_jsxs(_components.p,{children:[`Agents connected to the `,_jsx(_components.a,{href:`/docs/mcp`,children:`MCP server`}),` can call the `,_jsx(_components.code,{children:`send_feedback`}),` tool\ninstead of the REST endpoint. It takes the same fields plus an optional `,_jsx(_components.code,{children:`tool`}),`\n(the name of the MCP tool that failed or lacks the capability, such as\n`,_jsx(_components.code,{children:`list_conversations`}),`), and returns the same `,_jsx(_components.code,{children:`feedbackId`}),`, `,_jsx(_components.code,{children:`delivery`}),` and `,_jsx(_components.code,{children:`message`}),`.\nAny credential can call it, including read-only OAuth tokens. It shares the same\n5-attempts-per-minute limit with the REST endpoint (a refusal returns\n`,_jsx(_components.code,{children:`code: \"rate_limited\"`}),`) and applies the same masking. The team sees whether a\nreport came from REST or MCP. Like REST errors, failed MCP tool calls carry a\n`,_jsx(_components.code,{children:`feedback`}),` invitation, and the server’s connection instructions mention the tool.`]}),`\n`,_jsx(Heading,{level:`2`,id:`responses-and-retries`,children:`Responses and retries`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`200`}),`: inspect `,_jsx(_components.code,{children:`delivery`}),`. `,_jsx(_components.code,{children:`delivered`}),` means Slack accepted the message.\n`,_jsx(_components.code,{children:`not_configured`}),` or `,_jsx(_components.code,{children:`unavailable`}),` means the report was `,_jsx(_components.strong,{children:`not delivered or stored`}),`.\nA `,_jsx(_components.code,{children:`feedbackId`}),` identifies this submission; it is not a durable ticket.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`400`}),`: invalid JSON or schema. `,_jsx(_components.code,{children:`401`}),`: missing or invalid API key.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`413`}),`: body exceeds 16 KiB. `,_jsx(_components.code,{children:`415`}),`: use `,_jsx(_components.code,{children:`application/json`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`429`}),`: at most `,_jsx(_components.strong,{children:`5 attempts per organization per 60 seconds`}),`, shared by all keys\nand instances. Invalid attempts count too. Respect `,_jsx(_components.code,{children:`Retry-After: 60`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`500`}),`: internal failure; no delivery confirmation.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Public REST errors include a `,_jsx(_components.code,{children:`feedback`}),` invitation, a generated `,_jsx(_components.code,{children:`requestId`}),` and\nan `,_jsx(_components.code,{children:`X-Request-Id`}),` header. Existing error fields, status codes and useful headers\nsuch as `,_jsx(_components.code,{children:`WWW-Authenticate`}),` and `,_jsx(_components.code,{children:`Retry-After`}),` remain available. Successful responses\nhave unchanged bodies. API passthrough responses also carry `,_jsx(_components.code,{children:`X-Feedback-Endpoint`}),`\nand `,_jsx(_components.code,{children:`X-Feedback-Message`}),` discovery headers, including framework-generated failures\nafter the proxy (such as automatic 405s), which may not have the JSON envelope.`]}),`\n`,_jsx(_components.p,{children:`Report each distinct issue once. Do not report feedback endpoint errors back to\nitself, loop, or retry automatically. Delivery has a three-second timeout and no\nautomatic retries, so a timeout can be ambiguous. This channel is best effort,\nnot a support ticket queue or an incident escalation service.`}),`\n`,_jsxs(_components.p,{children:[`Continue with `,_jsx(_components.a,{href:`/docs/onboarding-with-an-agent`,children:`agent onboarding`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Agent feedback","description":"Missing a capability or blocked by an API error? POST /v1/feedback with your existing API key so the Zelto team can review it.","href":"/docs/agent-feedback"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"From the MCP server","slug":"from-the-mcp-server","depth":2,"children":[]},{"title":"Responses and retries","slug":"responses-and-retries","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"zelto-a802dbf4","siteName":"Zelto","title":"Agent feedback - Zelto","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/docs/agent-feedback","matchLevel":0},"es":{"href":"/es/docs/agent-feedback","matchLevel":1}}},"lastModified":"2026-11-10T20:53:32.665Z","originalFileLocation":"docs/agent-feedback.mdx","locale":"en"},"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=\"Missing a capability or blocked by an API error? POST /v1/feedback with your existing API key so the Zelto team can review it.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Zelto\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_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/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_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/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_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/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_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/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_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/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_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/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_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/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agent feedback - Zelto\">\u003cmeta data-mint-head property=\"og:description\" content=\"Missing a capability or blocked by an API error? POST /v1/feedback with your existing API key so the Zelto team can review it.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Zelto\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.zelto.ai/docs/agent-feedback\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://zelto-a802dbf4.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Agent+feedback\u0026amp;description=Missing+a+capability+or+blocked+by+an+API+error%3F+POST+%2Fv1%2Ffeedback+with+your+existing+API+key+so+the+Zelto+team+can+review+it.\u0026amp;theme=455839e89afb1494f2928eb8\u0026amp;signature=bc979a72eb860532452caceb03a27963c91ec936ff5f0f6bc35d6e6e561112b4\">\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=\"Agent feedback - Zelto\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Missing a capability or blocked by an API error? POST /v1/feedback with your existing API key so the Zelto team can review it.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://zelto-a802dbf4.mintlify.site/_mintlify/api/og/v2?division=Get+started\u0026amp;title=Agent+feedback\u0026amp;description=Missing+a+capability+or+blocked+by+an+API+error%3F+POST+%2Fv1%2Ffeedback+with+your+existing+API+key+so+the+Zelto+team+can+review+it.\u0026amp;theme=455839e89afb1494f2928eb8\u0026amp;signature=bc979a72eb860532452caceb03a27963c91ec936ff5f0f6bc35d6e6e561112b4\">\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/zelto-a802dbf4/pzPG6qy7F5YbxXe9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Zelto\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B5BDB\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.zelto.ai/docs/agent-feedback\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/agent-feedback.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.zelto.ai/docs/agent-feedback\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.zelto.ai/es/docs/agent-feedback\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.zelto.ai/docs/agent-feedback\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.zelto.ai/#organization\",\"name\":\"Zelto\",\"url\":\"https://docs.zelto.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/zelto-a802dbf4/w0jP7BwOcC-EEQGH/public/zelto-wordmark.png?fit=max\u0026auto=format\u0026n=w0jP7BwOcC-EEQGH\u0026q=85\u0026s=95a528e6e6c268521880fa274385d2cb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.zelto.ai#website\",\"name\":\"Zelto\",\"url\":\"https://docs.zelto.ai\",\"publisher\":{\"@id\":\"https://docs.zelto.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.zelto.ai/docs/agent-feedback#webpage\",\"url\":\"https://docs.zelto.ai/docs/agent-feedback\",\"name\":\"Agent feedback\",\"description\":\"Missing a capability or blocked by an API error? POST /v1/feedback with your existing API key so the Zelto team can review it.\",\"dateModified\":\"2026-11-10T20:53:32.665Z\",\"isPartOf\":{\"@id\":\"https://docs.zelto.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.zelto.ai/docs/agent-feedback#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.zelto.ai/docs/agent-feedback#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Get started\",\"item\":\"https://docs.zelto.ai/docs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent feedback\",\"item\":\"https://docs.zelto.ai/docs/agent-feedback\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.zelto.ai/docs/agent-feedback#article\",\"headline\":\"Agent feedback\",\"name\":\"Agent feedback\",\"description\":\"Missing a capability or blocked by an API error? POST /v1/feedback with your existing API key so the Zelto team can review it.\",\"url\":\"https://docs.zelto.ai/docs/agent-feedback\",\"mainEntityOfPage\":{\"@id\":\"https://docs.zelto.ai/docs/agent-feedback#webpage\"},\"dateModified\":\"2026-11-10T20:53:32.665Z\",\"publisher\":{\"@id\":\"https://docs.zelto.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.zelto.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Zelto\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Zelto\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/agent-feedback.md","siteName":"Zelto","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Docs","icon":"book-open","groups":[{"group":"Get started","icon":"rocket","pages":[{"title":"Introduction","icon":"house","href":"/docs"},{"title":"Quickstart: start analyzing conversations in five minutes","sidebarTitle":"Quickstart","icon":"bolt","href":"/docs/quickstart"},{"title":"Start sending traces to Zelto","sidebarTitle":"Send traces","icon":"timeline","href":"/docs/guides/send-traces"},{"title":"Onboard with an agent","icon":"robot","href":"/docs/onboarding-with-an-agent"},{"title":"How Zelto works","description":"From a connected provider to conversations, findings, and changes — the whole platform end to end.","icon":"gears","href":"/docs/how-it-works"},{"title":"Agent feedback","href":"/docs/agent-feedback"}]},{"group":"Core concepts","icon":"cube","pages":[{"title":"Agents","description":"How Zelto models the voice and text agents that drive your conversations.","icon":"headset","href":"/docs/agents"},{"title":"Agent versions","icon":"code-branch","href":"/docs/agent-versions"},{"title":"Companies","icon":"building","href":"/docs/companies"},{"title":"Conversations","icon":"comments","href":"/docs/conversations"},{"title":"Traces","icon":"timeline","href":"/docs/traces"},{"title":"Tool calls","icon":"wrench","href":"/docs/tool-calls"},{"title":"Findings","icon":"flag","href":"/docs/findings"},{"title":"Monitors","icon":"signal","href":"/docs/monitors"},{"title":"Experiments","icon":"scale-balanced","href":"/docs/experiments"},{"title":"Changes","icon":"lightbulb","href":"/docs/changes"},{"title":"Reports","icon":"file-chart-column","href":"/docs/reports"},{"title":"Simulations","icon":"flask","href":"/docs/simulations"},{"title":"Benchmarks","icon":"chart-simple","href":"/docs/benchmarks"},{"title":"Create cases with the API","icon":"code","href":"/docs/benchmarks/cases-api"}]},{"group":"Integrations","icon":"puzzle-piece","pages":[{"title":"Integrations","sidebarTitle":"Overview","icon":"compass","href":"/docs/integrations/index"},{"title":"Webhooks","icon":"webhook","href":"/docs/integrations/webhooks"},{"group":"Voice providers","icon":"microphone","pages":[{"title":"Cartesia","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/cartesia.svg","href":"/docs/integrations/cartesia"},{"title":"ElevenLabs","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/elevenlabs.svg","href":"/docs/integrations/elevenlabs"},{"title":"LiveKit","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/livekit.svg","href":"/docs/integrations/livekit"},{"title":"Retell","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/retell.svg","href":"/docs/integrations/retell"},{"title":"Speechify","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/speechify.svg","href":"/docs/integrations/speechify"},{"title":"Telnyx AI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/telnyx.svg","href":"/docs/integrations/telnyx"},{"title":"Vapi","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/vapi.svg","href":"/docs/integrations/vapi"}]},{"title":"Custom \u0026 other providers","icon":"cloud-arrow-up","href":"/docs/integrations/api-call-upload"},{"title":"Chatbot \u0026 text conversations","icon":"messages","href":"/docs/integrations/chatbot-text-conversations"},{"title":"Kapso (WhatsApp)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/kapso.svg","href":"/docs/integrations/kapso"},{"title":"Twilio","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/twilio.svg","href":"/docs/integrations/twilio"},{"group":"Notifications","icon":"bell","pages":[{"title":"Slack","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/slack.svg","href":"/docs/integrations/slack"},{"title":"Google Chat","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/googlechat.svg","href":"/docs/integrations/google-chat"}]},{"group":"Issue tracking","icon":"list-check","pages":[{"title":"Linear","icon":"https://mintlify.s3.us-west-1.amazonaws.com/zelto-a802dbf4/public/icons/linear.svg","href":"/docs/integrations/linear"}]},{"title":"MCP","icon":"plug","href":"/docs/mcp"},{"title":"Connect Zelto to Claude","icon":"link","href":"/docs/connect-claude"}]},{"group":"Guides","icon":"map","pages":[{"title":"Connect a voice provider","icon":"link","href":"/docs/guides/connect-a-voice-provider"},{"title":"Triage findings","icon":"filter","href":"/docs/guides/triage-findings"},{"title":"Audit an agent","icon":"clipboard-list","href":"/docs/guides/audit-an-agent"},{"title":"Set up companies","icon":"list-check","href":"/docs/guides/set-up-companies"},{"title":"Action checks and operational reports","href":"/docs/guides/customer-evaluation-workflows"},{"title":"Manage your team","icon":"users","href":"/docs/guides/manage-your-team"}]},{"group":"Account \u0026 settings","icon":"gear","pages":[{"title":"Plans, limits and retention","icon":"tags","href":"/docs/plans"},{"title":"Settings","icon":"gear","href":"/docs/settings"},{"title":"AI providers","href":"/docs/ai-providers"}]},{"group":"Legal","icon":"scale-balanced","pages":[{"title":"Privacy Policy","icon":"shield-halved","href":"/docs/legal/privacy-policy"},{"title":"Terms of Service","icon":"file-contract","href":"/docs/legal/terms-of-service"}]}]},{"tab":"API Reference","icon":"terminal","pages":[{"title":"API Reference","href":"/api-reference/monitors/create-a-filtered-monitor-export"}]}]},{"language":"es","pages":[{"title":"es","href":"/es/docs/agent-feedback"}]}]},"basePath":"","title":"Agent feedback - Zelto","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}