Returns the public A2A-protocol-compliant agent card. This endpoint requires no authentication and is used by other agents and clients to discover capabilities, supported transports, and skills before initiating communication.
GET
/
.well-known
/
agent-card.json
Agent card discovery
curl --request GET \ --url https://mesh.svantic.com/.well-known/agent-card.json
A2A-protocol-compliant agent card. Describes the agent's identity, capabilities, skills, supported transports, and security requirements. Conforms to the AgentCard definition in the A2A specification.
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Svantic","description":"AI agent platform — discovery, orchestration, governance, and knowledge for agent fleets.","colors":{"primary":"#7C3AED","light":"#A78BFA","dark":"#5B21B6"},"logo":{"light":"https://mintcdn.com/svantic/DQEVJ_RnVW5_l6gu/images/logo_large.png?fit=max\u0026auto=format\u0026n=DQEVJ_RnVW5_l6gu\u0026q=85\u0026s=c23d1b1fd831f2dc24e9b758c0e4f930","dark":"https://mintcdn.com/svantic/DQEVJ_RnVW5_l6gu/images/logo_large.png?fit=max\u0026auto=format\u0026n=DQEVJ_RnVW5_l6gu\u0026q=85\u0026s=c23d1b1fd831f2dc24e9b758c0e4f930"},"favicon":"https://mintcdn.com/svantic/DQEVJ_RnVW5_l6gu/images/logo_large.png?fit=max\u0026auto=format\u0026n=DQEVJ_RnVW5_l6gu\u0026q=85\u0026s=c23d1b1fd831f2dc24e9b758c0e4f930","api":{"openapi":"api-reference/openapi-bundled.yaml","playground":{"display":"interactive"},"examples":{"languages":["curl","javascript","python","go"]}},"appearance":{"default":"light","strict":true},"navbar":{"links":[{"href":"https://svantic.com","label":"Website"},{"href":"https://app.svantic.com","label":"Dashboard"}]},"footer":{"socials":{"github":"https://github.com/svantic","website":"https://svantic.com"},"links":[{"header":"Documentation","items":[{"label":"Home","href":"/"},{"label":"Getting Started","href":"/getting-started"},{"label":"Core Concepts","href":"/core-concepts"}]},{"header":"Reference","items":[{"label":"SDK","href":"/sdk"},{"label":"API Reference","href":"/api-reference"},{"label":"CLI Reference","href":"/cli-reference"}]},{"header":"Resources","items":[{"label":"Website","href":"https://svantic.com"},{"label":"GitHub","href":"https://github.com/svantic"},{"label":"Dashboard","href":"https://app.svantic.com"}]},{"header":"Legal","items":[{"label":"Terms of Service","href":"https://svantic.com/legal/terms"},{"label":"Privacy Policy","href":"https://svantic.com/legal/privacy"}]}]},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"svantic","hasAudioNarration":false,"actualSubdomain":"svantic","customDomains":["docs.svantic.com"],"gitSource":{"type":"github","owner":"svantic","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a21dcceab250d2c48819885","collectionId":"6c93ef79-0ccb-422b-a348-0750b4a5fbcf","schemaVersion":"v2"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a21dcceab250d2c48819885:success","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API Reference","count":50},{"language":"default","tag":"REST API","count":49},{"language":"default","tag":"Documentation","count":43},{"language":"default","tag":"SDK","count":27},{"language":"default","tag":"Reference","count":14},{"language":"default","tag":"Guides","count":12},{"language":"default","tag":"Knowledge Base","count":12},{"language":"default","tag":"Agents","count":10},{"language":"default","tag":"Policies","count":10},{"language":"default","tag":"Deep Dive","count":9}]},"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":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"global.css","content":"#sidebar,nav#sidebar{width:300px!important;min-width:300px!important}html:not([data-current-path^=\"/api-reference\"]) #content,html:not([data-current-path^=\"/api-reference\"]) #content-area{max-width:1260px;margin-left:auto;margin-right:auto}#page-title,h1{color:#7c3aed;font-weight:900;letter-spacing:-.025em}html:not([data-current-path^=\"/api-reference\"]) h2{color:#7c3aed;font-weight:700;letter-spacing:-.025em;padding-bottom:8px;border-bottom:2px solid rgba(124,58,237,.12);margin-top:1.75rem;margin-bottom:.4rem}html:not([data-current-path^=\"/api-reference\"]) h3{color:#5b21b6;font-weight:600;letter-spacing:-.025em;margin-top:1.25rem;margin-bottom:.3rem}html:not([data-current-path^=\"/api-reference\"]) h4{color:#7c3aed;font-weight:600;letter-spacing:-.025em;margin-top:1rem;margin-bottom:.25rem}html.dark #page-title,html.dark h1{color:#a78bfa}html.dark:not([data-current-path^=\"/api-reference\"]) h2{color:#a78bfa;border-bottom-color:rgba(167,139,250,.2)}html.dark:not([data-current-path^=\"/api-reference\"]) h3,html.dark:not([data-current-path^=\"/api-reference\"]) mdx-content a:not([class]):hover{color:#c4b5fd}html.dark:not([data-current-path^=\"/api-reference\"]) h4{color:#facc15}html:not([data-current-path^=\"/api-reference\"]) p{line-height:1.65;margin-bottom:.75em}html:not([data-current-path^=\"/api-reference\"]) li{line-height:1.6;margin-bottom:2px}html:not([data-current-path^=\"/api-reference\"]) h1{margin-bottom:.5rem}:not(pre)>code{padding:2px 7px;border-radius:5px;font-weight:500;background-color:#f1f5f9;border:1px solid rgba(124,58,237,.12);color:#5b21b6}html.dark :not(pre)>code{background-color:#1e293b;border-color:rgba(103,232,249,.2);color:#67e8f9}pre{border-radius:10px!important;box-shadow:0 2px 8px rgba(0,0,0,.06)}html.dark pre{box-shadow:0 2px 8px rgba(0,0,0,.3)}html:not([data-current-path^=\"/api-reference\"]) blockquote{margin:1.5rem 0 2rem;padding:1rem 1.25rem;background:linear-gradient(135deg,rgba(124,58,237,.05) 0,rgba(124,58,237,.02) 100%);border-left:3px solid #7c3aed;border-radius:0 8px 8px 0;font-style:normal}html.dark:not([data-current-path^=\"/api-reference\"]) blockquote{background:linear-gradient(135deg,rgba(167,139,250,.08) 0,rgba(167,139,250,.02) 100%)}html:not([data-current-path^=\"/api-reference\"]) hr{height:1px;margin:2.5rem 0;background:linear-gradient(to right,transparent,rgba(124,58,237,.18),transparent);border:0}html.dark:not([data-current-path^=\"/api-reference\"]) hr{background:linear-gradient(to right,transparent,rgba(167,139,250,.2),transparent)}html:not([data-current-path^=\"/api-reference\"]) table{border-radius:10px;overflow:hidden;border:1px solid #e2e8f0}html:not([data-current-path^=\"/api-reference\"]) thead{background:linear-gradient(135deg,#f8fafc 0,#f1f5f9 100%)}html.dark:not([data-current-path^=\"/api-reference\"]) thead{background:linear-gradient(135deg,#1e293b 0,#334155 100%)}html:not([data-current-path^=\"/api-reference\"]) th{font-weight:600;text-transform:uppercase;letter-spacing:.05em}html:not([data-current-path^=\"/api-reference\"]) tr:hover td{background:rgba(124,58,237,.04)}html.dark:not([data-current-path^=\"/api-reference\"]) tr:hover td{background:rgba(167,139,250,.06)}html:not([data-current-path^=\"/api-reference\"]) mdx-content img{border-radius:10px;box-shadow:0 2px 12px rgba(0,0,0,.08)}html.dark:not([data-current-path^=\"/api-reference\"]) mdx-content img{box-shadow:0 2px 12px rgba(0,0,0,.3)}::selection{background:rgba(124,58,237,.18)}html.dark ::selection{background:rgba(167,139,250,.25)}html:not([data-current-path^=\"/api-reference\"]) mdx-content a:not([class]){color:#7c3aed}html:not([data-current-path^=\"/api-reference\"]) mdx-content a:not([class]):hover{color:#6d28d9}html.dark:not([data-current-path^=\"/api-reference\"]) mdx-content a:not([class]){color:#a78bfa}html[data-current-path^=\"/api-reference\"] #content-area,html[data-current-path^=\"/api-reference\"] #content-area *{font-family:\"Inter\",-apple-system,BlinkMacSystemFont,\"Segoe UI\",system-ui,sans-serif!important;line-height:1.55}html[data-current-path^=\"/api-reference\"] #content-area dd,html[data-current-path^=\"/api-reference\"] #content-area div,html[data-current-path^=\"/api-reference\"] #content-area dt,html[data-current-path^=\"/api-reference\"] #content-area label,html[data-current-path^=\"/api-reference\"] #content-area li,html[data-current-path^=\"/api-reference\"] #content-area p,html[data-current-path^=\"/api-reference\"] #content-area span,html[data-current-path^=\"/api-reference\"] #content-area td,html[data-current-path^=\"/api-reference\"] #content-area th{font-size:14px;line-height:1.55}html[data-current-path^=\"/api-reference\"] #content-area h1{font-size:24px;line-height:1.3}html[data-current-path^=\"/api-reference\"] #content-area h2{font-size:18px;line-height:1.3}html[data-current-path^=\"/api-reference\"] #content-area h3{font-size:15px;line-height:1.4}mdx-content svg text[fill]{color:unset}mdx-content svg{border-radius:12px;box-shadow:0 1px 6px rgba(0,0,0,.06);border:1px solid #e2e8f0}html{scroll-behavior:smooth}"}],"page":{"pagePath":"api-reference/agents/agent-card-discovery","slug":"/api-reference/agents/agent-card-discovery","pageMetadata":{"title":"Agent card discovery","description":"Returns the public A2A-protocol-compliant agent card. This endpoint requires no authentication and is used by other agents and clients to discover capabilities, supported transports, and skills before initiating communication.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /.well-known/agent-card.json","href":"/api-reference/agents/agent-card-discovery","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns the public A2A-protocol-compliant agent card. This endpoint requires no authentication and is used by other agents and clients to discover capabilities, supported transports, and skills before initiating communication.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Agent card discovery","description":"Returns the public A2A-protocol-compliant agent card. This endpoint requires no authentication and is used by other agents and clients to discover capabilities, supported transports, and skills before initiating communication.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /.well-known/agent-card.json","href":"/api-reference/agents/agent-card-discovery","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"agents_card","summary":"Agent card discovery","description":"Returns the public A2A-protocol-compliant agent card. This endpoint requires no authentication and is used by other agents and clients to discover capabilities, supported transports, and skills before initiating communication.\n","tags":["Agents"],"security":[],"responses":{"200":"cd85a367-aa3f-42e2-abc8-487e2feda2bb","400":"4dbf95da-6cd5-4793-806c-e9664ac83977","401":"8ae03e10-943f-4a5d-8d0d-c988290db1a7","403":"8eaa10f7-a9cd-455a-8889-108b2162d05e","404":"7d42609c-19ce-4b64-b595-4c498a7af584","408":"42d45d22-f950-4edb-913a-bde318a45b0d","500":"b9132d31-6d5e-455c-9c72-199b9982e648","502":"7fd0616e-0728-43c9-b566-7d95340a44f9","503":"bedd44b9-8d46-4310-b941-afed82942532"},"method":"get","type":"path","servers":["34fe474d-02c4-46b2-87f0-c52eeb3b7f28"],"path":"/.well-known/agent-card.json","baseUrlOptions":["https://mesh.svantic.com"],"title":"Agent card discovery","codeSamples":[],"requestExampleLanguages":["bash","javascript","python","go"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"responses":{"cd85a367-aa3f-42e2-abc8-487e2feda2bb":{"description":"A2A agent card document.","content":{"application/json":{"schema":{"type":"object","description":"A2A-protocol-compliant agent card. Describes the agent's identity, capabilities, skills, supported transports, and security requirements. Conforms to the AgentCard definition in the A2A specification.\n","required":["name","description","url","version","protocolVersion","defaultInputModes","defaultOutputModes","capabilities","skills"],"properties":{"name":{"type":"string","description":"A human-readable name for the agent.","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"description":{"type":"string","description":"A human-readable description of the agent's purpose.","isRequired":true,"uniqueKey":"description","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"The preferred endpoint URL for interacting with the agent (JSON-RPC).","isRequired":true,"uniqueKey":"url","typeLabel":"string\u003curi>"},"version":{"type":"string","description":"The agent's own version number.","isRequired":true,"uniqueKey":"version","typeLabel":"string"},"protocolVersion":{"type":"string","description":"The version of the A2A protocol this agent supports (e.g. \"0.2.3\").","isRequired":true,"uniqueKey":"protocolVersion","typeLabel":"string"},"defaultInputModes":{"type":"array","items":{"type":"string","uniqueKey":"defaultInputModes.items.[INDEX]","typeLabel":"string"},"description":"Default set of supported input MIME types for all skills.","isRequired":true,"uniqueKey":"defaultInputModes","typeLabel":"string[]"},"defaultOutputModes":{"type":"array","items":{"type":"string","uniqueKey":"defaultOutputModes.items.[INDEX]","typeLabel":"string"},"description":"Default set of supported output MIME types for all skills.","isRequired":true,"uniqueKey":"defaultOutputModes","typeLabel":"string[]"},"capabilities":{"type":"object","description":"Capabilities supported by the agent.","properties":{"streaming":{"type":"boolean","description":"Whether the agent supports SSE streaming responses.","uniqueKey":"capabilities.streaming","typeLabel":"boolean"},"pushNotifications":{"type":"boolean","description":"Whether the agent supports push notifications for async task updates.","uniqueKey":"capabilities.pushNotifications","typeLabel":"boolean"},"stateTransitionHistory":{"type":"boolean","description":"Whether the agent provides a history of state transitions for a task.","uniqueKey":"capabilities.stateTransitionHistory","typeLabel":"boolean"},"extensions":{"type":"array","items":{"type":"object","required":["uri"],"properties":{"uri":{"type":"string","description":"Unique URI identifying the extension.","isRequired":true,"uniqueKey":"capabilities.extensions.items.[INDEX].uri","typeLabel":"string"},"description":{"type":"string","uniqueKey":"capabilities.extensions.items.[INDEX].description","typeLabel":"string"},"required":{"type":"boolean","description":"If true, the client must comply with the extension.","uniqueKey":"capabilities.extensions.items.[INDEX].required","typeLabel":"boolean"},"params":{"type":"object","additionalProperties":true,"uniqueKey":"capabilities.extensions.items.[INDEX].params","typeLabel":"object"}},"uniqueKey":"capabilities.extensions.items.[INDEX]","typeLabel":"object"},"description":"Protocol extensions supported by the agent.","uniqueKey":"capabilities.extensions","typeLabel":"object[]"}},"isRequired":true,"uniqueKey":"capabilities","typeLabel":"object"},"skills":{"type":"array","items":{"type":"object","description":"A distinct capability the agent can perform. Each skill corresponds to a tool registered on the agent. The `parameters` field carries the tool's JSON Schema so consuming agents know the expected input shape.\n","required":["id","name","description","tags"],"properties":{"id":{"type":"string","description":"Unique identifier. Remote agent skills are namespaced as `{agent_type}:{skill_id}`.\n","isRequired":true,"uniqueKey":"skills.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","description":"Human-readable name for the skill.","isRequired":true,"uniqueKey":"skills.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","description":"Detailed description of what the skill does.","isRequired":true,"uniqueKey":"skills.items.[INDEX].description","typeLabel":"string"},"tags":{"type":"array","items":{"type":"string","uniqueKey":"skills.items.[INDEX].tags.items.[INDEX]","typeLabel":"string"},"description":"Keywords describing the skill. Includes `remote:{agent_type}` for remote agent skills and `instances:{n}` when multiple instances serve the skill.\n","isRequired":true,"uniqueKey":"skills.items.[INDEX].tags","typeLabel":"string[]"},"examples":{"type":"array","items":{"type":"string","uniqueKey":"skills.items.[INDEX].examples.items.[INDEX]","typeLabel":"string"},"description":"Example prompts or scenarios the skill can handle.","uniqueKey":"skills.items.[INDEX].examples","typeLabel":"string[]"},"inputModes":{"type":"array","items":{"type":"string","uniqueKey":"skills.items.[INDEX].inputModes.items.[INDEX]","typeLabel":"string"},"description":"Supported input MIME types (overrides agent defaults).","uniqueKey":"skills.items.[INDEX].inputModes","typeLabel":"string[]"},"outputModes":{"type":"array","items":{"type":"string","uniqueKey":"skills.items.[INDEX].outputModes.items.[INDEX]","typeLabel":"string"},"description":"Supported output MIME types (overrides agent defaults).","uniqueKey":"skills.items.[INDEX].outputModes","typeLabel":"string[]"},"parameters":{"type":"object","description":"JSON Schema describing the skill's input parameters, derived from the tools registered on the agent. Skills without parameters are descriptive only.\n","properties":{"type":{"type":"string","enum":["object"],"uniqueKey":"skills.items.[INDEX].parameters.type","typeLabel":"enum\u003cstring>"},"properties":{"type":"object","additionalProperties":{"type":"object","properties":{"type":{"type":"string","enum":["string","number","boolean","integer","array","object"],"uniqueKey":"skills.items.[INDEX].parameters.properties.additionalProperties.type","typeLabel":"enum\u003cstring>"},"description":{"type":"string","uniqueKey":"skills.items.[INDEX].parameters.properties.additionalProperties.description","typeLabel":"string"},"enum":{"type":"array","items":{"type":"string","uniqueKey":"skills.items.[INDEX].parameters.properties.additionalProperties.enum.items.[INDEX]","typeLabel":"string"},"uniqueKey":"skills.items.[INDEX].parameters.properties.additionalProperties.enum","typeLabel":"string[]"},"default":{"oneOf":[{}],"uniqueKey":"skills.items.[INDEX].parameters.properties.additionalProperties.default","typeLabel":"any"}},"uniqueKey":"skills.items.[INDEX].parameters.properties.additionalProperties","typeLabel":"object"},"uniqueKey":"skills.items.[INDEX].parameters.properties","typeLabel":"object"},"required":{"type":"array","items":{"type":"string","uniqueKey":"skills.items.[INDEX].parameters.required.items.[INDEX]","typeLabel":"string"},"uniqueKey":"skills.items.[INDEX].parameters.required","typeLabel":"string[]"}},"uniqueKey":"skills.items.[INDEX].parameters","typeLabel":"object"}},"uniqueKey":"skills.items.[INDEX]","typeLabel":"object"},"description":"The set of skills (capabilities) the agent can perform.","isRequired":true,"uniqueKey":"skills","typeLabel":"object[]"},"provider":{"type":"object","description":"Information about the agent's service provider.","required":["organization","url"],"properties":{"organization":{"type":"string","description":"Name of the provider organization.","isRequired":true,"uniqueKey":"provider.organization","typeLabel":"string"},"url":{"type":"string","format":"uri","description":"URL for the provider's website or documentation.","isRequired":true,"uniqueKey":"provider.url","typeLabel":"string\u003curi>"}},"uniqueKey":"provider","typeLabel":"object"},"preferredTransport":{"type":"string","description":"Transport protocol for the preferred endpoint. Defaults to \"JSONRPC\" when not specified.\n","uniqueKey":"preferredTransport","typeLabel":"string"},"additionalInterfaces":{"type":"array","items":{"type":"object","required":["url","transport"],"properties":{"url":{"type":"string","format":"uri","isRequired":true,"uniqueKey":"additionalInterfaces.items.[INDEX].url","typeLabel":"string\u003curi>"},"transport":{"type":"string","isRequired":true,"uniqueKey":"additionalInterfaces.items.[INDEX].transport","typeLabel":"string"}},"uniqueKey":"additionalInterfaces.items.[INDEX]","typeLabel":"object"},"description":"Additional transport/URL combinations the agent supports, enabling transport negotiation and fallback.\n","uniqueKey":"additionalInterfaces","typeLabel":"object[]"},"security":{"type":"array","items":{"type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"security.items.[INDEX].additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"security.items.[INDEX].additionalProperties","typeLabel":"string[]"},"uniqueKey":"security.items.[INDEX]","typeLabel":"object"},"description":"Security requirement objects (OpenAPI 3.0 style). Each object lists security schemes that can be used. The list represents a logical OR of ANDs.\n","uniqueKey":"security","typeLabel":"object[]"},"securitySchemes":{"type":"object","additionalProperties":true,"description":"Security scheme definitions available for authorization. Follows the OpenAPI 3.0 Security Scheme Object.\n","uniqueKey":"securitySchemes","typeLabel":"object"},"signatures":{"type":"array","items":{"type":"object","required":["protected","signature"],"properties":{"protected":{"type":"string","description":"Base64url-encoded JWS protected header.","isRequired":true,"uniqueKey":"signatures.items.[INDEX].protected","typeLabel":"string"},"signature":{"type":"string","description":"Base64url-encoded JWS signature.","isRequired":true,"uniqueKey":"signatures.items.[INDEX].signature","typeLabel":"string"},"header":{"type":"object","additionalProperties":true,"description":"Unprotected JWS header values.","uniqueKey":"signatures.items.[INDEX].header","typeLabel":"object"}},"uniqueKey":"signatures.items.[INDEX]","typeLabel":"object"},"description":"JSON Web Signatures computed for this AgentCard.","uniqueKey":"signatures","typeLabel":"object[]"},"supportsAuthenticatedExtendedCard":{"type":"boolean","default":false,"description":"If true, the agent provides an extended agent card with additional details to authenticated users.\n","uniqueKey":"supportsAuthenticatedExtendedCard","typeLabel":"boolean"},"iconUrl":{"type":"string","format":"uri","description":"An optional URL to an icon for the agent.","uniqueKey":"iconUrl","typeLabel":"string\u003curi>"},"documentationUrl":{"type":"string","format":"uri","description":"An optional URL to the agent's documentation.","uniqueKey":"documentationUrl","typeLabel":"string\u003curi>"},"extensions":{"type":"object","additionalProperties":true,"description":"Svantic-specific extensions. Currently includes `instances` — a map of agent_type to instance count.\n","uniqueKey":"extensions","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"representative":{"title":"representative","value":{"name":"savant","description":"Savant AI Agent Framework — orchestrates intelligent task execution with planning, learning, and tool integration.","url":"https://mesh.example.com/send","version":"2.0.0","protocolVersion":"0.2.3","defaultInputModes":["application/json","text/plain"],"defaultOutputModes":["application/json","text/plain"],"capabilities":{"streaming":true,"pushNotifications":false,"stateTransitionHistory":false},"skills":[{"id":"orchestration","name":"Task Orchestration","description":"Routes user requests to specialized agents: chat, executor, planner, code repair, document processing.","tags":["core","orchestration"]},{"id":"planning","name":"Task Planning","description":"Breaks complex tasks into execution plans with dependency ordering and agent mesh construction.","tags":["core","planning"]},{"id":"transcript-link:process_document","name":"transcript-link — Document Processing","description":"Processes academic transcripts and employment documents.","tags":["document","remote:transcript-link","instances:3"],"examples":["Process the transcript at https://example.com/doc.pdf","Extract GPA from this academic record"],"parameters":{"type":"object","properties":{"document_url":{"type":"string","description":"URL of the document to process."},"document_type":{"type":"string","description":"Type of document.","enum":["transcript","pay_stub","tax_return"]},"output_format":{"type":"string","description":"Desired output format.","enum":["json","pdf"]}},"required":["document_url","document_type"]}}],"provider":{"organization":"Svantic","url":"https://svantic.ai"},"extensions":{"instances":{"transcript-link":3}}}}},"exampleType":"examples"}},"exampleType":"examples"},"4dbf95da-6cd5-4793-806c-e9664ac83977":{"description":"Malformed JSON, failed request validation, or missing required fields in the body (gateway returns before the handler runs in some cases).\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, when available.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id for support — present on some gateway catch-all responses (e.g. unmatched route, unhandled error).\n","uniqueKey":"request_id","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 time when the error was produced, when returned by the gateway.","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"sample":{"title":"sample","value":{"error":"Invalid request body","code":"BAD_REQUEST"}}},"exampleType":"examples"}},"exampleType":"examples"},"8ae03e10-943f-4a5d-8d0d-c988290db1a7":{"description":"Authentication failed — missing or invalid credentials.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, when available.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id for support — present on some gateway catch-all responses (e.g. unmatched route, unhandled error).\n","uniqueKey":"request_id","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 time when the error was produced, when returned by the gateway.","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"sample":{"title":"sample","value":{"error":"Invalid or expired token","code":"unauthorized"}}},"exampleType":"examples"}},"exampleType":"examples"},"8eaa10f7-a9cd-455a-8889-108b2162d05e":{"description":"Insufficient scope — JWT does not carry the required scope for this operation.","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, when available.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id for support — present on some gateway catch-all responses (e.g. unmatched route, unhandled error).\n","uniqueKey":"request_id","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 time when the error was produced, when returned by the gateway.","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"sample":{"title":"sample","value":{"error":"JWT does not include the required scope for this operation","code":"forbidden"}}},"exampleType":"examples"}},"exampleType":"examples"},"7d42609c-19ce-4b64-b595-4c498a7af584":{"description":"Unknown resource identifier, tenant mismatch for the requested resource, or (for unmatched HTTP routes) the gateway catch-all `NOT_FOUND` envelope.\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, when available.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id for support — present on some gateway catch-all responses (e.g. unmatched route, unhandled error).\n","uniqueKey":"request_id","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 time when the error was produced, when returned by the gateway.","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"sample":{"title":"sample","value":{"error":"Not found","code":"NOT_FOUND","request_id":"req_01EXAMPLE","timestamp":"2026-03-31T12:00:00.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"42d45d22-f950-4edb-913a-bde318a45b0d":{"description":"Request exceeded the gateway timeout window (HTTP 408).\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, when available.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id for support — present on some gateway catch-all responses (e.g. unmatched route, unhandled error).\n","uniqueKey":"request_id","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 time when the error was produced, when returned by the gateway.","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"sample":{"title":"sample","value":{"error":"Request timeout","code":"REQUEST_TIMEOUT"}}},"exampleType":"examples"}},"exampleType":"examples"},"b9132d31-6d5e-455c-9c72-199b9982e648":{"description":"Unhandled exception in the gateway — `INTERNAL_ERROR` with optional `request_id` and `timestamp` for correlation.\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, when available.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id for support — present on some gateway catch-all responses (e.g. unmatched route, unhandled error).\n","uniqueKey":"request_id","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 time when the error was produced, when returned by the gateway.","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"sample":{"title":"sample","value":{"error":"Internal server error","code":"INTERNAL_ERROR","request_id":"req_01EXAMPLE","timestamp":"2026-03-31T12:00:00.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"7fd0616e-0728-43c9-b566-7d95340a44f9":{"description":"Gateway received an invalid or failed response from an upstream dependency (MCP Servers, Mesh, Gateway, etc.), or could not complete a proxied request.\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, when available.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id for support — present on some gateway catch-all responses (e.g. unmatched route, unhandled error).\n","uniqueKey":"request_id","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 time when the error was produced, when returned by the gateway.","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"sample":{"title":"sample","value":{"error":"Bad gateway","code":"BAD_GATEWAY"}}},"exampleType":"examples"}},"exampleType":"examples"},"bedd44b9-8d46-4310-b941-afed82942532":{"description":"Temporary failure — e.g. JWT signing not configured (`MESH_SECRET` missing on token route), mesh or upstream unreachable, or dependency unavailable.\n","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable error message.","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, when available.","uniqueKey":"code","typeLabel":"string"},"request_id":{"type":"string","description":"Correlation id for support — present on some gateway catch-all responses (e.g. unmatched route, unhandled error).\n","uniqueKey":"request_id","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 time when the error was produced, when returned by the gateway.","uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"examples":{"sample":{"title":"sample","value":{"error":"Service temporarily unavailable","code":"SERVICE_UNAVAILABLE"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{"34fe474d-02c4-46b2-87f0-c52eeb3b7f28":{"url":"https://mesh.svantic.com","description":"Mesh runtime"}}},"originalFileLocation":"api-reference/openapi-bundled.yaml"},"subdomain":"svantic","siteName":"Svantic","title":"Agent card discovery - Svantic","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-04-27T14:39:56.773Z","originalFileLocation":"api-reference/agents/agent-card-discovery.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";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=\"light\"}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 the public A2A-protocol-compliant agent card. This endpoint requires no authentication and is used by other agents and clients to discover capabilities, supported transports, and skills before initiating communication.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Svantic\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/svantic/RPjRh-i-AWgBqfl_/_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/svantic/RPjRh-i-AWgBqfl_/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/svantic/RPjRh-i-AWgBqfl_/_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/svantic/RPjRh-i-AWgBqfl_/_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/svantic/RPjRh-i-AWgBqfl_/_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/svantic/RPjRh-i-AWgBqfl_/_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/svantic/RPjRh-i-AWgBqfl_/_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/svantic/RPjRh-i-AWgBqfl_/_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/svantic/RPjRh-i-AWgBqfl_/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agent card discovery - Svantic\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the public A2A-protocol-compliant agent card. This endpoint requires no authentication and is used by other agents and clients to discover capabilities, supported transports, and skills before initiating communication.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Svantic\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.svantic.com/api-reference/agents/agent-card-discovery\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://svantic.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=Agent+card+discovery\u0026amp;description=Returns+the+public+A2A-protocol-compliant+agent+card.+This+endpoint+requires+no+authentication+and+is+used+by+other+agents+and+clients+to+discover+capabilities%2C\u0026amp;theme=2470158210da7f4215f78abb\u0026amp;signature=29acfa35cb97aa72147cfe74baa6f8552b494e631d84f3add14636a91e28d462\">\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 card discovery - Svantic\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the public A2A-protocol-compliant agent card. This endpoint requires no authentication and is used by other agents and clients to discover capabilities, supported transports, and skills before initiating communication.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://svantic.mintlify.app/_mintlify/api/og/v2?division=Agents\u0026amp;title=Agent+card+discovery\u0026amp;description=Returns+the+public+A2A-protocol-compliant+agent+card.+This+endpoint+requires+no+authentication+and+is+used+by+other+agents+and+clients+to+discover+capabilities%2C\u0026amp;theme=2470158210da7f4215f78abb\u0026amp;signature=29acfa35cb97aa72147cfe74baa6f8552b494e631d84f3add14636a91e28d462\">\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/svantic/RPjRh-i-AWgBqfl_/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Svantic\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#7C3AED\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.svantic.com/api-reference/agents/agent-card-discovery\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agents/agent-card-discovery.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.svantic.com/#organization\",\"name\":\"Svantic\",\"url\":\"https://docs.svantic.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/svantic/DQEVJ_RnVW5_l6gu/images/logo_large.png?fit=max\u0026auto=format\u0026n=DQEVJ_RnVW5_l6gu\u0026q=85\u0026s=c23d1b1fd831f2dc24e9b758c0e4f930\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.svantic.com#website\",\"name\":\"Svantic\",\"url\":\"https://docs.svantic.com\",\"publisher\":{\"@id\":\"https://docs.svantic.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.svantic.com/api-reference/agents/agent-card-discovery#webpage\",\"url\":\"https://docs.svantic.com/api-reference/agents/agent-card-discovery\",\"name\":\"Agent card discovery\",\"description\":\"Returns the public A2A-protocol-compliant agent card. This endpoint requires no authentication and is used by other agents and clients to discover capabilities, supported transports, and skills before initiating communication.\",\"dateModified\":\"2026-04-27T14:39:56.773Z\",\"isPartOf\":{\"@id\":\"https://docs.svantic.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.svantic.com/api-reference/agents/agent-card-discovery#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.svantic.com/api-reference/agents/agent-card-discovery#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://docs.svantic.com/api-reference/credentials-\u0026-access/get-token\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents\",\"item\":\"https://docs.svantic.com/api-reference/agents/register-agent\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Agent card discovery\",\"item\":\"https://docs.svantic.com/api-reference/agents/agent-card-discovery\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.svantic.com/api-reference/agents/agent-card-discovery#apireference\",\"headline\":\"Agent card discovery\",\"name\":\"Agent card discovery\",\"description\":\"Returns the public A2A-protocol-compliant agent card. This endpoint requires no authentication and is used by other agents and clients to discover capabilities, supported transports, and skills before initiating communication.\",\"url\":\"https://docs.svantic.com/api-reference/agents/agent-card-discovery\",\"mainEntityOfPage\":{\"@id\":\"https://docs.svantic.com/api-reference/agents/agent-card-discovery#webpage\"},\"dateModified\":\"2026-04-27T14:39:56.773Z\",\"publisher\":{\"@id\":\"https://docs.svantic.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.svantic.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Svantic\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Svantic","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":"/what-is-svantic"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk"}]},{"tab":"CLI","pages":[{"title":"CLI","href":"/cli-reference"}]},{"tab":"API Reference","groups":[{"group":"REST API","pages":[{"group":"Credentials \u0026 Access","pages":[{"title":"Get Token","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /auth/get_token","href":"/api-reference/credentials-\u0026-access/get-token"}]},{"group":"Agents","pages":[{"title":"Register Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /agents/register","href":"/api-reference/agents/register-agent"},{"title":"Deregister Agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /agents/deregister","href":"/api-reference/agents/deregister-agent"},{"title":"Agent heartbeat","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /agents/heartbeat","href":"/api-reference/agents/agent-heartbeat"},{"title":"List agent instances","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /agents/get","href":"/api-reference/agents/list-agent-instances"},{"title":"Get agent instance detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /agents/get_by_id","href":"/api-reference/agents/get-agent-instance-detail"},{"title":"Get agent connection state","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /agents/get_connection","href":"/api-reference/agents/get-agent-connection-state"},{"title":"Aggregate agent connection counters","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /agents/get_connection_stats","href":"/api-reference/agents/aggregate-agent-connection-counters"},{"title":"Allow Agent Type","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /agents/allow_type","href":"/api-reference/agents/allow-agent-type"},{"title":"Disallow Agent Type","description":"Remove an agent type from the tenant's allow-list and cascade-deregister all running instances of that type for the tenant. After this call, new registrations of this type will be rejected when `policy_mode` is `allow-list`. Existing instances are immediately deregistered and their sessions unbound.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /agents/disallow_type","href":"/api-reference/agents/disallow-agent-type"},{"title":"Agent card discovery","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /.well-known/agent-card.json","href":"/api-reference/agents/agent-card-discovery"}]},{"group":"Messages","pages":[{"title":"Send a message (A2A JSON-RPC)","description":"Accepts JSON-RPC 2.0 requests for agent-to-agent communication within a\nsession context. Supported methods: `message/send` (synchronous) and\n`message/stream` (SSE streaming). This is the primary endpoint for all\nagent-to-agent interaction on the platform.\n","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /send","href":"/api-reference/messages/send-a-message-a2a-json-rpc"},{"title":"List pending messages (Approval Queue)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /messages/pending","href":"/api-reference/messages/list-pending-messages-approval-queue"},{"title":"Resolve a pending message","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /messages/{message_id}/resolve","href":"/api-reference/messages/resolve-a-pending-message"},{"title":"List messages for a tenant","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /messages/get","href":"/api-reference/messages/list-messages-for-a-tenant"},{"title":"Get a single message by ID","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /messages/get_by_id","href":"/api-reference/messages/get-a-single-message-by-id"},{"title":"Cancel a running message","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /messages/cancel","href":"/api-reference/messages/cancel-a-running-message"}]},{"group":"Sessions","pages":[{"title":"Interrupt in-flight streams","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /sessions/interrupt","href":"/api-reference/sessions/interrupt-in-flight-streams"},{"title":"Create a new session","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /sessions/init","href":"/api-reference/sessions/create-a-new-session"},{"title":"Close a session","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /sessions/close","href":"/api-reference/sessions/close-a-session"},{"title":"List sessions","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /sessions/get","href":"/api-reference/sessions/list-sessions"},{"title":"Get session detail","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /sessions/get_by_id","href":"/api-reference/sessions/get-session-detail"}]},{"group":"Knowledge Base","pages":[{"title":"List knowledge bases","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/get","href":"/api-reference/knowledge-base/list-knowledge-bases"},{"title":"Get a single knowledge base","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/get_by_id","href":"/api-reference/knowledge-base/get-a-single-knowledge-base"},{"title":"Create a knowledge base","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/new","href":"/api-reference/knowledge-base/create-a-knowledge-base"},{"title":"Update a knowledge base","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/update","href":"/api-reference/knowledge-base/update-a-knowledge-base"},{"title":"Delete a knowledge base","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/delete","href":"/api-reference/knowledge-base/delete-a-knowledge-base"},{"title":"Ingest a document","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/ingest","href":"/api-reference/knowledge-base/ingest-a-document"},{"title":"Semantic search","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/query","href":"/api-reference/knowledge-base/semantic-search"},{"title":"List ingested sources","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/get_sources","href":"/api-reference/knowledge-base/list-ingested-sources"},{"title":"Delete a source","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/delete_source","href":"/api-reference/knowledge-base/delete-a-source"},{"title":"Regenerate embeddings","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/refresh","href":"/api-reference/knowledge-base/regenerate-embeddings"},{"title":"Knowledge base statistics","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/get_stats","href":"/api-reference/knowledge-base/knowledge-base-statistics"},{"title":"Processing job status","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /knowledge_base/get_status","href":"/api-reference/knowledge-base/processing-job-status"}]},{"group":"Policies","pages":[{"title":"List policies","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /policies/get_policies","href":"/api-reference/policies/list-policies"},{"title":"Get a single policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /policies/get_policy_by_id","href":"/api-reference/policies/get-a-single-policy"},{"title":"Create a policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /policies/create_policy","href":"/api-reference/policies/create-a-policy"},{"title":"Update a policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /policies/update_policy","href":"/api-reference/policies/update-a-policy"},{"title":"Delete a policy","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /policies/delete_policy","href":"/api-reference/policies/delete-a-policy"},{"title":"List alert rules","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /policies/get_alerts","href":"/api-reference/policies/list-alert-rules"},{"title":"Create alert rule","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /policies/new_alert","href":"/api-reference/policies/create-alert-rule"},{"title":"Update alert rule","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /policies/update_alert","href":"/api-reference/policies/update-alert-rule"},{"title":"Delete alert rule","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /policies/delete_alert","href":"/api-reference/policies/delete-alert-rule"},{"title":"Test alert rule notifications","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /policies/test_alert","href":"/api-reference/policies/test-alert-rule-notifications"}]},{"group":"Telemetry","pages":[{"title":"List or get traces","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /telemetry/get_traces","href":"/api-reference/telemetry/list-or-get-traces"},{"title":"Usage statistics","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /telemetry/get_usage","href":"/api-reference/telemetry/usage-statistics"},{"title":"List events","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /telemetry/get_events","href":"/api-reference/telemetry/list-events"},{"title":"Stream events (SSE)","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml get /telemetry/stream_events","href":"/api-reference/telemetry/stream-events-sse"},{"title":"Event statistics","deprecated":null,"version":null,"openapi":"/api-reference/openapi-bundled.yaml post /telemetry/get_event_stats","href":"/api-reference/telemetry/event-statistics"}]}]},{"group":"WebSocket","pages":[{"title":null,"href":"/api-reference/websocket/agents-connect"}]}]}]},"title":"Agent card discovery - Svantic","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-DmVyH30O.js","utils-BHQqGGOd.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CD-E4BIt.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Bp5Lq9Ds.js","snippetPresets-C4xAVCFP.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-CBCH2P7b.js","ApiExamples-CgXVLxUC.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BF8I5oUf.js","shallow-Byd0lWnC.js","getApiPlaygroundDisplay-BGOZG1OK.js","CodeSnippet-CpvQL0CY.js","CodeSnippets-B8wkBKXa.js","getPastedJson-Ry3scI3Y.js","icon-D7a9HcdD.js","MethodPill-CJ8pmHhz.js","DuplicateIcon-rh1HJF0t.js","createIcon-DvGznqYs.js","DynamicMarkdown-Cc6AuSHS.js","SectionHeading-B4A0S-ep.js","axios-vUo_bRtp.js","Markdown-Cc16CX65.js","clsx-Cs6nMGht.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-zbf22OZA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-C_fs-y5n.js"]}