{"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":[{"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":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"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":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"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/create-an-ai-agent-task","slug":"/api-reference/ai-agent-tasks/create-an-ai-agent-task","pageMetadata":{"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","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: \"Creates a new AI agent task and starts async execution. Poll the messages endpoint to retrieve results.\"\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":"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","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":"Creates a new AI agent task and starts async execution. Poll the messages endpoint to retrieve results.","operationId":"createTask","requestBody":"85636eaa-479e-4813-a6ac-c3abb0e9eac3","responses":{"201":"edc65378-642a-48f6-9337-8245c12a43e2","400":"207cae63-4bfa-43d2-b09f-53142372e6be","401":"d129dbc7-21a4-42df-801f-fb64c596a181","403":"8f09cb3f-ad5b-4afe-aca8-12a0dbfaaf85","404":"a291732a-41e9-461f-96bb-da75599c0a5e","502":"a2e85515-9c59-446e-a875-bf78681d7a0b","504":"057b3dea-8103-4dfd-9b31-feb00a1632aa"},"summary":"Create an AI Agent Task","tags":["AI Agent Tasks"],"method":"post","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","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":"Create an AI Agent Task","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"agentConfig":{"type":"object","description":"Configuration specifying the agent type and its parameters","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"}},"isRequired":true,"uniqueKey":"agentConfig","typeLabel":"object"},"message":{"type":"string","description":"The instruction or question to send to the agent","example":"Build a pipeline to load sales data from S3 into Snowflake","minLength":1,"isRequired":true,"uniqueKey":"message","typeLabel":"string"},"grantedPermissions":{"oneOf":[{"type":"array","description":"Permissions pre-granted to the agent for this task. Each entry must be unique","items":{"type":"object","properties":{"toolName":{"type":"string","description":"The name of the tool to allow","example":"execute_sql","minLength":1,"isRequired":true,"uniqueKey":"grantedPermissions.oneOf.0.items.[INDEX].toolName","typeLabel":"string"}},"required":["toolName"],"uniqueKey":"grantedPermissions.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"grantedPermissions.oneOf.0","typeLabel":"object[]"},{"type":"null","description":"Permissions pre-granted to the agent for this task. Each entry must be unique","items":{"type":"object","properties":{"toolName":{"type":"string","description":"The name of the tool to allow","example":"execute_sql","minLength":1}},"required":["toolName"]},"uniqueKey":"grantedPermissions.oneOf.1","typeLabel":"null"}],"uniqueKey":"grantedPermissions","typeLabel":"object[] | null"}},"required":["agentConfig","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"agentConfig":{"name":"data_engineer_agent","environmentName":"development","mode":"ACT","projectId":"550e8400-e29b-41d4-a716-446655440001","sourceBranchName":"main","generateBranch":true,"graphId":"my-pipeline","targetBranchName":"feature/my-pipeline","workingDirectory":"/pipelines"},"message":"Build a pipeline to load sales data from S3 into Snowflake","grantedPermissions":[{"toolName":"execute_sql"}]}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"edc65378-642a-48f6-9337-8245c12a43e2":{"content":{"application/json":{"examples":{"Created agent task":{"title":"Created agent task","description":"Example response for a successfully created agent task","value":{"taskId":"550e8400-e29b-41d4-a716-446655440000","status":"RUNNING","agentName":"data_engineer_agent","createdAt":"2024-01-15T10:30:00.000Z"}}},"schema":{"type":"object","properties":{"agentName":{"type":"string","description":"The name of the agent handling the task","example":"data_engineer_agent","uniqueKey":"agentName","typeLabel":"string"},"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>"},"status":{"type":"string","description":"The current status of the task","enum":["RUNNING","STOPPED","STOPPING","ERRORED"],"example":"RUNNING","uniqueKey":"status","typeLabel":"enum\u003cstring>"},"taskId":{"type":"string","format":"uuid","description":"The unique identifier of the created task","example":"550e8400-e29b-41d4-a716-446655440000","uniqueKey":"taskId","typeLabel":"string\u003cuuid>"}},"uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"Agent task created successfully","exampleType":"examples"},"207cae63-4bfa-43d2-b09f-53142372e6be":{"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 body","exampleType":"generated"},"d129dbc7-21a4-42df-801f-fb64c596a181":{"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"},"8f09cb3f-ad5b-4afe-aca8-12a0dbfaaf85":{"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 create an agent task","exampleType":"generated"},"a291732a-41e9-461f-96bb-da75599c0a5e":{"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":"Resource not found","exampleType":"generated"},"a2e85515-9c59-446e-a875-bf78681d7a0b":{"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"},"057b3dea-8103-4dfd-9b31-feb00a1632aa":{"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":"Create an AI Agent Task - Maia Documentation","relatedPagesConfig":{"enabled":true,"limit":5,"mode":"manual"},"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T16:51:11.670Z","originalFileLocation":"api-reference/ai-agent-tasks/create-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=\"Creates a new AI agent task and starts async execution. Poll the messages endpoint to retrieve results.\">\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=\"Create an AI Agent Task - Maia Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates a new AI agent task and starts async execution. Poll the messages endpoint to retrieve results.\">\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/create-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=Create+an+AI+Agent+Task\u0026amp;description=Creates+a+new+AI+agent+task+and+starts+async+execution.+Poll+the+messages+endpoint+to+retrieve+results.\u0026amp;theme=ce57a3e3dfd574362d42229a\u0026amp;signature=73235c9d0e92280a6d645dc2c867948320e7a8631120cf8aa47e284e07f883b7\">\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=\"Create an AI Agent Task - Maia Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates a new AI agent task and starts async execution. Poll the messages endpoint to retrieve results.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://matillion.mintlify.site/_mintlify/api/og/v2?division=AI+Agent+Tasks\u0026amp;title=Create+an+AI+Agent+Task\u0026amp;description=Creates+a+new+AI+agent+task+and+starts+async+execution.+Poll+the+messages+endpoint+to+retrieve+results.\u0026amp;theme=ce57a3e3dfd574362d42229a\u0026amp;signature=73235c9d0e92280a6d645dc2c867948320e7a8631120cf8aa47e284e07f883b7\">\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/create-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/create-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/create-an-ai-agent-task#webpage\",\"url\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/create-an-ai-agent-task\",\"name\":\"Create an AI Agent Task\",\"description\":\"Creates a new AI agent task and starts async execution. Poll the messages endpoint to retrieve results.\",\"dateModified\":\"2026-11-09T16:51:11.670Z\",\"isPartOf\":{\"@id\":\"https://docs.maia.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/create-an-ai-agent-task#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/create-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\":\"Create an AI Agent Task\",\"item\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/create-an-ai-agent-task\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/create-an-ai-agent-task#apireference\",\"headline\":\"Create an AI Agent Task\",\"name\":\"Create an AI Agent Task\",\"description\":\"Creates a new AI agent task and starts async execution. Poll the messages endpoint to retrieve results.\",\"url\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/create-an-ai-agent-task\",\"mainEntityOfPage\":{\"@id\":\"https://docs.maia.ai/api-reference/ai-agent-tasks/create-an-ai-agent-task#webpage\"},\"dateModified\":\"2026-11-09T16:51:11.670Z\",\"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","description":"Returns a list of AI agent tasks for the account, optionally filtered by project, branch, status, or creation time.","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","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","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"},{"title":"Delete an AI Agent Task","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":"Create 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"]}