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>"
}
{"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":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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}],"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/get-an-agent","slug":"/api-reference/agents/get-an-agent","pageMetadata":{"title":"Get an agent","description":"Returns a single agent by id. Responds `404` when the agent does not exist or is not visible to you; the two cases are deliberately indistinguishable.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}","href":"/api-reference/agents/get-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: [\"Returns a single agent by id. Responds \", _jsx(_components.code, {\n children: \"404\"\n }), \" when the agent does not exist or is not visible to you; the two cases are deliberately indistinguishable.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get an agent","description":"Returns a single agent by id. Responds `404` when the agent does not exist or is not visible to you; the two cases are deliberately indistinguishable.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /agents/{id}","href":"/api-reference/agents/get-an-agent","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getAgent","tags":["Agents"],"summary":"Get an agent","description":"Returns a single agent by id. Responds `404` when the agent does not exist or is not visible to you; the two cases are deliberately indistinguishable.","parameters":["f5ae9381-8174-47e6-9b13-382c0f936241"],"responses":{"200":"54afc268-3608-410c-994c-2538e92074c3","401":"9ac7d2a2-a61e-47ae-87a2-115521a89f07","403":"5a53a7f8-f880-4fe3-9eed-8fb8320dcac0","404":"db801302-c490-4e81-b5b8-42a2f7a51451"},"method":"get","type":"path","servers":["3b10ae10-029d-4011-af13-83ad4363009a"],"security":["977eeb31-84ba-4938-bdb0-f87100f850eb"],"path":"/agents/{id}","baseUrlOptions":["https://api.skydive.com/v1"],"title":"Get an agent","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f5ae9381-8174-47e6-9b13-382c0f936241":{"schema":{"type":"string","description":"The agent id.","isRequired":true,"uniqueKey":"","typeLabel":"string"},"required":true,"name":"id","in":"path"}},"responses":{"54afc268-3608-410c-994c-2538e92074c3":{"description":"The agent.","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"},"9ac7d2a2-a61e-47ae-87a2-115521a89f07":{"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"},"5a53a7f8-f880-4fe3-9eed-8fb8320dcac0":{"description":"The key is not authorized for this agent.","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"},"db801302-c490-4e81-b5b8-42a2f7a51451":{"description":"The agent does not exist or is not visible to you.","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":"Get an agent - Skydive","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T19:31:26.013Z","originalFileLocation":"api-reference/agents/get-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=\"Returns a single agent by id. Responds 404 when the agent does not exist or is not visible to you; the two cases are deliberately indistinguishable.\">\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=\"Get an agent - Skydive\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns a single agent by id. Responds 404 when the agent does not exist or is not visible to you; the two cases are deliberately indistinguishable.\">\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/get-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=Get+an+agent\u0026amp;description=Returns+a+single+agent+by+id.+Responds+%60404%60+when+the+agent+does+not+exist+or+is+not+visible+to+you%3B+the+two+cases+are+deliberately+indistinguishable.\u0026amp;theme=61df4e3cda3b39df4814e0db\u0026amp;signature=1592e2926c33d6498ce10c577d836176d65a8fb28f99e354382336cc056defa4\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get an agent - Skydive\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns a single agent by id. Responds 404 when the agent does not exist or is not visible to you; the two cases are deliberately indistinguishable.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://skydive.mintlify.site/docs/_mintlify/api/og/v2?division=Agents\u0026amp;title=Get+an+agent\u0026amp;description=Returns+a+single+agent+by+id.+Responds+%60404%60+when+the+agent+does+not+exist+or+is+not+visible+to+you%3B+the+two+cases+are+deliberately+indistinguishable.\u0026amp;theme=61df4e3cda3b39df4814e0db\u0026amp;signature=1592e2926c33d6498ce10c577d836176d65a8fb28f99e354382336cc056defa4\">\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/get-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/get-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/get-an-agent#webpage\",\"url\":\"https://www.skydive.com/docs/api-reference/agents/get-an-agent\",\"name\":\"Get an agent\",\"description\":\"Returns a single agent by id. Responds 404 when the agent does not exist or is not visible to you; the two cases are deliberately indistinguishable.\",\"dateModified\":\"2026-11-02T19:31:26.013Z\",\"isPartOf\":{\"@id\":\"https://www.skydive.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.skydive.com/docs/api-reference/agents/get-an-agent#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.skydive.com/docs/api-reference/agents/get-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\":\"Get an agent\",\"item\":\"https://www.skydive.com/docs/api-reference/agents/get-an-agent\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.skydive.com/docs/api-reference/agents/get-an-agent#apireference\",\"headline\":\"Get an agent\",\"name\":\"Get an agent\",\"description\":\"Returns a single agent by id. Responds 404 when the agent does not exist or is not visible to you; the two cases are deliberately indistinguishable.\",\"url\":\"https://www.skydive.com/docs/api-reference/agents/get-an-agent\",\"mainEntityOfPage\":{\"@id\":\"https://www.skydive.com/docs/api-reference/agents/get-an-agent#webpage\"},\"dateModified\":\"2026-11-02T19:31:26.013Z\",\"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/get-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","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","description":"Returns metadata for an agent's active (non-revoked) API keys: name, display prefix, creation and last-use timestamps. The secret key value is never included; only the first characters are shown, enough to tell keys apart. You must have edit access to the agent.","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":"Get 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"]}