Creates an agent in your workspace and returns it. The agent is immediately usable: its sandbox, git workspace, and vault are provisioned on first contact. Requires an account-level key with the edit scope; agent-bound keys cannot create agents. Subject to your plan’s agent quota and a creation rate limit (429).
A Skydive API key, sent as Authorization: Bearer sky_live_.... Keys are scoped to a single agent and carry a use or edit scope. The full key value is shown once at creation and never again.
{
"error": "invalid api key",
"code": "<string>"
}
{
"error": "invalid api key",
"code": "<string>"
}
{
"error": "invalid api key",
"code": "<string>"
}
{
"error": "invalid api key",
"code": "<string>"
}
{"docsConfig":{"theme":"almond","$schema":"https://mintlify.com/docs.json","name":"Skydive","colors":{"primary":"#0065c5","light":"#6cb2ff","dark":"#0065c5"},"logo":{"light":"https://mintcdn.com/skydive/zzaDTNKNPRSo_9r7/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=zzaDTNKNPRSo_9r7\u0026q=85\u0026s=a1a41c4e9c0bcfa6dc32bf351144d811","dark":"https://mintcdn.com/skydive/zzaDTNKNPRSo_9r7/logo/logo-dark.svg?fit=max\u0026auto=format\u0026n=zzaDTNKNPRSo_9r7\u0026q=85\u0026s=be503f077361d2f40affc0ed0444a5ad"},"favicon":"https://mintcdn.com/skydive/zzaDTNKNPRSo_9r7/favicon.svg?fit=max\u0026auto=format\u0026n=zzaDTNKNPRSo_9r7\u0026q=85\u0026s=8afa482746771e54df4a8eb5c8f79556","appearance":{"default":"system"},"background":{"color":{"light":"#f7f7f7","dark":"#101010"}},"navbar":{"links":[{"href":"https://skydive.com/login","label":"Log in"}],"primary":{"type":"button","label":"Get Skydive","href":"https://skydive.com/signup"}},"footer":{"socials":{"x":"https://x.com/anything","linkedin":"https://www.linkedin.com/company/anythingai"}},"seo":{"metatags":{"canonical":"https://www.skydive.com/docs"},"indexing":"all"},"fonts":{"heading":{"family":"Aeonik","weight":500,"source":"fonts/aeonik-medium.woff2","format":"woff2"},"body":{"family":"Inter"}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"https://www.skydive.com/docs/changelog"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"skydive","hasAudioNarration":false,"actualSubdomain":"skydive","customDomains":["getskydive.com"],"gitSource":{"type":"github","owner":"create-inc","repo":"skydive-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae8e5082c87f0961bdcd370","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"Guides","count":59},{"language":"default","tag":"Agents","count":19},{"language":"default","tag":"Computer","count":12},{"language":"default","tag":"Workspaces","count":11},{"language":"default","tag":"Skydive CLI","count":10},{"language":"default","tag":"API","count":10},{"language":"default","tag":"Endpoints","count":10},{"language":"default","tag":"Talk to them","count":8},{"language":"default","tag":"Integrations","count":8},{"language":"default","tag":"Get started","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".card{border-color:#ebebe9!important;box-shadow:none!important}.card:hover{border-color:#d9d7d4!important;background:#fbfaf8!important}.dark .card{border-color:#2a2a2a!important}.dark .card:hover{background:#191919!important;border-color:#3a3a3a!important}[data-component-part=\"card-title\"]{font-weight:500!important}[data-component-part=\"card-content\"]{color:#6f6c69}.dark [data-component-part=\"card-content\"]{color:#aba8a5}.card [data-component-part=\"card-icon\"] svg{background-color:#6699c4!important}.dark .card [data-component-part=\"card-icon\"] svg{background-color:#8fb3d3!important}callout{border-radius:12px!important}callout[data-callout-type=\"tip\"],callout[data-callout-type=\"note\"],callout[data-callout-type=\"info\"]{background:color-mix(in srgb, #6699c4 10%, #ffffff)!important;border-color:transparent!important}.dark callout[data-callout-type=\"tip\"],.dark callout[data-callout-type=\"note\"],.dark callout[data-callout-type=\"info\"]{background:color-mix(in srgb, #6699c4 16%, #101010)!important}steps,accordion{border-color:#ebebe9}.dark steps,.dark accordion{border-color:#2a2a2a}"}],"page":{"pagePath":"api-reference/agents/create-an-agent","slug":"/api-reference/agents/create-an-agent","pageMetadata":{"title":"Create an agent","description":"Creates an agent in your workspace and returns it. The agent is immediately usable: its sandbox, git workspace, and vault are provisioned on first contact. Requires an account-level key with the `edit` scope; agent-bound keys cannot create agents. Subject to your plan's agent quota and a creation rate limit (`429`).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents","href":"/api-reference/agents/create-an-agent","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Creates an agent in your workspace and returns it. The agent is immediately usable: its sandbox, git workspace, and vault are provisioned on first contact. Requires an account-level key with the \", _jsx(_components.code, {\n children: \"edit\"\n }), \" scope; agent-bound keys cannot create agents. Subject to your plan’s agent quota and a creation rate limit (\", _jsx(_components.code, {\n children: \"429\"\n }), \").\"]\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 agent","description":"Creates an agent in your workspace and returns it. The agent is immediately usable: its sandbox, git workspace, and vault are provisioned on first contact. Requires an account-level key with the `edit` scope; agent-bound keys cannot create agents. Subject to your plan's agent quota and a creation rate limit (`429`).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents","href":"/api-reference/agents/create-an-agent","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"createAgent","tags":["Agents"],"summary":"Create an agent","description":"Creates an agent in your workspace and returns it. The agent is immediately usable: its sandbox, git workspace, and vault are provisioned on first contact. Requires an account-level key with the `edit` scope; agent-bound keys cannot create agents. Subject to your plan's agent quota and a creation rate limit (`429`).","requestBody":"bba14149-9fe2-4b37-8ebb-f4c1a66671da","responses":{"201":"f3a41a93-ae69-4951-8e89-3a65a22759a2","401":"714bd028-e41f-42ab-8f3a-afc698d39b90","403":"03bc983a-96fa-4dc2-acd2-480cf54c7e1a","409":"2dc2470b-b1ea-494e-b23f-c8c32d6cc630","429":"25847492-8791-4d9f-9a58-797af27e6816"},"method":"post","type":"path","servers":["3b10ae10-029d-4011-af13-83ad4363009a"],"security":["977eeb31-84ba-4938-bdb0-f87100f850eb"],"path":"/agents","baseUrlOptions":["https://api.skydive.com/v1"],"title":"Create an agent","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120,"description":"Display name for the new agent.","example":"Support Bot","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"model":{"oneOf":[{"type":"string","maxLength":120,"description":"Optional model id to run the agent on. Omit to use your workspace default.","uniqueKey":"model.oneOf.0","typeLabel":"string"},{"type":"null","maxLength":120,"description":"Optional model id to run the agent on. Omit to use your workspace default.","uniqueKey":"model.oneOf.1","typeLabel":"null"}],"uniqueKey":"model","typeLabel":"string | null"}},"required":["name"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"name":"Support Bot","model":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"f3a41a93-ae69-4951-8e89-3a65a22759a2":{"description":"The agent was created.","content":{"application/json":{"schema":{"type":"object","properties":{"agent":{"type":"object","properties":{"id":{"type":"string","description":"Unique agent identifier.","example":"01900000-0000-7000-8000-000000000000","isRequired":true,"uniqueKey":"agent.id","typeLabel":"string"},"name":{"type":"string","description":"Display name of the agent.","example":"My agent","isRequired":true,"uniqueKey":"agent.name","typeLabel":"string"},"url":{"oneOf":[{"type":"string","description":"Public URL of the agent's webserver, or null if it has no short id yet.","example":"https://01900000-0000-7000-8000-000000000000.skydive.app","isRequired":true,"uniqueKey":"agent.url.oneOf.0","typeLabel":"string"},{"type":"null","description":"Public URL of the agent's webserver, or null if it has no short id yet.","example":"https://01900000-0000-7000-8000-000000000000.skydive.app","isRequired":true,"uniqueKey":"agent.url.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"agent.url","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"Short description of the agent.","isRequired":true,"uniqueKey":"agent.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Short description of the agent.","isRequired":true,"uniqueKey":"agent.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"agent.description","typeLabel":"string | null"},"model":{"oneOf":[{"type":"string","description":"The model the agent runs on.","example":"anthropic/claude-opus-4-8","isRequired":true,"uniqueKey":"agent.model.oneOf.0","typeLabel":"string"},{"type":"null","description":"The model the agent runs on.","example":"anthropic/claude-opus-4-8","isRequired":true,"uniqueKey":"agent.model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"agent.model","typeLabel":"string | null"},"gitUrl":{"type":"string","description":"Git remote URL for the agent's workspace repository.","isRequired":true,"uniqueKey":"agent.gitUrl","typeLabel":"string"}},"required":["id","name","url","description","model","gitUrl"],"isRequired":true,"uniqueKey":"agent","typeLabel":"object"}},"required":["agent"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"agent":{"id":"01900000-0000-7000-8000-000000000000","name":"My agent","url":"https://01900000-0000-7000-8000-000000000000.skydive.app","description":"\u003cstring>","model":"anthropic/claude-opus-4-8","gitUrl":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"714bd028-e41f-42ab-8f3a-afc698d39b90":{"description":"The API key is missing or invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable description of what went wrong.","example":"invalid api key","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, present on some errors.","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid api key","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"03bc983a-96fa-4dc2-acd2-480cf54c7e1a":{"description":"The key is not authorized for this operation.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable description of what went wrong.","example":"invalid api key","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, present on some errors.","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid api key","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"2dc2470b-b1ea-494e-b23f-c8c32d6cc630":{"description":"The generated slug is unavailable.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable description of what went wrong.","example":"invalid api key","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, present on some errors.","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid api key","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"25847492-8791-4d9f-9a58-797af27e6816":{"description":"The agent creation quota or rate limit was exceeded.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Human-readable description of what went wrong.","example":"invalid api key","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"type":"string","description":"Machine-readable error code, present on some errors.","uniqueKey":"code","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"invalid api key","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"977eeb31-84ba-4938-bdb0-f87100f850eb":{"apiKey":{"type":"http","scheme":"bearer","description":"A Skydive API key, sent as `Authorization: Bearer sky_live_...`. Keys are scoped to a single agent and carry a `use` or `edit` scope. The full key value is shown once at creation and never again.","scopes":[],"schemeName":"apiKey"}}},"servers":{"3b10ae10-029d-4011-af13-83ad4363009a":{"url":"https://api.skydive.com/v1","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"A Skydive API key, sent as `Authorization: Bearer sky_live_...`. Keys are scoped to a single agent and carry a `use` or `edit` scope. The full key value is shown once at creation and never again.","scopes":[],"schemeName":"apiKey"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A Skydive API key, sent as `Authorization: Bearer sky_live_...`. Keys are scoped to a single agent and carry a `use` or `edit` scope. The full key value is shown once at creation and never again.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"skydive","siteName":"Skydive","title":"Create an agent - Skydive","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T19:31:25.993Z","originalFileLocation":"api-reference/agents/create-an-agent.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Creates an agent in your workspace and returns it. The agent is immediately usable: its sandbox, git workspace, and vault are provisioned on first contact. Requires an account-level key with the edit scope; agent-bound keys cannot create agents. Subject to your plan\u0026#x27;s agent quota and a creation rate limit (429).\">\u003cmeta data-mint-head name=\"application-name\" content=\"Skydive\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/skydive/cQ_qzI-kKvttfxeu/_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=\"/docs/mintlify-assets/_mintlify/favicons/skydive/cQ_qzI-kKvttfxeu/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/skydive/cQ_qzI-kKvttfxeu/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/skydive/cQ_qzI-kKvttfxeu/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/skydive/cQ_qzI-kKvttfxeu/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/skydive/cQ_qzI-kKvttfxeu/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/skydive/cQ_qzI-kKvttfxeu/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/skydive/cQ_qzI-kKvttfxeu/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/skydive/cQ_qzI-kKvttfxeu/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an agent - Skydive\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates an agent in your workspace and returns it. The agent is immediately usable: its sandbox, git workspace, and vault are provisioned on first contact. Requires an account-level key with the edit scope; agent-bound keys cannot create agents. Subject to your plan\u0026#x27;s agent quota and a creation rate limit (429).\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Skydive\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.skydive.com/docs/api-reference/agents/create-an-agent\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://skydive.mintlify.site/docs/_mintlify/api/og/v2?division=Agents\u0026amp;title=Create+an+agent\u0026amp;description=Creates+an+agent+in+your+workspace+and+returns+it.+The+agent+is+immediately+usable%3A+its+sandbox%2C+git+workspace%2C+and+vault+are+provisioned+on+first+contact.+Requ\u0026amp;theme=61df4e3cda3b39df4814e0db\u0026amp;signature=68046c1f6407e2c10bec7236adc2eb0b20e4eb7a1beb05de864d0688c8135bcf\">\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 agent - Skydive\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates an agent in your workspace and returns it. The agent is immediately usable: its sandbox, git workspace, and vault are provisioned on first contact. Requires an account-level key with the edit scope; agent-bound keys cannot create agents. Subject to your plan\u0026#x27;s agent quota and a creation rate limit (429).\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://skydive.mintlify.site/docs/_mintlify/api/og/v2?division=Agents\u0026amp;title=Create+an+agent\u0026amp;description=Creates+an+agent+in+your+workspace+and+returns+it.+The+agent+is+immediately+usable%3A+its+sandbox%2C+git+workspace%2C+and+vault+are+provisioned+on+first+contact.+Requ\u0026amp;theme=61df4e3cda3b39df4814e0db\u0026amp;signature=68046c1f6407e2c10bec7236adc2eb0b20e4eb7a1beb05de864d0688c8135bcf\">\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=\"/docs/mintlify-assets/_mintlify/favicons/skydive/cQ_qzI-kKvttfxeu/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Skydive\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0065c5\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.skydive.com/docs/api-reference/agents/create-an-agent\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/agents/create-an-agent.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.skydive.com/#organization\",\"name\":\"Skydive\",\"url\":\"https://www.skydive.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/skydive/zzaDTNKNPRSo_9r7/logo/logo-light.svg?fit=max\u0026auto=format\u0026n=zzaDTNKNPRSo_9r7\u0026q=85\u0026s=a1a41c4e9c0bcfa6dc32bf351144d811\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.skydive.com/docs#website\",\"name\":\"Skydive\",\"url\":\"https://www.skydive.com/docs\",\"publisher\":{\"@id\":\"https://www.skydive.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.skydive.com/docs/api-reference/agents/create-an-agent#webpage\",\"url\":\"https://www.skydive.com/docs/api-reference/agents/create-an-agent\",\"name\":\"Create an agent\",\"description\":\"Creates an agent in your workspace and returns it. The agent is immediately usable: its sandbox, git workspace, and vault are provisioned on first contact. Requires an account-level key with the edit scope; agent-bound keys cannot create agents. Subject to your plan's agent quota and a creation rate limit (429).\",\"dateModified\":\"2026-11-02T19:31:25.993Z\",\"isPartOf\":{\"@id\":\"https://www.skydive.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.skydive.com/docs/api-reference/agents/create-an-agent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.skydive.com/docs/api-reference/agents/create-an-agent#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://www.skydive.com/docs/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agents\",\"item\":\"https://www.skydive.com/docs/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Create an agent\",\"item\":\"https://www.skydive.com/docs/api-reference/agents/create-an-agent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.skydive.com/docs/api-reference/agents/create-an-agent#apireference\",\"headline\":\"Create an agent\",\"name\":\"Create an agent\",\"description\":\"Creates an agent in your workspace and returns it. The agent is immediately usable: its sandbox, git workspace, and vault are provisioned on first contact. Requires an account-level key with the edit scope; agent-bound keys cannot create agents. Subject to your plan's agent quota and a creation rate limit (429).\",\"url\":\"https://www.skydive.com/docs/api-reference/agents/create-an-agent\",\"mainEntityOfPage\":{\"@id\":\"https://www.skydive.com/docs/api-reference/agents/create-an-agent#webpage\"},\"dateModified\":\"2026-11-02T19:31:25.993Z\",\"publisher\":{\"@id\":\"https://www.skydive.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.skydive.com/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Skydive\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Skydive\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/agents/create-an-agent.md","siteName":"Skydive","nav":{"global":{"anchors":[{"anchor":"Changelog","icon":"clock-rotate-left","href":"https://www.skydive.com/docs/changelog"}]},"anchors":[{"anchor":"Guides","icon":"book-open-cover","pages":[{"title":"Guides","href":"/get-started/welcome"}]},{"anchor":"Skydive CLI","icon":"terminal","pages":[{"title":"Skydive CLI","href":"/cli/overview"}]},{"anchor":"API","icon":"code","groups":[{"group":"Endpoints","pages":[{"group":"Agents","pages":[{"title":"List agents","description":"Returns the agents in your workspace that you can view, newest first. Use `limit` and the returned `nextCursor` to paginate; a `null` cursor means the last page. Requires an account-level key: agent-bound keys cannot enumerate the workspace.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents","href":"/api-reference/agents/list-agents"},{"title":"Create an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents","href":"/api-reference/agents/create-an-agent"},{"title":"Suggest a name for a new agent","description":"Returns a suggested name and avatar for an agent you are about to create, drawn from the workspace's avatar presets. Use it to prefill a creation form. Returns `{ suggestion: null }` when the workspace has no presets.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/suggest","href":"/api-reference/agents/suggest-a-name-for-a-new-agent"},{"title":"Get an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}","href":"/api-reference/agents/get-an-agent"}]},{"group":"API keys","pages":[{"title":"List an agent's API keys","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/api-keys","href":"/api-reference/api-keys/list-an-agents-api-keys"},{"title":"Create an API key for an agent","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /agents/{agentId}/api-keys","href":"/api-reference/api-keys/create-an-api-key-for-an-agent"},{"title":"Revoke an API key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agentId}/api-keys/{id}","href":"/api-reference/api-keys/revoke-an-api-key"}]},{"group":"Secrets","pages":[{"title":"List an agent's secret names","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{agentId}/secrets","href":"/api-reference/secrets/list-an-agents-secret-names"},{"title":"Set an agent secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /agents/{agentId}/secrets/{key}","href":"/api-reference/secrets/set-an-agent-secret"},{"title":"Delete an agent secret","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /agents/{agentId}/secrets/{key}","href":"/api-reference/secrets/delete-an-agent-secret"}]}]}]}]},"basePath":"","title":"Create an agent - Skydive","buildId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","deploymentId":"dpl_6PxPD4Fj1JDU9BJxEHvfdUmxKThw","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CASS2Vpq.js","utils-4k9fyWRu.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-UU-UueZb.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BgJ0LOYq.js","snippetPresets-CMgzlMR-.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-DvEUoD2H.js","ApiExamples-BzEJegkK.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CZuQIZdk.js","shallow-Bw5arfMA.js","getApiPlaygroundDisplay-Ds834aVN.js","CodeSnippet-CKzmjw9L.js","CodeSnippets-BRpgomdp.js","getPastedJson-B0N-Tn76.js","icon-DASMs9nC.js","MethodPill-BA6DBLqx.js","DuplicateIcon-BMT5qfbJ.js","createIcon-CNfwVWPx.js","DynamicMarkdown-JYyBNlrJ.js","SectionHeading-BbZnmz8a.js","axios-vUo_bRtp.js","Markdown-LUU0YLpA.js","clsx-Di4ek5Ae.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-VEVWQCR4.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CPszyu99.js"]}