Clerk session JWT for the web app (active organization required), or an organization-scoped SEAOTTER access key (so_…) from POST /api/v1/api-keys for programmatic / docs try-it / MCP use. The same so_… value is both Authorization: Bearer so_… and SEAOTTER_API_KEY.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"SEAOTTER","description":"Managed control plane for Hermes Agent — always-on hosted agents on Google Cloud, without a VPS or SSH. Docs for seaotter.dev (not seaotter.ai).","colors":{"primary":"#0089FF","light":"#00C8C8","dark":"#0007CD"},"logo":{"light":"https://mintcdn.com/seaotter/vsLevuR0GZI_cgn-/logo/light.png?fit=max\u0026auto=format\u0026n=vsLevuR0GZI_cgn-\u0026q=85\u0026s=01eb0566a3120681fb2120cd0a96d37e","dark":"https://mintcdn.com/seaotter/vsLevuR0GZI_cgn-/logo/dark.png?fit=max\u0026auto=format\u0026n=vsLevuR0GZI_cgn-\u0026q=85\u0026s=e897910f2703b890a94a0d181ae84298","href":"https://seaotter.dev"},"favicon":"https://mintcdn.com/seaotter/vsLevuR0GZI_cgn-/favicon.png?fit=max\u0026auto=format\u0026n=vsLevuR0GZI_cgn-\u0026q=85\u0026s=3cf7a94062f0dc60ed20f72974925a6f","api":{"playground":{"display":"interactive"},"mdx":{"auth":{"method":"bearer"}}},"background":{"color":{"light":"#F4F4F5","dark":"#0F0F0F"}},"navbar":{"links":[{"href":"https://seaotter.dev","label":"App"},{"href":"https://seaotter.dev/trust","label":"Trust"},{"href":"https://seaotter.dev/status","label":"Status"}],"primary":{"type":"button","label":"Dashboard","href":"https://seaotter.dev/dashboard"}},"footer":{"socials":{"website":"https://seaotter.dev"}},"seo":{"organization":{"id":"https://seaotter.dev/#organization","name":"SEAOTTER","url":"https://seaotter.dev","logo":"https://seaotter.dev/brand/og-image.png","sameAs":["https://docs.seaotter.dev/","https://hermes-agent.nousresearch.com/docs"]},"indexing":"all"},"fonts":{"family":"DM Sans"},"contextual":{"options":["copy","download-spec"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"guides/what-is-seaotter"},{"language":"de","navbar":{"links":[{"href":"https://seaotter.dev/de","label":"App"},{"href":"https://seaotter.dev/de/trust","label":"Trust"},{"href":"https://seaotter.dev/de/status","label":"Status"},{"href":"https://seaotter.dev/de/blog","label":"Blog"}],"primary":{"type":"button","label":"Dashboard","href":"https://seaotter.dev/dashboard"}},"href":"de/guides/what-is-seaotter"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"seaotter","hasAudioNarration":false,"actualSubdomain":"seaotter","customDomains":["docs.seaotter.dev"],"gitSource":{"type":"github","owner":"ryan-ray-martin","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6aa95ffe42b658e02ca01fc4","collectionId":"ce796d33-783f-43b4-aee2-4c52ba725998","liveDeploymentHistoryId":"6aa95ffe42b658e02ca01fc4","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aa95ffe42b658e02ca01fc4","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"en","tag":"API reference","count":50},{"language":"en","tag":"agents","count":26},{"language":"en","tag":"Guides","count":16},{"language":"de","tag":"Guides","count":8},{"language":"en","tag":"Concepts","count":6},{"language":"en","tag":"Connect from chat","count":6},{"language":"en","tag":"billing","count":5},{"language":"en","tag":"Get started","count":4},{"language":"en","tag":"organizations","count":4},{"language":"en","tag":"users","count":4},{"language":"de","tag":"Aus dem Chat verbinden","count":4},{"language":"de","tag":"Konzepte","count":2},{"language":"de","tag":"Einstieg","count":2},{"language":"en","tag":"health","count":1}],"searchSettings":{"maxResults":10,"isFiltersEnabled":false}},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--seaotter-void:#0f0f0f;--seaotter-signal:#0089ff;--seaotter-page:#f4f4f5}.font-mono,code,pre{font-family:\"JetBrains Mono\",ui-monospace,SFMono-Regular,Menlo,monospace;letter-spacing:-.02em}"}],"page":{"pagePath":"api-reference/agents/agent-metrics","slug":"/api-reference/agents/agent-metrics","pageMetadata":{"title":"Agent Metrics","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/metrics","href":"/api-reference/agents/agent-metrics","autogeneratedByOpenApi":true},"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":"Agent Metrics","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/metrics","href":"/api-reference/agents/agent-metrics","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["agents"],"summary":"Agent Metrics","operationId":"agent_metrics_api_v1_agents__agent_id__metrics_get","security":["cafb1344-f60f-48ad-bfdb-7d527ef084a8"],"parameters":["1743058f-8eab-4f2b-9ba7-878c2c0f4f8f"],"responses":{"200":"37c3bf0b-c0d4-402e-a613-ca1554df1482","401":"e08e5763-a818-41e4-81bf-de173023884e","403":"ec420c44-9d93-480c-943d-56be7941c88f","404":"6118cc2d-fb53-4d20-ab92-460dfd6a86de","422":"f3fd4967-ab26-4568-b895-916af4c0596f"},"method":"get","type":"path","servers":["b0ac8949-0e0a-4ccc-bad3-04e55aaa3dbe","81ac6a24-60d0-4ce7-a772-008d01efca58","78690cb1-7730-44eb-92e4-3ea39c0c9d79"],"path":"/api/v1/agents/{agent_id}/metrics","baseUrlOptions":["https://api.seaotter.dev","https://seaotter-api-bpenevambq-uc.a.run.app","http://localhost:8000"],"title":"Agent Metrics","description":"","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1743058f-8eab-4f2b-9ba7-878c2c0f4f8f":{"name":"agent_id","in":"path","required":true,"schema":{"type":"string","format":"uuid","title":"Agent Id","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"}}},"responses":{"37c3bf0b-c0d4-402e-a613-ca1554df1482":{"description":"Successful Response","content":{"application/json":{"schema":{"properties":{"cpu_pct":{"oneOf":[{"type":"number","title":"Cpu Pct","description":"CPU vs plan limit (%)","uniqueKey":"cpu_pct.oneOf.0","typeLabel":"number"},{"type":"null","title":"Cpu Pct","description":"CPU vs plan limit (%)","uniqueKey":"cpu_pct.oneOf.1","typeLabel":"null"}],"uniqueKey":"cpu_pct","typeLabel":"number | null"},"mem_pct":{"oneOf":[{"type":"number","title":"Mem Pct","description":"Memory vs plan limit (%)","uniqueKey":"mem_pct.oneOf.0","typeLabel":"number"},{"type":"null","title":"Mem Pct","description":"Memory vs plan limit (%)","uniqueKey":"mem_pct.oneOf.1","typeLabel":"null"}],"uniqueKey":"mem_pct","typeLabel":"number | null"},"restarts_24h":{"oneOf":[{"type":"integer","title":"Restarts 24H","uniqueKey":"restarts_24h.oneOf.0","typeLabel":"integer"},{"type":"null","title":"Restarts 24H","uniqueKey":"restarts_24h.oneOf.1","typeLabel":"null"}],"uniqueKey":"restarts_24h","typeLabel":"integer | null"},"pvc_pct":{"oneOf":[{"type":"number","title":"Pvc Pct","description":"PVC usage vs plan storage (%)","uniqueKey":"pvc_pct.oneOf.0","typeLabel":"number"},{"type":"null","title":"Pvc Pct","description":"PVC usage vs plan storage (%)","uniqueKey":"pvc_pct.oneOf.1","typeLabel":"null"}],"uniqueKey":"pvc_pct","typeLabel":"number | null"},"uptime_pct_24h":{"oneOf":[{"type":"number","title":"Uptime Pct 24H","uniqueKey":"uptime_pct_24h.oneOf.0","typeLabel":"number"},{"type":"null","title":"Uptime Pct 24H","uniqueKey":"uptime_pct_24h.oneOf.1","typeLabel":"null"}],"uniqueKey":"uptime_pct_24h","typeLabel":"number | null"},"latency_p95_ms":{"oneOf":[{"type":"number","title":"Latency P95 Ms","description":"Null until Managed Prometheus scrapes with Host match","uniqueKey":"latency_p95_ms.oneOf.0","typeLabel":"number"},{"type":"null","title":"Latency P95 Ms","description":"Null until Managed Prometheus scrapes with Host match","uniqueKey":"latency_p95_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"latency_p95_ms","typeLabel":"number | null"},"cpu_cores":{"oneOf":[{"type":"number","title":"Cpu Cores","uniqueKey":"cpu_cores.oneOf.0","typeLabel":"number"},{"type":"null","title":"Cpu Cores","uniqueKey":"cpu_cores.oneOf.1","typeLabel":"null"}],"uniqueKey":"cpu_cores","typeLabel":"number | null"},"memory_bytes":{"oneOf":[{"type":"number","title":"Memory Bytes","uniqueKey":"memory_bytes.oneOf.0","typeLabel":"number"},{"type":"null","title":"Memory Bytes","uniqueKey":"memory_bytes.oneOf.1","typeLabel":"null"}],"uniqueKey":"memory_bytes","typeLabel":"number | null"},"series":{"oneOf":[{"type":"object","title":"MetricsSeries","properties":{"cpu":{"items":{"properties":{"t":{"oneOf":[{"type":"number","title":"T","description":"Unix timestamp or series index","isRequired":true,"uniqueKey":"series.oneOf.0.cpu.items.[INDEX].t.oneOf.0","typeLabel":"number"},{"type":"integer","title":"T","description":"Unix timestamp or series index","isRequired":true,"uniqueKey":"series.oneOf.0.cpu.items.[INDEX].t.oneOf.1","typeLabel":"integer"}],"isRequired":true,"uniqueKey":"series.oneOf.0.cpu.items.[INDEX].t","typeLabel":"number | integer"},"v":{"type":"number","title":"V","description":"Sample value","isRequired":true,"uniqueKey":"series.oneOf.0.cpu.items.[INDEX].v","typeLabel":"number"}},"type":"object","required":["t","v"],"title":"MetricPoint","uniqueKey":"series.oneOf.0.cpu.items.[INDEX]","typeLabel":"MetricPoint · object"},"type":"array","title":"Cpu","uniqueKey":"series.oneOf.0.cpu","typeLabel":"MetricPoint · object[]"},"memory":{"items":{"properties":{"t":{"oneOf":[{"type":"number","title":"T","description":"Unix timestamp or series index","isRequired":true,"uniqueKey":"series.oneOf.0.memory.items.[INDEX].t.oneOf.0","typeLabel":"number"},{"type":"integer","title":"T","description":"Unix timestamp or series index","isRequired":true,"uniqueKey":"series.oneOf.0.memory.items.[INDEX].t.oneOf.1","typeLabel":"integer"}],"isRequired":true,"uniqueKey":"series.oneOf.0.memory.items.[INDEX].t","typeLabel":"number | integer"},"v":{"type":"number","title":"V","description":"Sample value","isRequired":true,"uniqueKey":"series.oneOf.0.memory.items.[INDEX].v","typeLabel":"number"}},"type":"object","required":["t","v"],"title":"MetricPoint","uniqueKey":"series.oneOf.0.memory.items.[INDEX]","typeLabel":"MetricPoint · object"},"type":"array","title":"Memory","uniqueKey":"series.oneOf.0.memory","typeLabel":"MetricPoint · object[]"},"requests":{"items":{"properties":{"t":{"oneOf":[{"type":"number","title":"T","description":"Unix timestamp or series index","isRequired":true,"uniqueKey":"series.oneOf.0.requests.items.[INDEX].t.oneOf.0","typeLabel":"number"},{"type":"integer","title":"T","description":"Unix timestamp or series index","isRequired":true,"uniqueKey":"series.oneOf.0.requests.items.[INDEX].t.oneOf.1","typeLabel":"integer"}],"isRequired":true,"uniqueKey":"series.oneOf.0.requests.items.[INDEX].t","typeLabel":"number | integer"},"v":{"type":"number","title":"V","description":"Sample value","isRequired":true,"uniqueKey":"series.oneOf.0.requests.items.[INDEX].v","typeLabel":"number"}},"type":"object","required":["t","v"],"title":"MetricPoint","uniqueKey":"series.oneOf.0.requests.items.[INDEX]","typeLabel":"MetricPoint · object"},"type":"array","title":"Requests","uniqueKey":"series.oneOf.0.requests","typeLabel":"MetricPoint · object[]"},"errors":{"items":{"properties":{"t":{"oneOf":[{"type":"number","title":"T","description":"Unix timestamp or series index","isRequired":true,"uniqueKey":"series.oneOf.0.errors.items.[INDEX].t.oneOf.0","typeLabel":"number"},{"type":"integer","title":"T","description":"Unix timestamp or series index","isRequired":true,"uniqueKey":"series.oneOf.0.errors.items.[INDEX].t.oneOf.1","typeLabel":"integer"}],"isRequired":true,"uniqueKey":"series.oneOf.0.errors.items.[INDEX].t","typeLabel":"number | integer"},"v":{"type":"number","title":"V","description":"Sample value","isRequired":true,"uniqueKey":"series.oneOf.0.errors.items.[INDEX].v","typeLabel":"number"}},"type":"object","required":["t","v"],"title":"MetricPoint","uniqueKey":"series.oneOf.0.errors.items.[INDEX]","typeLabel":"MetricPoint · object"},"type":"array","title":"Errors","uniqueKey":"series.oneOf.0.errors","typeLabel":"MetricPoint · object[]"}},"additionalProperties":true,"uniqueKey":"series.oneOf.0","typeLabel":"MetricsSeries · object"},{"type":"object","title":"Series","additionalProperties":true,"uniqueKey":"series.oneOf.1","typeLabel":"Series · object"},{"type":"null","title":"Series","uniqueKey":"series.oneOf.2","typeLabel":"null"}],"uniqueKey":"series","typeLabel":"MetricsSeries · object | Series · object | null"}},"additionalProperties":true,"type":"object","title":"AgentMetricsOut","uniqueKey":"","typeLabel":"AgentMetricsOut · object"},"examples":{"Example":{"title":"Example","value":{"cpu_pct":123,"mem_pct":123,"restarts_24h":123,"pvc_pct":123,"uptime_pct_24h":123,"latency_p95_ms":123,"cpu_cores":123,"memory_bytes":123,"series":{"cpu":[{"t":123,"v":123}],"memory":[{"t":123,"v":123}],"requests":[{"t":123,"v":123}],"errors":[{"t":123,"v":123}]}}}},"exampleType":"generated"}},"exampleType":"generated"},"e08e5763-a818-41e4-81bf-de173023884e":{"description":"Missing or invalid Bearer token (Clerk JWT or so_ API key)","content":{"application/json":{"schema":{"properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Human-readable error, or validation error list","example":"Agent not found","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"any"},"title":"Detail","description":"Human-readable error, or validation error list","example":"Agent not found","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"any[]"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | any[]"}},"type":"object","required":["detail"],"title":"ErrorBody","description":"Standard FastAPI / SEAOTTER error payload.","uniqueKey":"","typeLabel":"ErrorBody · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Agent not found"}}},"exampleType":"generated"}},"exampleType":"generated"},"ec420c44-9d93-480c-943d-56be7941c88f":{"description":"Authenticated but not permitted (role or plan gate)","content":{"application/json":{"schema":{"properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Human-readable error, or validation error list","example":"Agent not found","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"any"},"title":"Detail","description":"Human-readable error, or validation error list","example":"Agent not found","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"any[]"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | any[]"}},"type":"object","required":["detail"],"title":"ErrorBody","description":"Standard FastAPI / SEAOTTER error payload.","uniqueKey":"","typeLabel":"ErrorBody · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Agent not found"}}},"exampleType":"generated"}},"exampleType":"generated"},"6118cc2d-fb53-4d20-ab92-460dfd6a86de":{"description":"Resource not found","content":{"application/json":{"schema":{"properties":{"detail":{"oneOf":[{"type":"string","title":"Detail","description":"Human-readable error, or validation error list","example":"Agent not found","isRequired":true,"uniqueKey":"detail.oneOf.0","typeLabel":"string"},{"type":"array","items":{"oneOf":[{}],"uniqueKey":"detail.oneOf.1.items.[INDEX]","typeLabel":"any"},"title":"Detail","description":"Human-readable error, or validation error list","example":"Agent not found","isRequired":true,"uniqueKey":"detail.oneOf.1","typeLabel":"any[]"}],"isRequired":true,"uniqueKey":"detail","typeLabel":"string | any[]"}},"type":"object","required":["detail"],"title":"ErrorBody","description":"Standard FastAPI / SEAOTTER error payload.","uniqueKey":"","typeLabel":"ErrorBody · object"},"examples":{"Example":{"title":"Example","value":{"detail":"Agent not found"}}},"exampleType":"generated"}},"exampleType":"generated"},"f3fd4967-ab26-4568-b895-916af4c0596f":{"description":"Validation Error","content":{"application/json":{"schema":{"properties":{"detail":{"items":{"properties":{"loc":{"items":{"oneOf":[{"type":"string","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.0","typeLabel":"string"},{"type":"integer","uniqueKey":"detail.items.[INDEX].loc.items.[INDEX].oneOf.1","typeLabel":"integer"}],"uniqueKey":"detail.items.[INDEX].loc.items.[INDEX]","typeLabel":"string | integer"},"type":"array","title":"Location","isRequired":true,"uniqueKey":"detail.items.[INDEX].loc","typeLabel":"(string | integer)[]"},"msg":{"type":"string","title":"Message","isRequired":true,"uniqueKey":"detail.items.[INDEX].msg","typeLabel":"string"},"type":{"type":"string","title":"Error Type","isRequired":true,"uniqueKey":"detail.items.[INDEX].type","typeLabel":"string"},"input":{"oneOf":[{"title":"Input"}],"uniqueKey":"detail.items.[INDEX].input","typeLabel":"any"},"ctx":{"type":"object","title":"Context","uniqueKey":"detail.items.[INDEX].ctx","typeLabel":"Context · object"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError","uniqueKey":"detail.items.[INDEX]","typeLabel":"ValidationError · object"},"type":"array","title":"Detail","uniqueKey":"detail","typeLabel":"ValidationError · object[]"}},"type":"object","title":"HTTPValidationError","uniqueKey":"","typeLabel":"HTTPValidationError · object"},"examples":{"Example":{"title":"Example","value":{"detail":[{"loc":["\u003cstring>"],"msg":"\u003cstring>","type":"\u003cstring>","input":"\u003cunknown>","ctx":{}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"cafb1344-f60f-48ad-bfdb-7d527ef084a8":{"HTTPBearer":{"type":"http","scheme":"bearer","bearerFormat":"JWT or so_ API key","description":"Clerk session JWT for the web app (active organization required), or an organization-scoped SEAOTTER access key (`so_…`) from POST /api/v1/api-keys for programmatic / docs try-it / MCP use. The same `so_…` value is both `Authorization: Bearer so_…` and `SEAOTTER_API_KEY`.","scopes":[]}}},"servers":{"b0ac8949-0e0a-4ccc-bad3-04e55aaa3dbe":{"url":"https://api.seaotter.dev","description":"Production"},"81ac6a24-60d0-4ce7-a772-008d01efca58":{"url":"https://seaotter-api-bpenevambq-uc.a.run.app","description":"Production (Cloud Run URL)"},"78690cb1-7730-44eb-92e4-3ea39c0c9d79":{"url":"http://localhost:8000","description":"Local development"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT or so_ API key","description":"Clerk session JWT for the web app (active organization required), or an organization-scoped SEAOTTER access key (`so_…`) from POST /api/v1/api-keys for programmatic / docs try-it / MCP use. The same `so_…` value is both `Authorization: Bearer so_…` and `SEAOTTER_API_KEY`.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Clerk session JWT for the web app (active organization required), or an organization-scoped SEAOTTER access key (`so_…`) from POST /api/v1/api-keys for programmatic / docs try-it / MCP use. The same `so_…` value is both `Authorization: Bearer so_…` and `SEAOTTER_API_KEY`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"HTTPBearer","name":"Authorization"}],"title":"HTTPBearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"seaotter","siteName":"SEAOTTER","title":"Agent Metrics - SEAOTTER","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/agents/agent-metrics","matchLevel":0},"de":{"href":"/de/guides/what-is-seaotter","matchLevel":4}}},"lastModified":"2026-09-15T15:11:06.146Z","originalFileLocation":"api-reference/agents/agent-metrics.mdx","locale":"en"},"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=\"application-name\" content=\"SEAOTTER\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/seaotter/gMsGHmVrIPeY7feN/_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/seaotter/gMsGHmVrIPeY7feN/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/seaotter/gMsGHmVrIPeY7feN/_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/seaotter/gMsGHmVrIPeY7feN/_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/seaotter/gMsGHmVrIPeY7feN/_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/seaotter/gMsGHmVrIPeY7feN/_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/seaotter/gMsGHmVrIPeY7feN/_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/seaotter/gMsGHmVrIPeY7feN/_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/seaotter/gMsGHmVrIPeY7feN/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Agent Metrics - SEAOTTER\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"SEAOTTER\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.seaotter.dev/api-reference/agents/agent-metrics\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://seaotter.mintlify.app/_mintlify/api/og/v2?division=agents\u0026amp;title=Agent+Metrics\u0026amp;theme=706f1d968f93b28557093d9f\u0026amp;signature=56757b5b93ec913f644f2a0009bce57e2df74b619781581cc73292c84fb52fb1\">\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=\"Agent Metrics - SEAOTTER\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://seaotter.mintlify.app/_mintlify/api/og/v2?division=agents\u0026amp;title=Agent+Metrics\u0026amp;theme=706f1d968f93b28557093d9f\u0026amp;signature=56757b5b93ec913f644f2a0009bce57e2df74b619781581cc73292c84fb52fb1\">\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/seaotter/gMsGHmVrIPeY7feN/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"SEAOTTER\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0089FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.seaotter.dev/api-reference/agents/agent-metrics\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/agents/agent-metrics.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://seaotter.dev/#organization\",\"name\":\"SEAOTTER\",\"url\":\"https://seaotter.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://seaotter.dev/brand/og-image.png\"},\"sameAs\":[\"https://docs.seaotter.dev/\",\"https://hermes-agent.nousresearch.com/docs\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.seaotter.dev#website\",\"name\":\"SEAOTTER\",\"url\":\"https://docs.seaotter.dev\",\"publisher\":{\"@id\":\"https://seaotter.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.seaotter.dev/api-reference/agents/agent-metrics#webpage\",\"url\":\"https://docs.seaotter.dev/api-reference/agents/agent-metrics\",\"name\":\"Agent Metrics\",\"dateModified\":\"2026-09-15T15:11:06.146Z\",\"isPartOf\":{\"@id\":\"https://docs.seaotter.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.seaotter.dev/api-reference/agents/agent-metrics#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.seaotter.dev/api-reference/agents/agent-metrics#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"agents\",\"item\":\"https://docs.seaotter.dev/api-reference/agents/list-agents\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Agent Metrics\",\"item\":\"https://docs.seaotter.dev/api-reference/agents/agent-metrics\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.seaotter.dev/api-reference/agents/agent-metrics#apireference\",\"headline\":\"Agent Metrics\",\"name\":\"Agent Metrics\",\"url\":\"https://docs.seaotter.dev/api-reference/agents/agent-metrics\",\"mainEntityOfPage\":{\"@id\":\"https://docs.seaotter.dev/api-reference/agents/agent-metrics#webpage\"},\"dateModified\":\"2026-09-15T15:11:06.146Z\",\"publisher\":{\"@id\":\"https://seaotter.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.seaotter.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"SEAOTTER\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"SEAOTTER","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/what-is-seaotter"}]},{"tab":"API reference","groups":[{"group":"API reference","pages":[{"title":"API overview","sidebarTitle":"Overview","href":"/api-reference/overview"},{"title":"List agents","sidebarTitle":"List agents","href":"/api-reference/list-agents"},{"title":"Create agent","sidebarTitle":"Create agent","href":"/api-reference/create-agent"},{"title":"Get agent","sidebarTitle":"Get agent","href":"/api-reference/get-agent"},{"title":"Create API key","sidebarTitle":"Create API key","href":"/api-reference/create-api-key"}]},{"group":"agents","pages":[{"title":"List Agents","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents","href":"/api-reference/agents/list-agents"},{"title":"Create agent","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents","href":"/api-reference/agents/create-agent"},{"title":"Get agent","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}","href":"/api-reference/agents/get-agent"},{"title":"Delete Agent","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/agents/{agent_id}","href":"/api-reference/agents/delete-agent"},{"title":"Update Agent","deprecated":null,"version":null,"openapi":"/openapi.json patch /api/v1/agents/{agent_id}","href":"/api-reference/agents/update-agent"},{"title":"Probe Hermes dashboard","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/dashboard-reachability","href":"/api-reference/agents/probe-hermes-dashboard"},{"title":"Reprovision Agent","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/reprovision","href":"/api-reference/agents/reprovision-agent"},{"title":"List Agent Backups","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/backups","href":"/api-reference/agents/list-agent-backups"},{"title":"Restore Agent","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/restore","href":"/api-reference/agents/restore-agent"},{"title":"Migrate Agent Sandbox","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/migrate-sandbox","href":"/api-reference/agents/migrate-agent-sandbox"},{"title":"Reveal Agent Credentials","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/credentials/reveal","href":"/api-reference/agents/reveal-agent-credentials"},{"title":"Rotate Agent Credentials","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/credentials/rotate","href":"/api-reference/agents/rotate-agent-credentials"},{"title":"Update Dashboard Auth","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/agents/{agent_id}/dashboard-auth","href":"/api-reference/agents/update-dashboard-auth"},{"title":"Start Agent","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/start","href":"/api-reference/agents/start-agent"},{"title":"Stop Agent","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/stop","href":"/api-reference/agents/stop-agent"},{"title":"Restart Agent","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/restart","href":"/api-reference/agents/restart-agent"},{"title":"Agent Logs","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/logs","href":"/api-reference/agents/agent-logs"},{"title":"Agent Metrics","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/metrics","href":"/api-reference/agents/agent-metrics"},{"title":"Get Alert Preferences","description":null,"deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/alert-preferences","href":"/api-reference/agents/get-alert-preferences"},{"title":"Put Alert Preferences","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/agents/{agent_id}/alert-preferences","href":"/api-reference/agents/put-alert-preferences"},{"title":"Upsert secret","deprecated":null,"version":null,"openapi":"/openapi.json put /api/v1/agents/{agent_id}/secrets","href":"/api-reference/agents/upsert-secret"},{"title":"Delete secret","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/agents/{agent_id}/secrets/{key}","href":"/api-reference/agents/delete-secret"},{"title":"Get secret operation status","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/agents/{agent_id}/secret-operations/{operation_id}","href":"/api-reference/agents/get-secret-operation-status"},{"title":"Reconcile secret operation","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/secret-operations/{operation_id}/reconcile","href":"/api-reference/agents/reconcile-secret-operation"},{"title":"Exec hermes CLI","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/exec","href":"/api-reference/agents/exec-hermes-cli"},{"title":"Record Usage","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/agents/{agent_id}/usage","href":"/api-reference/agents/record-usage"}]},{"group":"billing","pages":[{"title":"List Plans","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/billing/plans","href":"/api-reference/billing/list-plans"},{"title":"Billing Catalog","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/billing/catalog","href":"/api-reference/billing/billing-catalog"},{"title":"Get Subscription","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/billing/subscription","href":"/api-reference/billing/get-subscription"},{"title":"Checkout","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/billing/checkout","href":"/api-reference/billing/checkout"},{"title":"Portal","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/billing/portal","href":"/api-reference/billing/portal"}]},{"group":"users","pages":[{"title":"Me","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/me","href":"/api-reference/users/me"},{"title":"List Keys","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/api-keys","href":"/api-reference/users/list-keys"},{"title":"Create API key","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/api-keys","href":"/api-reference/users/create-api-key"},{"title":"Revoke Key","deprecated":null,"version":null,"openapi":"/openapi.json delete /api/v1/api-keys/{key_id}","href":"/api-reference/users/revoke-key"}]},{"group":"organizations","pages":[{"title":"Current organization","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/organizations/me","href":"/api-reference/organizations/current-organization"},{"title":"Ensure personal Hobby workspace","deprecated":null,"version":null,"openapi":"/openapi.json post /api/v1/organizations/personal-workspace","href":"/api-reference/organizations/ensure-personal-hobby-workspace"},{"title":"List Audit Log","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/organizations/{org_id}/audit-log","href":"/api-reference/organizations/list-audit-log"},{"title":"Export Audit Log","deprecated":null,"version":null,"openapi":"/openapi.json get /api/v1/organizations/{org_id}/audit-log/export","href":"/api-reference/organizations/export-audit-log"}]},{"group":"health","pages":[{"title":"Health","deprecated":null,"version":null,"openapi":"/openapi.json get /health","href":"/api-reference/health/health"}]}]}]},{"language":"de","navbar":{"links":[{"href":"https://seaotter.dev/de","label":"App"},{"href":"https://seaotter.dev/de/trust","label":"Trust"},{"href":"https://seaotter.dev/de/status","label":"Status"},{"href":"https://seaotter.dev/de/blog","label":"Blog"}],"primary":{"type":"button","label":"Dashboard","href":"https://seaotter.dev/dashboard"}},"pages":[{"title":"de","href":"/de/guides/what-is-seaotter"}]}]},"basePath":"","title":"Agent Metrics - SEAOTTER","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","Page-DSVu9Ucl.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}