{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Maia Documentation","colors":{"primary":"#001f1d","light":"#20514e","dark":"#001f1d"},"logo":{"light":"https://mintcdn.com/matillion/GyuNBHAx-GXnVlKX/images/maia-by-matillion-light.svg?fit=max\u0026auto=format\u0026n=GyuNBHAx-GXnVlKX\u0026q=85\u0026s=2c48b854f858c5a835450b3f34360db7","dark":"https://mintcdn.com/matillion/GyuNBHAx-GXnVlKX/images/maia-by-matillion-dark.svg?fit=max\u0026auto=format\u0026n=GyuNBHAx-GXnVlKX\u0026q=85\u0026s=88f8d1e1b1931cefd35c233a56cafe0a","href":"https://docs.maia.ai/"},"favicon":{"light":"https://mintcdn.com/matillion/0xM0A92Owv1nZXX1/images/maia-favicon-dark-green.png?fit=max\u0026auto=format\u0026n=0xM0A92Owv1nZXX1\u0026q=85\u0026s=356295fc83c5c6d1ed4aac2573ae45b1","dark":"https://mintcdn.com/matillion/0xM0A92Owv1nZXX1/images/maia-favicon-white.png?fit=max\u0026auto=format\u0026n=0xM0A92Owv1nZXX1\u0026q=85\u0026s=8709fc6d370155352cb6a4b5bbdd59d6"},"appearance":{"default":"light","strict":true},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://support.matillion.com/s/","label":"Support"}],"primary":{"type":"button","label":"Book your Maia demo","href":"https://www.maia.ai/book-a-demo"}},"footer":{"socials":{"x":"https://x.com/matillion","facebook":"https://www.facebook.com/matillion","youtube":"https://www.youtube.com/user/MatillionVideos","linkedin":"https://www.linkedin.com/company/matillion-limited","instagram":"https://www.instagram.com/matillion_"},"links":[{"header":"Maia","items":[{"label":"Maia.ai","href":"https://maia.ai"},{"label":"Academy","href":"https://academy.matillion.com"},{"label":"Exchange","href":"https://exchange.matillion.com/"},{"label":"Roadmap","href":"https://roadmap.matillion.com/"},{"label":"Support","href":"https://support.matillion.com/s"},{"label":"YouTube","href":"https://www.youtube.com/@Matillion"}]},{"header":"Matillion","items":[{"label":"Matillion.com","href":"https://matillion.com"},{"label":"Status","href":"https://status.matillion.com/"},{"label":"News","href":"https://www.matillion.com/news"},{"label":"Legal","href":"https://www.matillion.com/legal"},{"label":"Trust Center","href":"https://www.matillion.com/trust-center"}]}]},"seo":{"metatags":{"google-site-verification":"0VLXGRESICGHnU66TdhEgUMBRRubPnW8JTkzOpiiNn0"}},"fonts":{"heading":{"family":"Inter, system-ui"},"body":{"family":"Inter, system-ui"}},"integrations":{"ga4":{"measurementId":"G-6T2W93NTXW"},"posthog":{"apiKey":"phc_ky6YtuQApuXUkdApnVTY5PrjvnHx7EQGtYyRVSd9G535","apiHost":"https://us.i.posthog.com"}},"contextual":{"options":["claude","chatgpt","perplexity","copy","view"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"matillion","hasAudioNarration":false,"actualSubdomain":"matillion","customDomains":["docs.maia.ai"],"gitSource":{"type":"github","owner":"matillion","repo":"maia-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af1fb5dca20d619cf50c261","clientVersion":"0.0.4094","searchFilterCounts":[{"language":"default","tag":"Components","count":355},{"language":"default","tag":"Guides","count":208},{"language":"default","tag":"Connectors","count":188},{"language":"default","tag":"API Reference","count":128},{"language":"default","tag":"Endpoints","count":113},{"language":"default","tag":"Orchestration","count":93},{"language":"default","tag":"Admin","count":71},{"language":"default","tag":"Transformation","count":69},{"language":"default","tag":"Runners","count":51},{"language":"default","tag":"Streaming","count":34}],"searchSettings":{"showContentSnippets":false}},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"#navbar .bg-background-light,#navbar .bg-background-dark{background-color:#001f1d!important}#navbar a,#navbar button,#navbar span,#navbar p{color:white!important}#navbar svg{color:white!important;stroke:white!important}#navbar #topbar-cta-button a,#navbar #topbar-cta-button a span,#navbar #topbar-cta-button svg{color:#001f1d!important}#navbar #topbar-cta-button a{font-weight:600!important}:root:not(.dark) #search-bar-entry,:root:not(.dark) #nav-anchor,:root:not(.dark) #navbar .navbar-link,:root:not(.dark) .nav-anchor{background-color:#0a3d39!important;border-radius:9999px!important}#topbar-cta-button a span.bg-primary-dark{background:#ffc700!important;border-radius:9999px!important}#navbar svg.bg-gray-500{background-color:white!important}#navbar button.lg\\:hidden div.font-semibold{color:white!important}#navbar button.lg\\:hidden div.text-gray-500 svg{color:white!important;stroke:white!important}#navbar img.nav-logo{content:url('/images/maia-by-matillion-light.svg');height:50px!important;width:auto!important}#footer img.nav-logo{content:url('/images/maia-by-matillion-dark.svg');height:80px!important;width:auto!important}#pagination{display:none}#navigation-items>div{padding-bottom:4rem!important}#navbar a[data-active=\"true\"] div.h-px{height:4px!important;background-color:#ffc700!important;border-radius:9999px!important}[id^=\"headlessui-dialog-panel\"] .navbar-link a{color:white!important}[id^=\"headlessui-dialog-panel\"] nav{padding-top:2.5rem}.accordion{width:100%!important;overflow-x:auto!important}.accordion>div{padding-left:1.375rem!important;padding-right:0!important}.accordion>div[class*=\"overflow\"],.accordion>div>div[class*=\"overflow\"]{overflow:visible!important}@media (min-width: 1920px){body:has(#navbar.is-not-custom) #body-content{max-width:2000px!important}body:has(#navbar.is-not-custom) #content-container{max-width:1650px!important}body:has(#navbar.is-not-custom) #navbar .max-w-8xl{max-width:2000px!important}}body:has(#navbar.is-not-custom) #content{zoom:var(--maia-content-zoom, 100%)}body:has(#navbar.is-not-custom) #content-area>#content+div:has(>p+a){zoom:var(--maia-content-zoom, 100%)}#content-area>#content+div:has(>p+a)>p{font-size:1.5rem;line-height:2rem;font-weight:600;letter-spacing:normal;color:#101828;margin-bottom:0.5rem}.dark #content-area>#content+div:has(>p+a)>p{color:inherit}#content-area>#content+div:has(>p+a)>a{font-size:1rem;line-height:1.75rem}"},{"filePath":"new-features-blog/new-features-blog.css","content":".fos-background-container{position:fixed;top:0;left:0;height:100vh;width:100vw;background:#fff3d1;z-index:-1;background-size:cover}.fos-post-page-container{background-color:#fff;border-radius:20px;padding:20px!important}.fos-roadmap-page-container{background-color:#fff;border-radius:20px;width:95%}@media (min-width: 1024px){.fos-roadmap-page-container{width:70%;margin:0 auto}}.fos-changelog-page-container{background-color:#fff;border-radius:20px}.banner-title,.fos-header-banner-title{color:#00524E;font-size:4rem;font-weight:700;font-family:'Inter', sans-serif}.banner-subtitle,.fos-header-banner-subtitle{color:#001F1D;font-size:1.1487em;margin-top:0.5em;margin-bottom:2em}.fos-header-boards-trigger,.fos-header-roadmap-trigger,.fos-header-changelog-trigger{display:none}.fos-user-side-header{color:white;font-family:'Inter', sans-serif}.fos-header-container{background-color:#001f1d;box-shadow:0px 1px 13px #bfbfbf}.fos-header-boards-dropdown-content span{color:white}.fos-header-links-container{justify-content:center;gap:1em}.fos-header-link{color:white;font-size:14px!important;font-weight:bold;padding:10px 0}.fos-header-logo-container{display:flex}.fos-header-logo-image{width:100px}.fos-header-boards-link{color:white;font-size:16px;padding:10px 0;font-weight:bold}.fos-header-link-icon{color:white}"}],"page":{"pagePath":"api-reference/ai-agent-tasks/get-an-ai-agent-task","slug":"/api-reference/ai-agent-tasks/get-an-ai-agent-task","pageMetadata":{"title":"Get an AI Agent Task","description":"Returns the details of a specific AI agent task including its current status and pending decisions.","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/ai/agents/tasks/{taskId}","href":"/api-reference/ai-agent-tasks/get-an-ai-agent-task","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 details of a specific AI agent task including its current status and pending decisions.\"\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":"Get an AI Agent Task","description":"Returns the details of a specific AI agent task including its current status and pending decisions.","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/ai/agents/tasks/{taskId}","href":"/api-reference/ai-agent-tasks/get-an-ai-agent-task","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/matillion/1eecfe13cb8a36b9/scripts/feedback-widget.js","/_mintlify/custom/matillion/b8b092d8d394af0f/scripts/ga4-events.js","/_mintlify/custom/matillion/5baf5b38fe34f41f/scripts/iubenda.js","/_mintlify/custom/matillion/573540f1e9142d9c/scripts/kapa-widget.js","/_mintlify/custom/matillion/a52101786f42c23b/scripts/ph-pageleaves.js","/_mintlify/custom/matillion/b8f0431aaf9ef855/scripts/cookie-preferences-button.js","/_mintlify/custom/matillion/a3d31738f4c89949/scripts/status-badge-nav.js","/_mintlify/custom/matillion/b444958fcc79163d/scripts/text-size-slider.js","/_mintlify/custom/matillion/f7016c1e98f77080/scripts/posthog-events.js"],"openApiReferenceData":{"operation":{"description":"Returns the details of a specific AI agent task including its current status and pending decisions.","operationId":"getTask","parameters":["43854387-1fee-4109-846c-939be3efbb77"],"responses":{"200":"91186b6b-d781-4a78-a990-40734b72f273","400":"d7f9a0eb-4e58-4e06-bc9a-04d10c22668c","401":"3c0fcf90-114c-4934-a012-a52b6132c709","403":"b6b66910-3131-4c91-94f4-805959ed5eae","404":"000af1bf-f646-43da-a056-4dfd8cd0173d","502":"ce3fa4a6-720e-419f-a59b-0759ec33894a","504":"fa646b0d-bfe2-45d4-89e2-c35a9ba8d4c5"},"summary":"Get an AI Agent Task","tags":["AI Agent Tasks"],"method":"get","type":"path","servers":["08bbfe32-450a-42b2-adcc-acc48eea493b","166cdd47-0728-4c76-b52d-b5f111bd302d","bacb5af1-61e1-4bff-9d98-80c70c79bfc3","13085271-9ff9-4f1d-93de-efccbb116aae"],"security":["184c1d82-84dc-4226-ae3c-1d927b6b8b0c"],"path":"/v1/ai/agents/tasks/{taskId}","baseUrlOptions":["https://eu1.api.matillion.com/dpc","https://us1.api.matillion.com/dpc","https://au1.api.matillion.com/dpc","https://eu2.api.matillion.com/dpc"],"title":"Get an AI Agent Task","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"43854387-1fee-4109-846c-939be3efbb77":{"in":"path","name":"taskId","required":true,"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"91186b6b-d781-4a78-a990-40734b72f273":{"content":{"application/json":{"examples":{"Agent task details":{"title":"Agent task details","description":"Example response for a successfully retrieved agent task","value":{"taskId":"550e8400-e29b-41d4-a716-446655440000","status":"STOPPED","description":"Build a pipeline to load sales data","createdAt":"2024-01-15T10:30:00.000Z","modifiedAt":"2024-01-15T10:45:00.000Z","agentConfig":{"name":"data_engineer_agent","mode":"ACT","projectId":"550e8400-e29b-41d4-a716-446655440001","sourceBranchName":"main","environmentName":"development"},"grantedPermissions":[],"pendingDecisions":[]}}},"schema":{"type":"object","properties":{"agentConfig":{"type":"object","description":"The configuration of the agent handling the task","required":["environmentName","mode","name","projectId","sourceBranchName"],"properties":{"name":{"type":"string","description":"The agent type identifier. Must be \"data_engineer_agent\"","minLength":1,"example":"data_engineer_agent","isRequired":true,"uniqueKey":"agentConfig.name","typeLabel":"string"},"environmentName":{"type":"string","description":"The name of the environment to use for execution","example":"development","minLength":1,"isRequired":true,"uniqueKey":"agentConfig.environmentName","typeLabel":"string"},"mode":{"type":"string","description":"The execution mode. ACT allows the agent to make changes; PLAN produces a plan only","enum":["PLAN","ACT"],"example":"ACT","isRequired":true,"uniqueKey":"agentConfig.mode","typeLabel":"enum\u003cstring>"},"projectId":{"type":"string","format":"uuid","description":"The ID of the project the agent will work within","example":"550e8400-e29b-41d4-a716-446655440001","isRequired":true,"uniqueKey":"agentConfig.projectId","typeLabel":"string\u003cuuid>"},"sourceBranchName":{"type":"string","description":"The branch the agent will read from","example":"main","minLength":1,"isRequired":true,"uniqueKey":"agentConfig.sourceBranchName","typeLabel":"string"},"generateBranch":{"type":"boolean","description":"Whether the agent should auto-generate a new branch for its changes","example":true,"uniqueKey":"agentConfig.generateBranch","typeLabel":"boolean"},"graphId":{"oneOf":[{"type":"string","description":"The ID of the pipeline graph the agent will work on","example":"my-pipeline","uniqueKey":"agentConfig.graphId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The ID of the pipeline graph the agent will work on","example":"my-pipeline","uniqueKey":"agentConfig.graphId.oneOf.1","typeLabel":"null"}],"uniqueKey":"agentConfig.graphId","typeLabel":"string | null"},"targetBranchName":{"oneOf":[{"type":"string","description":"The branch the agent will write changes to. Required unless generateBranch is true","example":"feature/my-pipeline","uniqueKey":"agentConfig.targetBranchName.oneOf.0","typeLabel":"string"},{"type":"null","description":"The branch the agent will write changes to. Required unless generateBranch is true","example":"feature/my-pipeline","uniqueKey":"agentConfig.targetBranchName.oneOf.1","typeLabel":"null"}],"uniqueKey":"agentConfig.targetBranchName","typeLabel":"string | null"},"workingDirectory":{"oneOf":[{"type":"string","description":"The working directory within the project for the agent","example":"/pipelines","uniqueKey":"agentConfig.workingDirectory.oneOf.0","typeLabel":"string"},{"type":"null","description":"The working directory within the project for the agent","example":"/pipelines","uniqueKey":"agentConfig.workingDirectory.oneOf.1","typeLabel":"null"}],"uniqueKey":"agentConfig.workingDirectory","typeLabel":"string | null"}},"uniqueKey":"agentConfig","typeLabel":"object"},"createdAt":{"type":"string","format":"date-time","description":"The date and time the task was created","example":"2024-01-15T10:30:00.000Z","uniqueKey":"createdAt","typeLabel":"string\u003cdate-time>"},"description":{"type":"string","description":"A short description of what the agent was asked to do","example":"Build a pipeline to load sales data from S3 into Snowflake","uniqueKey":"description","typeLabel":"string"},"grantedPermissions":{"type":"array","description":"Permissions that have been granted to the agent for this task","items":{"type":"object","properties":{"toolName":{"type":"string","description":"The name of the tool to allow","example":"execute_sql","minLength":1,"isRequired":true,"uniqueKey":"grantedPermissions.items.[INDEX].toolName","typeLabel":"string"}},"required":["toolName"],"uniqueKey":"grantedPermissions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"grantedPermissions","typeLabel":"object[]"},"modifiedAt":{"type":"string","format":"date-time","description":"The date and time the task was last modified","example":"2024-01-15T10:45:00.000Z","uniqueKey":"modifiedAt","typeLabel":"string\u003cdate-time>"},"pendingDecisions":{"type":"array","description":"Decisions awaiting approval before the agent can proceed","items":{"type":"object","properties":{"permissionMessage":{"type":"object","properties":{"body":{"type":"string","description":"A detailed description of the permission being requested","example":"The agent wants to run: SELECT * FROM sales","uniqueKey":"pendingDecisions.items.[INDEX].permissionMessage.body","typeLabel":"string"},"title":{"type":"string","description":"A short title summarising the permission request","example":"Execute SQL query","uniqueKey":"pendingDecisions.items.[INDEX].permissionMessage.title","typeLabel":"string"}},"description":"Human-readable details about the permission being requested","uniqueKey":"pendingDecisions.items.[INDEX].permissionMessage","typeLabel":"object"},"toolId":{"type":"string","description":"The unique identifier of the tool invocation","example":"call_abc123","uniqueKey":"pendingDecisions.items.[INDEX].toolId","typeLabel":"string"},"toolInput":{"description":"The input the tool will use if permission is granted","uniqueKey":"pendingDecisions.items.[INDEX].toolInput","typeLabel":"any"},"toolName":{"type":"string","description":"The name of the tool requesting permission","example":"execute_sql","uniqueKey":"pendingDecisions.items.[INDEX].toolName","typeLabel":"string"},"type":{"type":"string","description":"The type of decision required","enum":["tool","question"],"example":"tool","uniqueKey":"pendingDecisions.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"pendingDecisions.items.[INDEX]","typeLabel":"object"},"uniqueKey":"pendingDecisions","typeLabel":"object[]"},"status":{"type":"string","description":"The current status of the task","enum":["RUNNING","STOPPED","STOPPING","ERRORED"],"example":"STOPPED","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"taskId":{"type":"string","format":"uuid","description":"The unique identifier of the task","example":"550e8400-e29b-41d4-a716-446655440000","uniqueKey":"taskId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Agent task retrieved successfully","exampleType":"examples"},"d7f9a0eb-4e58-4e06-bc9a-04d10c22668c":{"content":{"application/problem+json":{"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"status":{"type":"integer","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"violations":{"type":"array","items":{"type":"string","uniqueKey":"violations.items.[INDEX]","typeLabel":"string"},"uniqueKey":"violations","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","instance":"\u003cstring>","status":123,"title":"\u003cstring>","type":"\u003cstring>","violations":["\u003cstring>"]}}},"exampleType":"generated"}},"description":"Invalid request parameters","exampleType":"generated"},"3c0fcf90-114c-4934-a012-a52b6132c709":{"content":{"application/problem+json":{"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"status":{"type":"integer","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"violations":{"type":"array","items":{"type":"string","uniqueKey":"violations.items.[INDEX]","typeLabel":"string"},"uniqueKey":"violations","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","instance":"\u003cstring>","status":123,"title":"\u003cstring>","type":"\u003cstring>","violations":["\u003cstring>"]}}},"exampleType":"generated"}},"description":"Missing or invalid authentication token","exampleType":"generated"},"b6b66910-3131-4c91-94f4-805959ed5eae":{"content":{"application/problem+json":{"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"status":{"type":"integer","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"violations":{"type":"array","items":{"type":"string","uniqueKey":"violations.items.[INDEX]","typeLabel":"string"},"uniqueKey":"violations","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","instance":"\u003cstring>","status":123,"title":"\u003cstring>","type":"\u003cstring>","violations":["\u003cstring>"]}}},"exampleType":"generated"}},"description":"Insufficient permissions to retrieve the agent task","exampleType":"generated"},"000af1bf-f646-43da-a056-4dfd8cd0173d":{"content":{"application/problem+json":{"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"status":{"type":"integer","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"violations":{"type":"array","items":{"type":"string","uniqueKey":"violations.items.[INDEX]","typeLabel":"string"},"uniqueKey":"violations","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","instance":"\u003cstring>","status":123,"title":"\u003cstring>","type":"\u003cstring>","violations":["\u003cstring>"]}}},"exampleType":"generated"}},"description":"Task not found","exampleType":"generated"},"ce3fa4a6-720e-419f-a59b-0759ec33894a":{"content":{"application/problem+json":{"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"status":{"type":"integer","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"violations":{"type":"array","items":{"type":"string","uniqueKey":"violations.items.[INDEX]","typeLabel":"string"},"uniqueKey":"violations","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","instance":"\u003cstring>","status":123,"title":"\u003cstring>","type":"\u003cstring>","violations":["\u003cstring>"]}}},"exampleType":"generated"}},"description":"Upstream service error","exampleType":"generated"},"fa646b0d-bfe2-45d4-89e2-c35a9ba8d4c5":{"content":{"application/problem+json":{"schema":{"type":"object","properties":{"detail":{"type":"string","uniqueKey":"detail","typeLabel":"string"},"instance":{"type":"string","uniqueKey":"instance","typeLabel":"string"},"status":{"type":"integer","format":"int32","uniqueKey":"status","typeLabel":"integer\u003cint32>"},"title":{"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"type":"string","format":"uri","uniqueKey":"type","typeLabel":"string\u003curi>"},"violations":{"type":"array","items":{"type":"string","uniqueKey":"violations.items.[INDEX]","typeLabel":"string"},"uniqueKey":"violations","typeLabel":"string[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"\u003cstring>","instance":"\u003cstring>","status":123,"title":"\u003cstring>","type":"\u003cstring>","violations":["\u003cstring>"]}}},"exampleType":"generated"}},"description":"Upstream service timeout","exampleType":"generated"}},"security":{"184c1d82-84dc-4226-ae3c-1d927b6b8b0c":{"bearerAuth":{"bearerFormat":"JWT","description":"a valid bearer token","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"08bbfe32-450a-42b2-adcc-acc48eea493b":{"description":"EU1","url":"https://eu1.api.matillion.com/dpc"},"166cdd47-0728-4c76-b52d-b5f111bd302d":{"description":"US1","url":"https://us1.api.matillion.com/dpc"},"bacb5af1-61e1-4bff-9d98-80c70c79bfc3":{"description":"AU1","url":"https://au1.api.matillion.com/dpc"},"13085271-9ff9-4f1d-93de-efccbb116aae":{"description":"EU2","url":"https://eu2.api.matillion.com/dpc"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"bearerFormat":"JWT","description":"a valid bearer token","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"a valid bearer token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"openapi/public-api-endpoint-reference.yaml"},"subdomain":"matillion","siteName":"Maia Documentation","title":"Get an AI Agent Task - Maia Documentation","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"manual"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T16:51:11.679Z","originalFileLocation":"api-reference/ai-agent-tasks/get-an-ai-agent-task.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 details of a specific AI agent task including its current status and pending decisions.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Maia Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_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/matillion/eb7R3mt9l7P1vThW/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get an AI Agent Task - Maia Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns the details of a specific AI agent task including its current status and pending decisions.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Maia Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.maia.ai/api-reference/ai-agent-tasks/get-an-ai-agent-task\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://matillion.mintlify.site/_mintlify/api/og/v2?division=AI+Agent+Tasks\u0026amp;title=Get+an+AI+Agent+Task\u0026amp;description=Returns+the+details+of+a+specific+AI+agent+task+including+its+current+status+and+pending+decisions.\u0026amp;theme=ce57a3e3dfd574362d42229a\u0026amp;signature=1c547d10d886d0aaa01c2588ffa6f778cff3821f6ef94569e64c9ec69e5d3b51\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get an AI Agent Task - Maia Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns the details of a specific AI agent task including its current status and pending decisions.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://matillion.mintlify.site/_mintlify/api/og/v2?division=AI+Agent+Tasks\u0026amp;title=Get+an+AI+Agent+Task\u0026amp;description=Returns+the+details+of+a+specific+AI+agent+task+including+its+current+status+and+pending+decisions.\u0026amp;theme=ce57a3e3dfd574362d42229a\u0026amp;signature=1c547d10d886d0aaa01c2588ffa6f778cff3821f6ef94569e64c9ec69e5d3b51\">\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/matillion/eb7R3mt9l7P1vThW/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Maia Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#001f1d\">\u003cmeta data-mint-head name=\"google-site-verification\" content=\"0VLXGRESICGHnU66TdhEgUMBRRubPnW8JTkzOpiiNn0\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.maia.ai/api-reference/ai-agent-tasks/get-an-ai-agent-task\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/ai-agent-tasks/get-an-ai-agent-task.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.maia.ai/#organization\",\"name\":\"Maia Documentation\",\"url\":\"https://docs.maia.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/matillion/GyuNBHAx-GXnVlKX/images/maia-by-matillion-light.svg?fit=max\u0026auto=format\u0026n=GyuNBHAx-GXnVlKX\u0026q=85\u0026s=2c48b854f858c5a835450b3f34360db7\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.maia.ai#website\",\"name\":\"Maia Documentation\",\"url\":\"https://docs.maia.ai\",\"publisher\":{\"@id\":\"https://docs.maia.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/get-an-ai-agent-task#webpage\",\"url\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/get-an-ai-agent-task\",\"name\":\"Get an AI Agent Task\",\"description\":\"Returns the details of a specific AI agent task including its current status and pending decisions.\",\"dateModified\":\"2026-11-09T16:51:11.679Z\",\"isPartOf\":{\"@id\":\"https://docs.maia.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/get-an-ai-agent-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/get-an-ai-agent-task#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.maia.ai/api-reference/runners/list-all-runners\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"AI Agent Tasks\",\"item\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/list-ai-agent-tasks\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get an AI Agent Task\",\"item\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/get-an-ai-agent-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/get-an-ai-agent-task#apireference\",\"headline\":\"Get an AI Agent Task\",\"name\":\"Get an AI Agent Task\",\"description\":\"Returns the details of a specific AI agent task including its current status and pending decisions.\",\"url\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/get-an-ai-agent-task\",\"mainEntityOfPage\":{\"@id\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/get-an-ai-agent-task#webpage\"},\"dateModified\":\"2026-11-09T16:51:11.679Z\",\"publisher\":{\"@id\":\"https://docs.maia.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.maia.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Maia Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Maia Documentation","nav":{"global":null,"tabs":[{"tab":"Home","pages":[{"title":"Home","href":""}]},{"tab":"Admin","pages":[{"title":"Admin","href":"/docs/administration/administration-overview"}]},{"tab":"Components","pages":[{"title":"Components","href":"/docs/components/components-overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/docs/guides/maia-overview"}]},{"tab":"API Reference","pages":[{"group":"Overview","root":{"title":"Overview of the Maia API","href":"/docs/api-reference/maia-api-overview"},"pages":[{"title":"Overview of the Maia API","href":"/docs/api-reference/maia-api-overview"},{"title":"Authenticate to the Maia API","href":"/docs/api-reference/maia-api-authentication"},{"group":"Guides","pages":[{"title":"Generating a Personal Access Token","href":"/docs/api-reference/generating-a-pat"},{"title":"Project Provisioning API","href":"/docs/api-reference/provisioning-a-project"},{"title":"Repository Migration API","href":"/docs/api-reference/repository-migration"},{"title":"Executing and managing a pipeline","href":"/docs/api-reference/executing-and-managing-a-pipeline"},{"title":"Understanding artifacts","href":"/docs/api-reference/understanding-artifacts"},{"title":"Creating artifacts with the Maia API","href":"/docs/api-reference/creating-artifacts-with-the-api"},{"title":"Scheduling artifacts via the API","href":"/docs/api-reference/scheduling-artifacts"},{"title":"Managing secret references","href":"/docs/api-reference/secret-references"},{"title":"Create and manage streaming pipelines via the API","href":"/docs/api-reference/streaming-pipeline"},{"title":"Project Variables API","href":"/docs/api-reference/managing-project-variables"},{"title":"Matillion's MCP server","href":"/docs/api-reference/mcp-server"},{"title":"Review pipeline quality using the API","href":"/docs/api-reference/review-pipeline-quality"},{"title":"Using the Agent Tasks API","href":"/docs/api-reference/using-agent-tasks-api"}]}]},{"group":"Endpoints","pages":[{"group":"Runners","pages":[{"title":"List All Runners","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/agents","href":"/api-reference/runners/list-all-runners"},{"title":"Create a new Runner","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/agents","href":"/api-reference/runners/create-a-new-runner"},{"title":"Get Runner Track History","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/agents/releases","href":"/api-reference/runners/get-runner-track-history"},{"title":"Get runner details","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/agents/{agentId}","href":"/api-reference/runners/get-runner-details"},{"title":"Delete a Runner","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/agents/{agentId}","href":"/api-reference/runners/delete-a-runner"},{"title":"Update a Runner","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v1/agents/{agentId}","href":"/api-reference/runners/update-a-runner"},{"title":"Get the Runner Allow list","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/agents/{agentId}/allowlist","href":"/api-reference/runners/get-the-runner-allow-list"},{"title":"Set Runner Allow List","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml put /v1/agents/{agentId}/allowlist","href":"/api-reference/runners/set-runner-allow-list"},{"title":"Remove project from Runner Allow list","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/agents/{agentId}/allowlist","href":"/api-reference/runners/remove-project-from-runner-allow-list"},{"title":"Add project(s) and/or environment(s) to the Runner Allow list","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v1/agents/{agentId}/allowlist","href":"/api-reference/runners/add-projects-andor-environments-to-the-runner-allow-list"},{"title":"Trigger a Runner command","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/agents/{agentId}/commands","href":"/api-reference/runners/trigger-a-runner-command"},{"title":"Get Runner Client Credentials","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/agents/{agentId}/credentials","href":"/api-reference/runners/get-runner-client-credentials"},{"title":"Perform actions on Runner Credentials","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/agents/{agentId}/credentials","href":"/api-reference/runners/perform-actions-on-runner-credentials"}]},{"group":"AI Agent Tasks","pages":[{"title":"List AI Agent Tasks","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/ai/agents/tasks","href":"/api-reference/ai-agent-tasks/list-ai-agent-tasks"},{"title":"Create an AI Agent Task","description":"Creates a new AI agent task and starts async execution. Poll the messages endpoint to retrieve results.","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/ai/agents/tasks","href":"/api-reference/ai-agent-tasks/create-an-ai-agent-task"},{"title":"Get an AI Agent Task","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/ai/agents/tasks/{taskId}","href":"/api-reference/ai-agent-tasks/get-an-ai-agent-task"},{"title":"Delete an AI Agent Task","description":"Permanently deletes an AI agent task. The task must not be in RUNNING status.","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/ai/agents/tasks/{taskId}","href":"/api-reference/ai-agent-tasks/delete-an-ai-agent-task"},{"title":"Submit Task Decisions","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/ai/agents/tasks/{taskId}/decisions","href":"/api-reference/ai-agent-tasks/submit-task-decisions"},{"title":"Get Task Messages","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/ai/agents/tasks/{taskId}/messages","href":"/api-reference/ai-agent-tasks/get-task-messages"},{"title":"Send a Message to a Task","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/ai/agents/tasks/{taskId}/messages","href":"/api-reference/ai-agent-tasks/send-a-message-to-a-task"},{"title":"Set Task Permissions","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml put /v1/ai/agents/tasks/{taskId}/permissions","href":"/api-reference/ai-agent-tasks/set-task-permissions"},{"title":"Stop an AI Agent Task","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/ai/agents/tasks/{taskId}/stop","href":"/api-reference/ai-agent-tasks/stop-an-ai-agent-task"}]},{"group":"Connection Schema","pages":[{"title":"Get Connection Schema","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/connections/schema","href":"/api-reference/connection-schema/get-connection-schema"}]},{"group":"Consumption","pages":[{"title":"Get a breakdown of your credit consumption for flat-rated products","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/consumption","href":"/api-reference/consumption/get-a-breakdown-of-your-credit-consumption-for-flat-rated-products"},{"title":"Get a breakdown of your credit consumption for ETL Users","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/consumption/etl-users","href":"/api-reference/consumption/get-a-breakdown-of-your-credit-consumption-for-etl-users"}]},{"group":"Connectors","pages":[{"title":"Lists custom connector profiles for the requesting account","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/custom-connectors","href":"/api-reference/connectors/lists-custom-connector-profiles-for-the-requesting-account"},{"title":"Lists flex connector profiles","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/flex-connectors","href":"/api-reference/connectors/lists-flex-connector-profiles"}]},{"group":"Directory Integration","pages":[{"title":"Search SCIM Groups","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/directory-integration/scim/v2/Groups","href":"/api-reference/directory-integration/search-scim-groups"},{"title":"Create SCIM Group","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/directory-integration/scim/v2/Groups","href":"/api-reference/directory-integration/create-scim-group"},{"title":"Get SCIM Group","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/directory-integration/scim/v2/Groups/{id}","href":"/api-reference/directory-integration/get-scim-group"},{"title":"Update SCIM Group","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml put /v1/directory-integration/scim/v2/Groups/{id}","href":"/api-reference/directory-integration/update-scim-group"},{"title":"Delete SCIM Group","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/directory-integration/scim/v2/Groups/{id}","href":"/api-reference/directory-integration/delete-scim-group"},{"title":"Patch SCIM Group","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v1/directory-integration/scim/v2/Groups/{id}","href":"/api-reference/directory-integration/patch-scim-group"},{"title":"Get SCIM Resource Types","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/directory-integration/scim/v2/ResourceTypes","href":"/api-reference/directory-integration/get-scim-resource-types"},{"title":"Get SCIM Schemas","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/directory-integration/scim/v2/Schemas","href":"/api-reference/directory-integration/get-scim-schemas"},{"title":"Get SCIM Service Provider Configuration","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/directory-integration/scim/v2/ServiceProviderConfig","href":"/api-reference/directory-integration/get-scim-service-provider-configuration"},{"title":"Search SCIM Users","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/directory-integration/scim/v2/Users","href":"/api-reference/directory-integration/search-scim-users"},{"title":"Create SCIM User","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/directory-integration/scim/v2/Users","href":"/api-reference/directory-integration/create-scim-user"},{"title":"Get SCIM User","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/directory-integration/scim/v2/Users/{id}","href":"/api-reference/directory-integration/get-scim-user"},{"title":"Update SCIM User","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml put /v1/directory-integration/scim/v2/Users/{id}","href":"/api-reference/directory-integration/update-scim-user"},{"title":"Delete SCIM User","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/directory-integration/scim/v2/Users/{id}","href":"/api-reference/directory-integration/delete-scim-user"},{"title":"Patch SCIM User","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v1/directory-integration/scim/v2/Users/{id}","href":"/api-reference/directory-integration/patch-scim-user"}]},{"group":"Audit Events","pages":[{"title":"Query audit events in a time range","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/events","href":"/api-reference/audit-events/query-audit-events-in-a-time-range"}]},{"group":"Data Lineage","pages":[{"title":"Get OpenLineage events for a specified time period","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/lineage/events","href":"/api-reference/data-lineage/get-openlineage-events-for-a-specified-time-period"}]},{"group":"Pipeline Execution","pages":[{"title":"Pipeline Executions","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/pipeline-executions","href":"/api-reference/pipeline-execution/pipeline-executions"},{"title":"Execute Published Pipeline","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/pipeline-executions","href":"/api-reference/pipeline-execution/execute-published-pipeline"},{"title":"Pipeline Execution Details","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}","href":"/api-reference/pipeline-execution/pipeline-execution-details"},{"title":"Pipeline termination","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}","href":"/api-reference/pipeline-execution/pipeline-termination"},{"title":"Pipeline Execution Status","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}/status","href":"/api-reference/pipeline-execution/pipeline-execution-status"},{"title":"Pipeline Steps Status","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}/steps","href":"/api-reference/pipeline-execution/pipeline-steps-status"},{"title":"Pipeline Execution Tasks","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/pipeline-executions/{pipelineExecutionId}/tasks","href":"/api-reference/pipeline-execution/pipeline-execution-tasks"}]},{"group":"Projects","pages":[{"title":"List All Projects","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects","href":"/api-reference/projects/list-all-projects"},{"title":"Create a new project","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects","href":"/api-reference/projects/create-a-new-project"},{"title":"An endpoint to delete a project by UUID","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/projects/{projectId}","href":"/api-reference/projects/an-endpoint-to-delete-a-project-by-uuid"}]},{"group":"Artifacts","pages":[{"title":"Get a list of Artifacts","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/artifacts","href":"/api-reference/artifacts/get-a-list-of-artifacts"},{"title":"Create an Artifact","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/artifacts","href":"/api-reference/artifacts/create-an-artifact"},{"title":"Flags an artifact to enable or disable","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v1/projects/{projectId}/artifacts","href":"/api-reference/artifacts/flags-an-artifact-to-enable-or-disable"},{"title":"Get Artifact by a given version name","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/artifacts/details","href":"/api-reference/artifacts/get-artifact-by-a-given-version-name"},{"title":"Promotes Artifact","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/artifacts/promotions","href":"/api-reference/artifacts/promotes-artifact"},{"title":"Get Artifact with assets details by a given version name","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v2/projects/{projectId}/artifacts/details","href":"/api-reference/artifacts/get-artifact-with-assets-details-by-a-given-version-name"}]},{"group":"Connections","pages":[{"title":"Retrieve a page of project connections, optionally filtered by parameters.","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/connections","href":"/api-reference/connections/retrieve-a-page-of-project-connections-optionally-filtered-by-parameters"},{"title":"Update an existing project connection by name.","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml put /v1/projects/{projectId}/connections","href":"/api-reference/connections/update-an-existing-project-connection-by-name"},{"title":"Create a new project connection","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/connections","href":"/api-reference/connections/create-a-new-project-connection"},{"title":"Deleting a project connection by name.","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/projects/{projectId}/connections","href":"/api-reference/connections/deleting-a-project-connection-by-name"},{"title":"Retrieve a page of connection overrides which apply in a specific environment.","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/connections/environment-overrides","href":"/api-reference/connections/retrieve-a-page-of-connection-overrides-which-apply-in-a-specific-environment"},{"title":"Update an existing environment connection override","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml put /v1/projects/{projectId}/connections/environment-overrides","href":"/api-reference/connections/update-an-existing-environment-connection-override"},{"title":"Create an environment connection override","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/connections/environment-overrides","href":"/api-reference/connections/create-an-environment-connection-override"},{"title":"Delete environment connection overrides","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/projects/{projectId}/connections/environment-overrides","href":"/api-reference/connections/delete-environment-connection-overrides"},{"title":"Test a connection","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/connections/test","href":"/api-reference/connections/test-a-connection"},{"title":"Create a default data warehouse connection","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/data-platform-connections","href":"/api-reference/connections/create-a-default-data-warehouse-connection"}]},{"group":"Environments","pages":[{"title":"List All Environments","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/environments","href":"/api-reference/environments/list-all-environments"},{"title":"Create a new environment","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/environments","href":"/api-reference/environments/create-a-new-environment"},{"title":"Delete an environment","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/projects/{projectId}/environments/{environmentName}","href":"/api-reference/environments/delete-an-environment"}]},{"group":"Pipelines","pages":[{"title":"List All Published Pipelines","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/published-pipelines","href":"/api-reference/pipelines/list-all-published-pipelines"}]},{"group":"Repositories","pages":[{"title":"Associate a repository with a project","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/repositories","href":"/api-reference/repositories/associate-a-repository-with-a-project"},{"title":"Update provider parameters on the repository associated with a project","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v1/projects/{projectId}/repositories","href":"/api-reference/repositories/update-provider-parameters-on-the-repository-associated-with-a-project"},{"title":"Rotate the access token for a project repository","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/repositories/token","href":"/api-reference/repositories/rotate-the-access-token-for-a-project-repository"}]},{"group":"Repository Migration","pages":[{"title":"List repository migrations","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/repository-migration","href":"/api-reference/repository-migration/list-repository-migrations"},{"title":"Start A Repository Migration","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/repository-migration","href":"/api-reference/repository-migration/start-a-repository-migration"},{"title":"Get Repository Migration Status","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/repository-migration/{migrationId}","href":"/api-reference/repository-migration/get-repository-migration-status"}]},{"group":"Pipeline Quality Review","pages":[{"title":"Review Pipeline Quality","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/reviews","href":"/api-reference/pipeline-quality-review/review-pipeline-quality"}]},{"group":"Schedules","pages":[{"title":"List All Schedules for a Project","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/schedules","href":"/api-reference/schedules/list-all-schedules-for-a-project"},{"title":"Create a new schedule","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/schedules","href":"/api-reference/schedules/create-a-new-schedule"},{"title":"Get a schedule summary for a given schedule id","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/schedules/{scheduleId}","href":"/api-reference/schedules/get-a-schedule-summary-for-a-given-schedule-id"},{"title":"Deletes the schedule by the given schedule id","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/projects/{projectId}/schedules/{scheduleId}","href":"/api-reference/schedules/deletes-the-schedule-by-the-given-schedule-id"},{"title":"Update the schedule by the given schedule id and schedule request","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v2/projects/{projectId}/schedules/{scheduleId}","href":"/api-reference/schedules/update-the-schedule-by-the-given-schedule-id-and-schedule-request"}]},{"group":"Secret References","pages":[{"title":"List All Secret References","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/secret-references","href":"/api-reference/secret-references/list-all-secret-references"},{"title":"Create a Secret Reference","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/secret-references/{secretReferenceName}","href":"/api-reference/secret-references/create-a-secret-reference"},{"title":"Delete a secret reference","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/projects/{projectId}/secret-references/{secretReferenceName}","href":"/api-reference/secret-references/delete-a-secret-reference"}]},{"group":"Streaming Pipelines","pages":[{"title":"List streaming pipeline definitions","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/streaming-pipelines","href":"/api-reference/streaming-pipelines/list-streaming-pipeline-definitions"},{"title":"Create a streaming pipeline definition","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/streaming-pipelines","href":"/api-reference/streaming-pipelines/create-a-streaming-pipeline-definition"},{"title":"Get a streaming pipeline definition","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/streaming-pipelines/{streamingPipelineId}","href":"/api-reference/streaming-pipelines/get-a-streaming-pipeline-definition"},{"title":"Update a streaming pipeline definition","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml put /v1/projects/{projectId}/streaming-pipelines/{streamingPipelineId}","href":"/api-reference/streaming-pipelines/update-a-streaming-pipeline-definition"},{"title":"Delete a streaming pipeline definition","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/projects/{projectId}/streaming-pipelines/{streamingPipelineId}","href":"/api-reference/streaming-pipelines/delete-a-streaming-pipeline-definition"},{"title":"Execute a streaming pipeline command","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/streaming-pipelines/{streamingPipelineId}/commands","href":"/api-reference/streaming-pipelines/execute-a-streaming-pipeline-command"},{"title":"Get a streaming pipeline's status","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/streaming-pipelines/{streamingPipelineId}/status","href":"/api-reference/streaming-pipelines/get-a-streaming-pipelines-status"}]},{"group":"Test Execution","pages":[{"title":"Create Test Execution","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/test-executions","href":"/api-reference/test-execution/create-test-execution"},{"title":"Test Execution Status","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/test-executions/{testExecutionId}","href":"/api-reference/test-execution/test-execution-status"},{"title":"Cancel Test Execution","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v1/projects/{projectId}/test-executions/{testExecutionId}","href":"/api-reference/test-execution/cancel-test-execution"},{"title":"List Test Executions","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/test-executions","href":"/api-reference/test-execution/list-test-executions"}]},{"group":"Project Variables","pages":[{"title":"Get all project variables for a project","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/variables","href":"/api-reference/project-variables/get-all-project-variables-for-a-project"},{"title":"Create a project variable","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/variables","href":"/api-reference/project-variables/create-a-project-variable"},{"title":"Delete a project variable","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/projects/{projectId}/variables/{variableName}","href":"/api-reference/project-variables/delete-a-project-variable"},{"title":"Update a project variable","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v1/projects/{projectId}/variables/{variableName}","href":"/api-reference/project-variables/update-a-project-variable"}]},{"group":"Project Variable Environment Overrides","pages":[{"title":"Get environment overrides","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/projects/{projectId}/variables/{variableName}/environment-overrides","href":"/api-reference/project-variable-environment-overrides/get-environment-overrides"},{"title":"Create environment overrides","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/projects/{projectId}/variables/{variableName}/environment-overrides","href":"/api-reference/project-variable-environment-overrides/create-environment-overrides"},{"title":"Delete an environment override","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml delete /v1/projects/{projectId}/variables/{variableName}/environment-overrides/{environmentName}","href":"/api-reference/project-variable-environment-overrides/delete-an-environment-override"}]},{"group":"Secrets","pages":[{"title":"Create a new Secret Value","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/secrets/{agentId}/secret-value","href":"/api-reference/secrets/create-a-new-secret-value"}]},{"group":"Shared Pipeline Artifacts","pages":[{"title":"List Published Shared Pipelines","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/shared-pipelines","href":"/api-reference/shared-pipeline-artifacts/list-published-shared-pipelines"},{"title":"List Published Shared Pipeline Artifacts","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/shared-pipelines/artifacts","href":"/api-reference/shared-pipeline-artifacts/list-published-shared-pipeline-artifacts"},{"title":"Publish a Shared Pipeline Artifact","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml post /v1/shared-pipelines/artifacts","href":"/api-reference/shared-pipeline-artifacts/publish-a-shared-pipeline-artifact"},{"title":"Enable or Disable a Shared Pipeline Artifact Version","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml patch /v1/shared-pipelines/artifacts","href":"/api-reference/shared-pipeline-artifacts/enable-or-disable-a-shared-pipeline-artifact-version"},{"title":"Get Shared Pipeline Artifact Details","deprecated":null,"version":null,"openapi":"/openapi/public-api-endpoint-reference.yaml get /v1/shared-pipelines/artifacts/details","href":"/api-reference/shared-pipeline-artifacts/get-shared-pipeline-artifact-details"}]}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/docs/changelog/2026-changelog"}]}]},"basePath":"","title":"Get an AI Agent Task - Maia Documentation","buildId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","deploymentId":"dpl_42LwxxU1kGN114H4XzwGYXa9ZDah","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C-hEh3I2.js","utils-CnF4QiUD.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-C7PVNbel.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-8ytevL2A.js","snippetPresets-BT1alx3v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BLXC0i_W.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CyLIGI9_.js","shallow-DC0lGVIW.js","getApiPlaygroundDisplay-CgDQ85tN.js","CodeSnippet-6-I-Gpv9.js","CodeSnippets-BAk1kDdu.js","Page-C945cI-W.js","getPastedJson-B276RuWN.js","icon-BqP8etTm.js","MethodPill-DM6sbxG1.js","DuplicateIcon-PyJglOaE.js","createIcon-CMeOMAc_.js","DynamicMarkdown-BoyYAA8K.js","SectionHeading-DAYv3gvZ.js","axios-vUo_bRtp.js","Markdown-BhTTmazV.js","clsx-CR-RHrVC.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CBUH0-zX.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BmARFYNC.js"]}