import Antimetal from '@antimetal/sdk';const client = new Antimetal({ apiKey: process.env['ANTIMETAL_API_KEY'], // This is the default and can be omitted});const queryResponse = await client.query.ask({ question: 'x' });console.log(queryResponse.conversation_id);
Sends a question to Antimetal’s AI agent and returns a natural language answer. Pass the returned conversation_id in subsequent requests to continue the conversation. Set stream: true (and Accept: text/event-stream) to receive a Server-Sent Events stream.
POST
/
query
JavaScript
import Antimetal from '@antimetal/sdk';const client = new Antimetal({ apiKey: process.env['ANTIMETAL_API_KEY'], // This is the default and can be omitted});const queryResponse = await client.query.ask({ question: 'x' });console.log(queryResponse.conversation_id);
The API version to use. Defaults to the latest stable version if omitted. Pin to the version string in this document's info.version field to opt into exactly this version's schema.
Artifacts (metrics, logs, traces, etc.) the agent found while answering
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Antimetal Docs","colors":{"primary":"#000000","light":"#DBEF01","dark":"#000000"},"logo":{"light":"https://mintcdn.com/antimetal-6e0eb43b/XAiAA5p9ZTBamQP6/logo/light.svg?fit=max\u0026auto=format\u0026n=XAiAA5p9ZTBamQP6\u0026q=85\u0026s=52f0ab22846c7008f284f9c89972e810","dark":"https://mintcdn.com/antimetal-6e0eb43b/XAiAA5p9ZTBamQP6/logo/dark.svg?fit=max\u0026auto=format\u0026n=XAiAA5p9ZTBamQP6\u0026q=85\u0026s=d88cadf304c460070d4e3ac0384745b0"},"favicon":{"light":"https://mintcdn.com/antimetal-6e0eb43b/CFzh9rnnQQ8Uttom/favicon-light.png?fit=max\u0026auto=format\u0026n=CFzh9rnnQQ8Uttom\u0026q=85\u0026s=60eeffd036c0994c7fafcdf32e4eeed9","dark":"https://mintcdn.com/antimetal-6e0eb43b/CFzh9rnnQQ8Uttom/favicon-dark.png?fit=max\u0026auto=format\u0026n=CFzh9rnnQQ8Uttom\u0026q=85\u0026s=619438a994014cf8328c76b9b9d57762"},"navbar":{"links":[{"href":"https://overlook.antimetal.com","label":"Log in"}],"primary":{"type":"button","label":"Book a Demo","href":"https://antimetal.com/demo"}},"footer":{"socials":{"x":"https://x.com/antimetal","github":"https://github.com/antimetal","linkedin":"https://www.linkedin.com/company/antimetal"}},"fonts":{"heading":{"family":"Ivar Text","source":"fonts/IvarText-Regular.woff2","format":"woff2"},"body":{"family":"ABC Diatype Plus Variable","source":"fonts/ABCDiatypePlusVariable-fixed.woff2","format":"woff2"}},"integrations":{"gtm":{"tagId":"GTM-PQ2NP8K6"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"antimetal-6e0eb43b","hasAudioNarration":false,"actualSubdomain":"antimetal-6e0eb43b","customDomains":["docs.antimetal.com"],"gitSource":{"type":"github","owner":"antimetal","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ad7a8678d6f057a41662e70","collectionId":"de62d7d2-05ec-4eb8-aa21-6f382cda1522","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ad7a8678d6f057a41662e70"},"entitlements":{},"buildId":"6ad7a8678d6f057a41662e70","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Documentation","count":25},{"language":"default","tag":"Integrations","count":17},{"language":"default","tag":"API Reference","count":9},{"language":"default","tag":"Monitoring and Observability","count":7},{"language":"default","tag":"Issues","count":7},{"language":"default","tag":"Cloud and Infrastructure","count":4},{"language":"default","tag":"Product Guide","count":4},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"Incident Management","count":2},{"language":"default","tag":"Admin","count":1}]},"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":"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":"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":"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":"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":"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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".nav-logo{height:auto;width:120px}"}],"page":{"pagePath":"api-reference/query/ask-antimetals-ai-agent-a-question","slug":"/api-reference/query/ask-antimetals-ai-agent-a-question","pageMetadata":{"title":"Ask Antimetal's AI agent a question","description":"Sends a question to Antimetal's AI agent and returns a natural language answer. Pass the returned conversation_id in subsequent requests to continue the conversation. Set stream: true (and Accept: text/event-stream) to receive a Server-Sent Events stream.","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json post /query","href":"/api-reference/query/ask-antimetals-ai-agent-a-question","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: \"Sends a question to Antimetal’s AI agent and returns a natural language answer. Pass the returned conversation_id in subsequent requests to continue the conversation. Set stream: true (and Accept: text/event-stream) to receive a Server-Sent Events stream.\"\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":"Ask Antimetal's AI agent a question","description":"Sends a question to Antimetal's AI agent and returns a natural language answer. Pass the returned conversation_id in subsequent requests to continue the conversation. Set stream: true (and Accept: text/event-stream) to receive a Server-Sent Events stream.","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json post /query","href":"/api-reference/query/ask-antimetals-ai-agent-a-question","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/antimetal-6e0eb43b/ceef065b48156a16/scripts/mintlify-oas.js"],"openApiReferenceData":{"operation":{"description":"Sends a question to Antimetal's AI agent and returns a natural language answer. Pass the returned conversation_id in subsequent requests to continue the conversation. Set stream: true (and Accept: text/event-stream) to receive a Server-Sent Events stream.","operationId":"query","parameters":["0b186ce2-604a-4f5b-bc90-5d4cd9bb4f1d"],"requestBody":"820668ab-5003-45cb-a4b9-2bd2fd1019c2","responses":{"200":"d8f05881-be79-43b7-87c3-57cf52db73c4","400":"29211a4f-8e4d-4da4-91a8-f16483b25671","401":"cd9e9aaa-3035-4e10-883b-b2965481622e","403":"925fbb97-0e9e-472e-99b5-d358b0a05e57","429":"081e803d-5aaf-425f-b48b-554213e56746","500":"75b10189-7b7a-4668-b7b5-555948e729bf"},"summary":"Ask Antimetal's AI agent a question","tags":["Query"],"x-codeSamples":[{"lang":"JavaScript","source":"import Antimetal from '@antimetal/sdk';\n\nconst client = new Antimetal({\n apiKey: process.env['ANTIMETAL_API_KEY'], // This is the default and can be omitted\n});\n\nconst queryResponse = await client.query.ask({ question: 'x' });\n\nconsole.log(queryResponse.conversation_id);"}],"method":"post","type":"path","servers":["4e2de73c-8a30-4855-8a85-a6930efff0a2","d44dcd43-2220-46b0-962c-bd92f92e95b9"],"security":["7ded91c4-fb30-4a61-9f84-f1849403592d"],"path":"/query","baseUrlOptions":["https://bff.antimetal.com/api/v2","https://bff.dev.antimetal.com/api/v2"],"title":"Ask Antimetal's AI agent a question","codeSamples":[{"lang":"JavaScript","source":"import Antimetal from '@antimetal/sdk';\n\nconst client = new Antimetal({\n apiKey: process.env['ANTIMETAL_API_KEY'], // This is the default and can be omitted\n});\n\nconst queryResponse = await client.query.ask({ question: 'x' });\n\nconsole.log(queryResponse.conversation_id);"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"0b186ce2-604a-4f5b-bc90-5d4cd9bb4f1d":{"name":"Antimetal-Version","in":"header","required":false,"description":"The API version to use. Defaults to the latest stable version if omitted. Pin to the version string in this document's `info.version` field to opt into exactly this version's schema.","schema":{"type":"string","example":"2026-03-17","default":"2026-03-17","isRequired":false,"description":"The API version to use. Defaults to the latest stable version if omitted. Pin to the version string in this document's `info.version` field to opt into exactly this version's schema.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"question":{"type":"string","minLength":1,"description":"Natural language question to ask the AI agent","isRequired":true,"uniqueKey":"question","typeLabel":"string"},"conversation_id":{"description":"Conversation ID from a previous query response — pass to continue that conversation","type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","uniqueKey":"conversation_id","typeLabel":"string\u003cuuid>"},"stream":{"description":"When true, returns a Server-Sent Events stream. Must also send Accept: text/event-stream header.","type":"boolean","uniqueKey":"stream","typeLabel":"boolean"}},"required":["question"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"question":"\u003cstring>","conversation_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","stream":true}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"d8f05881-be79-43b7-87c3-57cf52db73c4":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"conversation_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$","description":"Pass in subsequent requests to continue this conversation","isRequired":true,"uniqueKey":"conversation_id","typeLabel":"string\u003cuuid>"},"answer":{"type":"string","description":"The AI agent's natural language answer","isRequired":true,"uniqueKey":"answer","typeLabel":"string"},"artifacts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Artifact document ID, e.g. 'metric:datadog:abc123'","isRequired":true,"uniqueKey":"artifacts.items.[INDEX].id","typeLabel":"string"},"tool_name":{"type":"string","description":"Name of the tool that produced this artifact","isRequired":true,"uniqueKey":"artifacts.items.[INDEX].tool_name","typeLabel":"string"},"data_type":{"description":"Artifact data type: metric, log, trace, file, event, topology","type":"string","uniqueKey":"artifacts.items.[INDEX].data_type","typeLabel":"string"},"provider":{"description":"Provider: datadog, gcp, github, etc.","type":"string","uniqueKey":"artifacts.items.[INDEX].provider","typeLabel":"string"},"summary":{"description":"Brief description from tool output","type":"string","uniqueKey":"artifacts.items.[INDEX].summary","typeLabel":"string"}},"required":["id","tool_name"],"uniqueKey":"artifacts.items.[INDEX]","typeLabel":"object"},"description":"Artifacts (metrics, logs, traces, etc.) the agent found while answering","isRequired":true,"uniqueKey":"artifacts","typeLabel":"object[]"}},"required":["conversation_id","answer","artifacts"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"conversation_id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","answer":"\u003cstring>","artifacts":[{"id":"\u003cstring>","tool_name":"\u003cstring>","data_type":"\u003cstring>","provider":"\u003cstring>","summary":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"29211a4f-8e4d-4da4-91a8-f16483b25671":{"description":"Validation error or bad request","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["api_error","invalid_request_error","authentication_error"],"description":"Error type classification","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","description":"Request correlation ID for tracing and support","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"details":{"description":"Detailed field-level validation errors (for 400/422 responses)","type":"object","additionalProperties":{"type":"string","uniqueKey":"details.additionalProperties","typeLabel":"string"},"uniqueKey":"details","typeLabel":"object"}},"required":["type","message","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"api_error","message":"\u003cstring>","request_id":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"cd9e9aaa-3035-4e10-883b-b2965481622e":{"description":"Authentication required","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["api_error","invalid_request_error","authentication_error"],"description":"Error type classification","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","description":"Request correlation ID for tracing and support","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"details":{"description":"Detailed field-level validation errors (for 400/422 responses)","type":"object","additionalProperties":{"type":"string","uniqueKey":"details.additionalProperties","typeLabel":"string"},"uniqueKey":"details","typeLabel":"object"}},"required":["type","message","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"api_error","message":"\u003cstring>","request_id":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"925fbb97-0e9e-472e-99b5-d358b0a05e57":{"description":"Insufficient permissions","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["api_error","invalid_request_error","authentication_error"],"description":"Error type classification","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","description":"Request correlation ID for tracing and support","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"details":{"description":"Detailed field-level validation errors (for 400/422 responses)","type":"object","additionalProperties":{"type":"string","uniqueKey":"details.additionalProperties","typeLabel":"string"},"uniqueKey":"details","typeLabel":"object"}},"required":["type","message","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"api_error","message":"\u003cstring>","request_id":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"081e803d-5aaf-425f-b48b-554213e56746":{"description":"Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["api_error","invalid_request_error","authentication_error"],"description":"Error type classification","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","description":"Request correlation ID for tracing and support","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"details":{"description":"Detailed field-level validation errors (for 400/422 responses)","type":"object","additionalProperties":{"type":"string","uniqueKey":"details.additionalProperties","typeLabel":"string"},"uniqueKey":"details","typeLabel":"object"}},"required":["type","message","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"api_error","message":"\u003cstring>","request_id":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"},"75b10189-7b7a-4668-b7b5-555948e729bf":{"description":"Internal server error","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["api_error","invalid_request_error","authentication_error"],"description":"Error type classification","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"Human-readable error message","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"request_id":{"type":"string","description":"Request correlation ID for tracing and support","isRequired":true,"uniqueKey":"request_id","typeLabel":"string"},"details":{"description":"Detailed field-level validation errors (for 400/422 responses)","type":"object","additionalProperties":{"type":"string","uniqueKey":"details.additionalProperties","typeLabel":"string"},"uniqueKey":"details","typeLabel":"object"}},"required":["type","message","request_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"api_error","message":"\u003cstring>","request_id":"\u003cstring>","details":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"7ded91c4-fb30-4a61-9f84-f1849403592d":{"bearer":{"type":"http","scheme":"bearer","description":"API key authentication via Bearer token","scopes":[]}}},"servers":{"4e2de73c-8a30-4855-8a85-a6930efff0a2":{"url":"https://bff.antimetal.com/api/v2","description":"Production API"},"d44dcd43-2220-46b0-962c-bd92f92e95b9":{"url":"https://bff.dev.antimetal.com/api/v2","description":"Dev API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"API key authentication via Bearer token","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API key authentication via Bearer token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"assets/openapi.mintlify.json"},"subdomain":"antimetal-6e0eb43b","siteName":"Antimetal Docs","title":"Ask Antimetal's AI agent a question - Antimetal Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-03-18T21:30:14.206Z","originalFileLocation":"api-reference/query/ask-antimetals-ai-agent-a-question.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Sends a question to Antimetal\u0026#x27;s AI agent and returns a natural language answer. Pass the returned conversation_id in subsequent requests to continue the conversation. Set stream: true (and Accept: text/event-stream) to receive a Server-Sent Events stream.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Antimetal Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/antimetal-6e0eb43b/oip41hv9cmCnEFu3/_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/antimetal-6e0eb43b/oip41hv9cmCnEFu3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/antimetal-6e0eb43b/oip41hv9cmCnEFu3/_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/antimetal-6e0eb43b/oip41hv9cmCnEFu3/_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/antimetal-6e0eb43b/oip41hv9cmCnEFu3/_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/antimetal-6e0eb43b/oip41hv9cmCnEFu3/_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/antimetal-6e0eb43b/oip41hv9cmCnEFu3/_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/antimetal-6e0eb43b/oip41hv9cmCnEFu3/_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/antimetal-6e0eb43b/oip41hv9cmCnEFu3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Ask Antimetal\u0026#x27;s AI agent a question - Antimetal Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Sends a question to Antimetal\u0026#x27;s AI agent and returns a natural language answer. Pass the returned conversation_id in subsequent requests to continue the conversation. Set stream: true (and Accept: text/event-stream) to receive a Server-Sent Events stream.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Antimetal Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.antimetal.com/api-reference/query/ask-antimetals-ai-agent-a-question\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://antimetal-6e0eb43b.mintlify.app/_mintlify/api/og/v2?division=Query\u0026amp;title=Ask+Antimetal%27s+AI+agent+a+question\u0026amp;description=Sends+a+question+to+Antimetal%27s+AI+agent+and+returns+a+natural+language+answer.+Pass+the+returned+conversation_id+in+subsequent+requests+to+continue+the+convers\u0026amp;theme=aae104420d39820222bfe70d\u0026amp;signature=34c72dd95e6819d705e9624afd80ff76b521cd081da8db64e21d62d7e64399a8\">\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=\"Ask Antimetal\u0026#x27;s AI agent a question - Antimetal Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Sends a question to Antimetal\u0026#x27;s AI agent and returns a natural language answer. Pass the returned conversation_id in subsequent requests to continue the conversation. Set stream: true (and Accept: text/event-stream) to receive a Server-Sent Events stream.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://antimetal-6e0eb43b.mintlify.app/_mintlify/api/og/v2?division=Query\u0026amp;title=Ask+Antimetal%27s+AI+agent+a+question\u0026amp;description=Sends+a+question+to+Antimetal%27s+AI+agent+and+returns+a+natural+language+answer.+Pass+the+returned+conversation_id+in+subsequent+requests+to+continue+the+convers\u0026amp;theme=aae104420d39820222bfe70d\u0026amp;signature=34c72dd95e6819d705e9624afd80ff76b521cd081da8db64e21d62d7e64399a8\">\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/antimetal-6e0eb43b/oip41hv9cmCnEFu3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Antimetal Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.antimetal.com/api-reference/query/ask-antimetals-ai-agent-a-question\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/query/ask-antimetals-ai-agent-a-question.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.antimetal.com/#organization\",\"name\":\"Antimetal Docs\",\"url\":\"https://docs.antimetal.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/antimetal-6e0eb43b/XAiAA5p9ZTBamQP6/logo/light.svg?fit=max\u0026auto=format\u0026n=XAiAA5p9ZTBamQP6\u0026q=85\u0026s=52f0ab22846c7008f284f9c89972e810\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.antimetal.com#website\",\"name\":\"Antimetal Docs\",\"url\":\"https://docs.antimetal.com\",\"publisher\":{\"@id\":\"https://docs.antimetal.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.antimetal.com/api-reference/query/ask-antimetals-ai-agent-a-question#webpage\",\"url\":\"https://docs.antimetal.com/api-reference/query/ask-antimetals-ai-agent-a-question\",\"name\":\"Ask Antimetal's AI agent a question\",\"description\":\"Sends a question to Antimetal's AI agent and returns a natural language answer. Pass the returned conversation_id in subsequent requests to continue the conversation. Set stream: true (and Accept: text/event-stream) to receive a Server-Sent Events stream.\",\"dateModified\":\"2026-03-18T21:30:14.206Z\",\"isPartOf\":{\"@id\":\"https://docs.antimetal.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.antimetal.com/api-reference/query/ask-antimetals-ai-agent-a-question#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.antimetal.com/api-reference/query/ask-antimetals-ai-agent-a-question#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Antimetal Docs\",\"item\":\"https://docs.antimetal.com\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ask Antimetal's AI agent a question\",\"item\":\"https://docs.antimetal.com/api-reference/query/ask-antimetals-ai-agent-a-question\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.antimetal.com/api-reference/query/ask-antimetals-ai-agent-a-question#apireference\",\"headline\":\"Ask Antimetal's AI agent a question\",\"name\":\"Ask Antimetal's AI agent a question\",\"description\":\"Sends a question to Antimetal's AI agent and returns a natural language answer. Pass the returned conversation_id in subsequent requests to continue the conversation. Set stream: true (and Accept: text/event-stream) to receive a Server-Sent Events stream.\",\"url\":\"https://docs.antimetal.com/api-reference/query/ask-antimetals-ai-agent-a-question\",\"mainEntityOfPage\":{\"@id\":\"https://docs.antimetal.com/api-reference/query/ask-antimetals-ai-agent-a-question#webpage\"},\"dateModified\":\"2026-03-18T21:30:14.206Z\",\"publisher\":{\"@id\":\"https://docs.antimetal.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.antimetal.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Antimetal Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Antimetal Docs","nav":{"global":{},"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Issues","pages":[{"title":"Fetch issues for an organization","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json get /issues","href":"/api-reference/issues/fetch-issues-for-an-organization"},{"title":"Create a new issue","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json post /issues","href":"/api-reference/issues/create-a-new-issue"},{"title":"Fetch issue by number","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json get /issues/by_number/{number}","href":"/api-reference/issues/fetch-issue-by-number"},{"title":"Fetch an issue by ID (UUID)","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json get /issues/{id}","href":"/api-reference/issues/fetch-an-issue-by-id-uuid"},{"title":"Delete an issue","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json delete /issues/{id}","href":"/api-reference/issues/delete-an-issue"},{"title":"Update issue status by ID (UUID)","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json patch /issues/{id}","href":"/api-reference/issues/update-issue-status-by-id-uuid"},{"title":"Fetch investigation results by ID (UUID)","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json get /issues/{id}/results","href":"/api-reference/issues/fetch-investigation-results-by-id-uuid"}]},{"group":"Artifacts","pages":[{"title":"Retrieve artifacts by IDs","description":"Fetches multiple evidential artifacts by their IDs. Supports up to 100 IDs per request.","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json get /artifacts","href":"/api-reference/artifacts/retrieve-artifacts-by-ids"}]},{"group":"Query","pages":[{"title":"Ask Antimetal's AI agent a question","deprecated":null,"version":null,"openapi":"/assets/openapi.mintlify.json post /query","href":"/api-reference/query/ask-antimetals-ai-agent-a-question"}]}]}]},"basePath":"","title":"Ask Antimetal's AI agent a question - Antimetal Docs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}