{"openapi":"3.1.0","info":{"title":"AgentMason API","version":"0.1.0","summary":"Full API reference for the current AgentMason MVP.","description":"This spec includes the stable public MCP surface, shareable chat links, and current workspace/operator APIs. Endpoints marked MVP, Operator, Internal, or Framework may change before a hosted multi-tenant launch."},"servers":[{"url":"https://agentmason.app","description":"Current production-safe host"},{"url":"https://your-agentmason-domain.example.com","description":"Production example"}],"tags":[{"name":"Docs","description":"3 documented operations."},{"name":"MCP Public API","description":"6 documented operations."},{"name":"Agents","description":"6 documented operations."},{"name":"Runs","description":"2 documented operations."},{"name":"Chat","description":"4 documented operations."},{"name":"Marketplace","description":"2 documented operations."},{"name":"Deployments","description":"4 documented operations."},{"name":"Drives","description":"7 documented operations."},{"name":"MCP Servers","description":"5 documented operations."},{"name":"API Keys","description":"3 documented operations."},{"name":"Schedules","description":"5 documented operations."},{"name":"Connectors","description":"3 documented operations."},{"name":"Integrations","description":"4 documented operations."},{"name":"Metrics and Evals","description":"4 documented operations."},{"name":"Resolver","description":"1 documented operation."},{"name":"Runtime Internal","description":"1 documented operation."},{"name":"Auth","description":"2 documented operations."}],"paths":{"/api-docs":{"get":{"tags":["Docs"],"operationId":"getApiDocsBrowseApiDocs0","summary":"Browse API docs","description":"Human-readable API reference with auth, resource groups, and examples.\n\nAudience: Docs. Stability: Public. Auth: No key.","security":[],"x-agentmason-auth":["No key"],"parameters":[],"responses":{"200":{"description":"Human-readable API reference with auth, resource groups, and examples.","content":{"text/html":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[]}},"/openapi.json":{"get":{"tags":["Docs"],"operationId":"getOpenapiJsonDownloadOpenapiSpec1","summary":"Download OpenAPI spec","description":"OpenAPI 3.1 document importable into Swagger, Redoc, Scalar, Postman, or API gateways.\n\nAudience: Docs. Stability: Public. Auth: No key.","security":[],"x-agentmason-auth":["No key"],"parameters":[],"responses":{"200":{"description":"OpenAPI 3.1 document importable into Swagger, Redoc, Scalar, Postman, or API gateways.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"openapi":"3.1.0","info":{"title":"agentmason API"}}},"examples":{"example":{"value":{"openapi":"3.1.0","info":{"title":"agentmason API"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/openapi.json\""}]}},"/api/openapi":{"get":{"tags":["Docs"],"operationId":"getApiOpenapiDownloadOpenapiSpecFromApiNamespace2","summary":"Download OpenAPI spec from API namespace","description":"Alias for clients that expect specs under the API namespace.\n\nAudience: Docs. Stability: Public. Auth: No key.","security":[],"x-agentmason-auth":["No key"],"parameters":[],"responses":{"200":{"description":"Alias for clients that expect specs under the API namespace.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"openapi":"3.1.0","info":{"title":"agentmason API"}}},"examples":{"example":{"value":{"openapi":"3.1.0","info":{"title":"agentmason API"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/openapi\""}]}},"/api/mcp":{"get":{"tags":["MCP Public API"],"operationId":"getApiMcpDiscoverMcpMetadata3","summary":"Discover MCP metadata","description":"Returns protocol version, endpoint URL, and public/authenticated MCP access rules.\n\nAudience: Stable Public. Stability: Public. Auth: No key.","security":[],"x-agentmason-auth":["No key"],"parameters":[],"responses":{"200":{"description":"Returns protocol version, endpoint URL, and public/authenticated MCP access rules.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"agentmason","protocolVersion":"2025-06-18","endpoint":"https://agentmason.app/api/mcp","auth":"No key for public marketplace discovery; Bearer API key for workspace and run tools."}},"examples":{"example":{"value":{"name":"agentmason","protocolVersion":"2025-06-18","endpoint":"https://agentmason.app/api/mcp","auth":"No key for public marketplace discovery; Bearer API key for workspace and run tools."}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/mcp\""}]},"post":{"tags":["MCP Public API"],"operationId":"postApiMcpInitializeMcpClient4","summary":"Initialize MCP client","description":"MCP JSON-RPC handshake. Anonymous clients can initialize for public catalog tools.\n\nAudience: Stable Public. Stability: Public. Auth: No key.\n\nAlso: List MCP tools - Lists public catalog tools without a key; includes workspace/run tools when a Bearer API key is provided.\n\nAlso: Get agent through MCP - Reads one public marketplace agent by slug without a key; reads workspace/private agents when a Bearer API key is provided.\n\nAlso: Run agent through MCP - Triggers a published agent through the shared runtime. Read-only keys return a JSON-RPC missing write scope error.\n\nAlso: Get run through MCP - Reads a saved run by agent slug and run id. Use the run id returned by REST runs or MCP run_agent.","security":[{"bearerApiKey":[]}],"x-agentmason-auth":["No key","API key: write/admin","API key: read"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}},"examples":{"example":{"value":{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}},"postApiMcpListMcpTools5":{"value":{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}},"postApiMcpGetAgentThroughMcp6":{"value":{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"get_agent","arguments":{"slug":"multi-agent-orchestrator"}}}},"postApiMcpRunAgentThroughMcp7":{"value":{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"run_agent","arguments":{"slug":"multi-agent-orchestrator","input":{"task":"Say hello from curl."}}}}},"postApiMcpGetRunThroughMcp8":{"value":{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"get_run","arguments":{"agentSlug":"multi-agent-orchestrator","runId":"run_123"}}}}}}}},"responses":{"200":{"description":"MCP JSON-RPC handshake. Anonymous clients can initialize for public catalog tools.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-06-18","serverInfo":{"name":"agentmason","version":"0.1.0"},"capabilities":{"tools":{}}}}},"examples":{"example":{"value":{"jsonrpc":"2.0","id":1,"result":{"protocolVersion":"2025-06-18","serverInfo":{"name":"agentmason","version":"0.1.0"},"capabilities":{"tools":{}}}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/mcp\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"initialize\",\n  \"params\": {}\n}'"},{"lang":"curl","label":"List MCP tools: Public request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/mcp\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 2,\n  \"method\": \"tools/list\",\n  \"params\": {}\n}'"},{"lang":"curl","label":"List MCP tools: Authenticated request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/mcp\" \\\n  -H \"Authorization: Bearer $AGENTMASON_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 2,\n  \"method\": \"tools/list\",\n  \"params\": {}\n}'"},{"lang":"curl","label":"Get agent through MCP: Public marketplace request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/mcp\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3,\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"get_agent\",\n    \"arguments\": {\n      \"slug\": \"pr-summarizer\"\n    }\n  }\n}'"},{"lang":"curl","label":"Run agent through MCP: Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/mcp\" \\\n  -H \"Authorization: Bearer $AGENTMASON_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 4,\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"run_agent\",\n    \"arguments\": {\n      \"slug\": \"multi-agent-orchestrator\",\n      \"input\": {\n        \"task\": \"Say hello from curl.\"\n      }\n    }\n  }\n}'"},{"lang":"curl","label":"Get run through MCP: Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/mcp\" \\\n  -H \"Authorization: Bearer $AGENTMASON_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 5,\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"get_run\",\n    \"arguments\": {\n      \"agentSlug\": \"multi-agent-orchestrator\",\n      \"runId\": \"$AGENTMASON_RUN_ID\"\n    }\n  }\n}'"}]}},"/chat/{slug}":{"get":{"tags":["Chat"],"operationId":"getChatSlugOpenShareableChatPage9","summary":"Open shareable chat page","description":"Public agents open for anyone; private/workspace agents show a sign-in gate.\n\nAudience: Human Link. Stability: Public. Auth: Chat Access.","security":[{},{"sessionCookie":[]},{"bearerApiKey":[]}],"x-agentmason-auth":["Chat Access"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Public agents open for anyone; private/workspace agents show a sign-in gate.","content":{"text/html":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[]}},"/api/agents/{slug}/chat":{"post":{"tags":["Chat"],"operationId":"postApiAgentsSlugChatSendChatMessageStreamForTheWebUi10","summary":"Send chat message stream for the web UI","description":"Server-side SSE stream used by the AgentMason chat page and embed widget. External backend automations should use Runs or MCP instead.\n\nAudience: Workspace. Stability: MVP. Auth: Chat Access.","security":[{},{"sessionCookie":[]},{"bearerApiKey":[]}],"x-agentmason-auth":["Chat Access"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"session_id":"web_123","messages":[{"role":"user","content":"Plan a launch checklist"}]}},"examples":{"example":{"value":{"session_id":"web_123","messages":[{"role":"user","content":"Plan a launch checklist"}]}}}}}},"responses":{"200":{"description":"Server-side SSE stream used by the AgentMason chat page and embed widget. External backend automations should use Runs or MCP instead.","content":{"application/json":{"schema":{"type":"string","example":"text/event-stream"},"examples":{"example":{"value":"text/event-stream"}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/chat\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"session_id\": \"web_123\",\n  \"messages\": [\n    {\n      \"role\": \"user\",\n      \"content\": \"Plan a launch checklist\"\n    }\n  ]\n}'"}]},"get":{"tags":["Chat"],"operationId":"getApiAgentsSlugChatReadPersistedChatSession11","summary":"Read persisted chat session","description":"Reads the shared runtime's persisted session messages.\n\nAudience: Workspace. Stability: MVP. Auth: Chat Access.","security":[{},{"sessionCookie":[]},{"bearerApiKey":[]}],"x-agentmason-auth":["Chat Access"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reads the shared runtime's persisted session messages.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"session_id":"web_123","messages":[{"role":"user","content":"Hello"}]}},"examples":{"example":{"value":{"session_id":"web_123","messages":[{"role":"user","content":"Hello"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/chat?session_id=web_123\""}]},"delete":{"tags":["Chat"],"operationId":"deleteApiAgentsSlugChatClearPersistedChatSession12","summary":"Clear persisted chat session","description":"Deletes one runtime chat session file.\n\nAudience: Workspace. Stability: MVP. Auth: Chat Access.","security":[{},{"sessionCookie":[]},{"bearerApiKey":[]}],"x-agentmason-auth":["Chat Access"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"session_id","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deletes one runtime chat session file.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true}},"examples":{"example":{"value":{"ok":true}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X DELETE \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/chat?session_id=web_123\""}]}},"/api/agents":{"get":{"tags":["Agents"],"operationId":"getApiAgentsListAgents13","summary":"List agents","description":"Returns installed on-disk agents with shared runtime publish status.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"responses":{"200":{"description":"Returns installed on-disk agents with shared runtime publish status.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"agents":[{"slug":"multi-agent-orchestrator","name":"Multi-Agent Orchestrator","status":"Published"}]}},"examples":{"example":{"value":{"agents":[{"slug":"multi-agent-orchestrator","name":"Multi-Agent Orchestrator","status":"Published"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/agents\""}]},"post":{"tags":["Agents"],"operationId":"postApiAgentsCreateAgent14","summary":"Create agent","description":"Writes agents/{slug}/revision.json.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"slug":"research-agent","name":"Research Agent","visibility":"private","goalPrompt":"Research a topic and summarize findings.","modelStack":"ollama/llama3.2:3b","builtinTools":["fetch"],"drives":[],"outputType":"document","mcpAccess":"none"}},"examples":{"example":{"value":{"slug":"research-agent","name":"Research Agent","visibility":"private","goalPrompt":"Research a topic and summarize findings.","modelStack":"ollama/llama3.2:3b","builtinTools":["fetch"],"drives":[],"outputType":"document","mcpAccess":"none"}}}}}},"responses":{"200":{"description":"Writes agents/{slug}/revision.json.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true,"slug":"research-agent","revisionPath":"agents/research-agent/revision.json","publishHint":"POST /api/deployments/research-agent"}},"examples":{"example":{"value":{"ok":true,"slug":"research-agent","revisionPath":"agents/research-agent/revision.json","publishHint":"POST /api/deployments/research-agent"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/agents\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"slug\": \"research-agent\",\n  \"name\": \"Research Agent\",\n  \"visibility\": \"private\",\n  \"goalPrompt\": \"Research a topic and summarize findings.\",\n  \"modelStack\": \"ollama/llama3.2:3b\",\n  \"builtinTools\": [\n    \"fetch\"\n  ],\n  \"drives\": [],\n  \"outputType\": \"document\",\n  \"mcpAccess\": \"none\"\n}'"}]}},"/api/agents/{slug}":{"get":{"tags":["Agents"],"operationId":"getApiAgentsSlugGetAgent15","summary":"Get agent","description":"Reads one agent revision and shared runtime state.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reads one agent revision and shared runtime state.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"slug":"multi-agent-orchestrator","visibility":"org","status":"Published","revisions":[{"number":1}]}},"examples":{"example":{"value":{"slug":"multi-agent-orchestrator","visibility":"org","status":"Published","revisions":[{"number":1}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator\""}]},"put":{"tags":["Agents"],"operationId":"putApiAgentsSlugUpdateAgent16","summary":"Update agent","description":"Merges metadata/spec patch into revision.json.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"metadata":{"visibility":"public"},"spec":{"goalPrompt":"Updated prompt"}}},"examples":{"example":{"value":{"metadata":{"visibility":"public"},"spec":{"goalPrompt":"Updated prompt"}}}}}}},"responses":{"200":{"description":"Merges metadata/spec patch into revision.json.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true,"revision":{"metadata":{"visibility":"public"}}}},"examples":{"example":{"value":{"ok":true,"revision":{"metadata":{"visibility":"public"}}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X PUT \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"metadata\": {\n    \"visibility\": \"public\"\n  }\n}'"}]}},"/api/agents/{slug}/export":{"get":{"tags":["Agents"],"operationId":"getApiAgentsSlugExportExportAgent17","summary":"Export agent","description":"Lists export targets or downloads/returns an exported agent package.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Lists export targets or downloads/returns an exported agent package.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"targets":[{"id":"claude-code","label":"Claude Code"}]}},"examples":{"example":{"value":{"targets":[{"id":"claude-code","label":"Claude Code"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"List targets","source":"curl -s \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/export\""},{"lang":"curl","label":"Inline export","source":"curl -s \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/export?target=claude-code&inline=1\""}]}},"/api/agents/{slug}/mcp-tools":{"get":{"tags":["Agents"],"operationId":"getApiAgentsSlugMcpToolsListAllowedMcpToolsForAgent18","summary":"List allowed MCP tools for agent","description":"Resolves the agent's MCP allow/deny policy into visible tools.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Resolves the agent's MCP allow/deny policy into visible tools.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"servers":[],"tools":[]}},"examples":{"example":{"value":{"servers":[],"tools":[]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/mcp-tools\""}]}},"/api/agents/{slug}/runs":{"get":{"tags":["Runs"],"operationId":"getApiAgentsSlugRunsListRuns19","summary":"List runs","description":"Reads recent one-shot API/run executions for an agent owned by the API key.\n\nAudience: Stable Public. Stability: Public. Auth: API key: read.","security":[{"bearerApiKey":[]}],"x-agentmason-auth":["API key: read"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reads recent one-shot API/run executions for an agent owned by the API key.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"runs":[],"source":"shared-runtime"}},"examples":{"example":{"value":{"runs":[],"source":"shared-runtime"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/runs\" \\\n  -H \"Authorization: Bearer $AGENTMASON_API_KEY\""}]},"post":{"tags":["Runs"],"operationId":"postApiAgentsSlugRunsRunAgentAsAnApiCall20","summary":"Run agent as an API call","description":"Triggers a one-shot runtime run. Use this for backend automations; use /chat/{slug} or /embed/{slug}.js for human conversations.\n\nAudience: Stable Public. Stability: Public. Auth: API key: write/admin.","security":[{"bearerApiKey":[]}],"x-agentmason-auth":["API key: write/admin"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"input":{"task":"Create a launch checklist"}}},"examples":{"example":{"value":{"input":{"task":"Create a launch checklist"}}}}}}},"responses":{"200":{"description":"Triggers a one-shot runtime run. Use this for backend automations; use /chat/{slug} or /embed/{slug}.js for human conversations.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"id":"run_123","status":"done","result":"..."}},"examples":{"example":{"value":{"id":"run_123","status":"done","result":"..."}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/runs?wait=true\" \\\n  -H \"Authorization: Bearer $AGENTMASON_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"input\": {\n    \"task\": \"Create a launch checklist\"\n  }\n}'"}]}},"/api/agents/{slug}/metrics":{"get":{"tags":["Metrics and Evals"],"operationId":"getApiAgentsSlugMetricsGetMetrics21","summary":"Get metrics","description":"Aggregates runtime run data into dashboard metrics.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Aggregates runtime run data into dashboard metrics.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"source":"shared-runtime","totals":{"runs":10}}},"examples":{"example":{"value":{"source":"shared-runtime","totals":{"runs":10}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/metrics\""}]}},"/api/agents/{slug}/evals":{"get":{"tags":["Metrics and Evals"],"operationId":"getApiAgentsSlugEvalsListEvalCases22","summary":"List eval cases","description":"Reads YAML/JSON eval files from agents/{slug}/evals.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reads YAML/JSON eval files from agents/{slug}/evals.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"slug":"multi-agent-orchestrator","files":["smoke.yml"],"totalCases":1,"groups":[]}},"examples":{"example":{"value":{"slug":"multi-agent-orchestrator","files":["smoke.yml"],"totalCases":1,"groups":[]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/evals\""}]}},"/api/agents/{slug}/evals/run":{"post":{"tags":["Metrics and Evals"],"operationId":"postApiAgentsSlugEvalsRunRunEvalSuite23","summary":"Run eval suite","description":"Runs eval cases against the published shared-runtime agent.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Runs eval cases against the published shared-runtime agent.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true,"total":1,"passed":1}},"examples":{"example":{"value":{"ok":true,"total":1,"passed":1}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/evals/run\""}]}},"/api/agents/{slug}/evals/gate":{"post":{"tags":["Metrics and Evals"],"operationId":"postApiAgentsSlugEvalsGateRunAgentCiGate24","summary":"Run Agent CI gate","description":"Runs the agent eval suite as a release gate and returns publish blockers, warnings, and pass/fail stages.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"threshold":1}},"examples":{"example":{"value":{"threshold":1}}}}}},"responses":{"200":{"description":"Runs the agent eval suite as a release gate and returns publish blockers, warnings, and pass/fail stages.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true,"gate":{"decision":"pass","total":3,"passedCases":3,"failedCases":0,"stages":[{"name":"Publish decision","status":"pass"}]}}},"examples":{"example":{"value":{"ok":true,"gate":{"decision":"pass","total":3,"passedCases":3,"failedCases":0,"stages":[{"name":"Publish decision","status":"pass"}]}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Run gate","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/agents/multi-agent-orchestrator/evals/gate\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"threshold\": 1\n}'"}]}},"/api/deployments":{"get":{"tags":["Deployments"],"operationId":"getApiDeploymentsListPublishedAgents25","summary":"List published agents","description":"Lists agents that have a revision and are available on the shared runtime.\n\nAudience: Workspace. Stability: Operator. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"responses":{"200":{"description":"Lists agents that have a revision and are available on the shared runtime.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"agents":[{"slug":"multi-agent-orchestrator","url":"/chat/multi-agent-orchestrator","runtime":"shared"}]}},"examples":{"example":{"value":{"agents":[{"slug":"multi-agent-orchestrator","url":"/chat/multi-agent-orchestrator","runtime":"shared"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/deployments\""}]}},"/api/deployments/{slug}":{"get":{"tags":["Deployments"],"operationId":"getApiDeploymentsSlugGetPublishState26","summary":"Get publish state","description":"Returns whether one agent revision is available on the shared runtime.\n\nAudience: Workspace. Stability: Operator. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Returns whether one agent revision is available on the shared runtime.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"deployed":true,"runtime":"shared","slug":"multi-agent-orchestrator"}},"examples":{"example":{"value":{"deployed":true,"runtime":"shared","slug":"multi-agent-orchestrator"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/deployments/multi-agent-orchestrator\""}]},"post":{"tags":["Deployments"],"operationId":"postApiDeploymentsSlugPublishAgent27","summary":"Publish agent","description":"Marks the agent revision available through the shared runtime and returns its chat/run URLs.\n\nAudience: Workspace. Stability: Operator. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Marks the agent revision available through the shared runtime and returns its chat/run URLs.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true,"deployment":{"slug":"multi-agent-orchestrator","runtime":"shared"}}},"examples":{"example":{"value":{"ok":true,"deployment":{"slug":"multi-agent-orchestrator","runtime":"shared"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/deployments/multi-agent-orchestrator\""}]},"delete":{"tags":["Deployments"],"operationId":"deleteApiDeploymentsSlugUnpublishAgent28","summary":"Unpublish agent","description":"Acknowledges unpublish intent. Set visibility to private to revoke public access.\n\nAudience: Workspace. Stability: Operator. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Acknowledges unpublish intent. Set visibility to private to revoke public access.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true}},"examples":{"example":{"value":{"ok":true}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X DELETE \"$AGENTMASON_BASE_URL/api/deployments/multi-agent-orchestrator\""}]}},"/api/marketplace":{"get":{"tags":["Marketplace"],"operationId":"getApiMarketplaceListMarketplaceAgents29","summary":"List marketplace agents","description":"Returns installable marketplace listings with trust scores.\n\nAudience: Stable Public. Stability: MVP. Auth: No key.","security":[],"x-agentmason-auth":["No key"],"parameters":[],"responses":{"200":{"description":"Returns installable marketplace listings with trust scores.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"agents":[{"slug":"pr-summarizer","name":"PR Summarizer","trustScore":94}]}},"examples":{"example":{"value":{"agents":[{"slug":"pr-summarizer","name":"PR Summarizer","trustScore":94}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/marketplace\""}]}},"/api/marketplace/{slug}/install":{"post":{"tags":["Marketplace"],"operationId":"postApiMarketplaceSlugInstallInstallMarketplaceAgent30","summary":"Install marketplace agent","description":"Copies a marketplace listing into agents/{slug}/revision.json as a private installed agent.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Copies a marketplace listing into agents/{slug}/revision.json as a private installed agent.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true,"installedAs":"pr-summarizer","redirect":"/agents/pr-summarizer"}},"examples":{"example":{"value":{"ok":true,"installedAs":"pr-summarizer","redirect":"/agents/pr-summarizer"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/marketplace/pr-summarizer/install\""}]}},"/api/drives":{"get":{"tags":["Drives"],"operationId":"getApiDrivesListDrives31","summary":"List drives","description":"Lists file drives owned by the current user.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"responses":{"200":{"description":"Lists file drives owned by the current user.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"drives":[{"id":"drv_123","name":"Product Docs"}]}},"examples":{"example":{"value":{"drives":[{"id":"drv_123","name":"Product Docs"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/drives\""}]},"post":{"tags":["Drives"],"operationId":"postApiDrivesCreateDrive32","summary":"Create drive","description":"Creates a searchable file collection.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Product Docs","description":"Launch docs and FAQs"}},"examples":{"example":{"value":{"name":"Product Docs","description":"Launch docs and FAQs"}}}}}},"responses":{"200":{"description":"Creates a searchable file collection.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"drive":{"id":"drv_123","name":"Product Docs"}}},"examples":{"example":{"value":{"drive":{"id":"drv_123","name":"Product Docs"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/drives\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"name\": \"Product Docs\",\n  \"description\": \"Launch docs and FAQs\"\n}'"}]}},"/api/drives/{id}":{"get":{"tags":["Drives"],"operationId":"getApiDrivesIdGetDrive33","summary":"Get drive","description":"Reads drive metadata.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reads drive metadata.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"drive":{"id":"drv_123","name":"Product Docs"}}},"examples":{"example":{"value":{"drive":{"id":"drv_123","name":"Product Docs"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/drives/drv_123\""}]},"delete":{"tags":["Drives"],"operationId":"deleteApiDrivesIdDeleteDrive34","summary":"Delete drive","description":"Deletes drive metadata and files.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deletes drive metadata and files.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true}},"examples":{"example":{"value":{"ok":true}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X DELETE \"$AGENTMASON_BASE_URL/api/drives/drv_123\""}]}},"/api/drives/{id}/files":{"get":{"tags":["Drives"],"operationId":"getApiDrivesIdFilesListDriveFiles35","summary":"List drive files","description":"Lists files uploaded to a drive.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Lists files uploaded to a drive.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"files":[{"id":"file_123","name":"launch.md"}]}},"examples":{"example":{"value":{"files":[{"id":"file_123","name":"launch.md"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/drives/drv_123/files\""}]},"post":{"tags":["Drives"],"operationId":"postApiDrivesIdFilesUploadDriveFile36","summary":"Upload drive file","description":"Uploads one file with multipart form field file.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"type":"object","properties":{"file":{"type":"string","format":"binary"}},"required":["file"]}}}},"responses":{"200":{"description":"Uploads one file with multipart form field file.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"file":{"id":"file_123","name":"launch.md"}}},"examples":{"example":{"value":{"file":{"id":"file_123","name":"launch.md"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/drives/drv_123/files\" \\\n  -F \"file=@launch.md\""}]}},"/api/drives/{id}/search":{"get":{"tags":["Drives"],"operationId":"getApiDrivesIdSearchSearchDriveFiles37","summary":"Search drive files","description":"Keyword-searches uploaded file content with q and optional limit query params.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Keyword-searches uploaded file content with q and optional limit query params.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"results":[{"fileId":"file_123","snippet":"launch checklist"}]}},"examples":{"example":{"value":{"results":[{"fileId":"file_123","snippet":"launch checklist"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/drives/drv_123/search?q=launch&limit=10\""}]}},"/api/mcp-servers":{"get":{"tags":["MCP Servers"],"operationId":"getApiMcpServersListMcpServers38","summary":"List MCP servers","description":"Lists external MCP tool servers configured by the current user.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"responses":{"200":{"description":"Lists external MCP tool servers configured by the current user.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"servers":[{"id":"mcp_srv_123","name":"GitHub MCP","authType":"bearer"}]}},"examples":{"example":{"value":{"servers":[{"id":"mcp_srv_123","name":"GitHub MCP","authType":"bearer"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/mcp-servers\""}]},"post":{"tags":["MCP Servers"],"operationId":"postApiMcpServersAddMcpServer39","summary":"Add MCP server","description":"Probes initialize/tools-list, then saves server config and encrypted credentials.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"GitHub MCP","url":"https://example.com/mcp","authType":"bearer","credential":{"token":"ghp_..."}}},"examples":{"example":{"value":{"name":"GitHub MCP","url":"https://example.com/mcp","authType":"bearer","credential":{"token":"ghp_..."}}}}}}},"responses":{"200":{"description":"Probes initialize/tools-list, then saves server config and encrypted credentials.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"server":{"id":"mcp_srv_123","lastTestStatus":"ok"}}},"examples":{"example":{"value":{"server":{"id":"mcp_srv_123","lastTestStatus":"ok"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/mcp-servers\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"name\": \"GitHub MCP\",\n  \"url\": \"https://example.com/mcp\",\n  \"authType\": \"bearer\",\n  \"credential\": {\n    \"token\": \"ghp_...\"\n  }\n}'"}]}},"/api/mcp-servers/{id}":{"get":{"tags":["MCP Servers"],"operationId":"getApiMcpServersIdGetMcpServer40","summary":"Get MCP server","description":"Reads one MCP server config without returning decrypted credentials.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reads one MCP server config without returning decrypted credentials.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"server":{"id":"mcp_srv_123","name":"GitHub MCP"}}},"examples":{"example":{"value":{"server":{"id":"mcp_srv_123","name":"GitHub MCP"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/mcp-servers/mcp_srv_123\""}]},"delete":{"tags":["MCP Servers"],"operationId":"deleteApiMcpServersIdDeleteMcpServer41","summary":"Delete MCP server","description":"Deletes server config and related credentials.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deletes server config and related credentials.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true}},"examples":{"example":{"value":{"ok":true}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X DELETE \"$AGENTMASON_BASE_URL/api/mcp-servers/mcp_srv_123\""}]}},"/api/mcp-servers/{id}/test":{"post":{"tags":["MCP Servers"],"operationId":"postApiMcpServersIdTestTestMcpServer42","summary":"Test MCP server","description":"Re-runs tools/list with stored credentials and updates health metadata.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Re-runs tools/list with stored credentials and updates health metadata.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true,"tools":[{"name":"search"}]}},"examples":{"example":{"value":{"ok":true,"tools":[{"name":"search"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/mcp-servers/mcp_srv_123/test\""}]}},"/api/api-keys":{"get":{"tags":["API Keys"],"operationId":"getApiApiKeysListApiKeys43","summary":"List API keys","description":"Lists hashed/prefix-only API keys for the signed-in user.\n\nAudience: Workspace. Stability: MVP. Auth: Session.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session"],"parameters":[],"responses":{"200":{"description":"Lists hashed/prefix-only API keys for the signed-in user.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"keys":[{"id":"key_123","name":"CI","prefix":"am_live_abc","scopes":["read"]}]}},"examples":{"example":{"value":{"keys":[{"id":"key_123","name":"CI","prefix":"am_live_abc","scopes":["read"]}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/api-keys\""}]},"post":{"tags":["API Keys"],"operationId":"postApiApiKeysCreateApiKey44","summary":"Create API key","description":"Creates a one-time visible token. Production requires sign-in when AUTH_REQUIRED=true.\n\nAudience: Workspace. Stability: MVP. Auth: Session.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"CI","scopes":["read","write"]}},"examples":{"example":{"value":{"name":"CI","scopes":["read","write"]}}}}}},"responses":{"200":{"description":"Creates a one-time visible token. Production requires sign-in when AUTH_REQUIRED=true.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"key":{"id":"key_123","prefix":"am_live_abc","scopes":["read","write"]},"token":"am_live_secret_shown_once"}},"examples":{"example":{"value":{"key":{"id":"key_123","prefix":"am_live_abc","scopes":["read","write"]},"token":"am_live_secret_shown_once"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/api-keys\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"name\": \"CI\",\n  \"scopes\": [\n    \"read\",\n    \"write\"\n  ]\n}'"}]}},"/api/api-keys/{id}":{"delete":{"tags":["API Keys"],"operationId":"deleteApiApiKeysIdRevokeApiKey45","summary":"Revoke API key","description":"Revokes one API key for the signed-in user.\n\nAudience: Workspace. Stability: MVP. Auth: Session.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Revokes one API key for the signed-in user.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true}},"examples":{"example":{"value":{"ok":true}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X DELETE \"$AGENTMASON_BASE_URL/api/api-keys/key_123\""}]}},"/api/schedules":{"get":{"tags":["Schedules"],"operationId":"getApiSchedulesListSchedules46","summary":"List schedules","description":"Lists recurring agent runs.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"responses":{"200":{"description":"Lists recurring agent runs.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"schedules":[{"id":"sched_123","name":"Daily summary","status":"Active"}]}},"examples":{"example":{"value":{"schedules":[{"id":"sched_123","name":"Daily summary","status":"Active"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/schedules\""}]},"post":{"tags":["Schedules"],"operationId":"postApiSchedulesCreateSchedule47","summary":"Create schedule","description":"Creates an interval-based recurring run.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"name":"Daily summary","agentSlug":"multi-agent-orchestrator","preset":"daily","inputTemplate":{"task":"Summarize new docs"},"notifications":[]}},"examples":{"example":{"value":{"name":"Daily summary","agentSlug":"multi-agent-orchestrator","preset":"daily","inputTemplate":{"task":"Summarize new docs"},"notifications":[]}}}}}},"responses":{"200":{"description":"Creates an interval-based recurring run.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"schedule":{"id":"sched_123","status":"Active"}}},"examples":{"example":{"value":{"schedule":{"id":"sched_123","status":"Active"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/schedules\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"name\": \"Daily summary\",\n  \"agentSlug\": \"multi-agent-orchestrator\",\n  \"preset\": \"daily\",\n  \"inputTemplate\": {\n    \"task\": \"Summarize new docs\"\n  },\n  \"notifications\": []\n}'"}]}},"/api/schedules/{id}":{"get":{"tags":["Schedules"],"operationId":"getApiSchedulesIdGetSchedule48","summary":"Get schedule","description":"Reads one schedule.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Reads one schedule.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"schedule":{"id":"sched_123","status":"Active"}}},"examples":{"example":{"value":{"schedule":{"id":"sched_123","status":"Active"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/schedules/sched_123\""}]},"patch":{"tags":["Schedules"],"operationId":"patchApiSchedulesIdUpdateOrPauseSchedule49","summary":"Update or pause schedule","description":"Updates name/inputTemplate or toggles enabled status.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"enabled":false}},"examples":{"example":{"value":{"enabled":false}}}}}},"responses":{"200":{"description":"Updates name/inputTemplate or toggles enabled status.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"schedule":{"id":"sched_123","status":"Paused"}}},"examples":{"example":{"value":{"schedule":{"id":"sched_123","status":"Paused"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Pause","source":"curl -s -X PATCH \"$AGENTMASON_BASE_URL/api/schedules/sched_123\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"enabled\": false\n}'"}]},"delete":{"tags":["Schedules"],"operationId":"deleteApiSchedulesIdDeleteSchedule50","summary":"Delete schedule","description":"Deletes one schedule.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Deletes one schedule.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true}},"examples":{"example":{"value":{"ok":true}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X DELETE \"$AGENTMASON_BASE_URL/api/schedules/sched_123\""}]}},"/api/connectors/composio/catalog":{"get":{"tags":["Connectors"],"operationId":"getApiConnectorsComposioCatalogSearchConnectorCatalog51","summary":"Search connector catalog","description":"Searches the live Composio toolkit catalog used by the connector picker.\n\nAudience: Stable Public. Stability: MVP. Auth: No key.","security":[],"x-agentmason-auth":["No key"],"parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Searches the live Composio toolkit catalog used by the connector picker.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"configured":true,"source":"live","total":1000,"toolkits":[{"slug":"gmail","name":"Gmail","authSchemes":["OAUTH2"]}]}},"examples":{"example":{"value":{"configured":true,"source":"live","total":1000,"toolkits":[{"slug":"gmail","name":"Gmail","authSchemes":["OAUTH2"]}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/connectors/composio/catalog?q=gmail&limit=5\""}]}},"/api/connectors/composio/status":{"get":{"tags":["Connectors"],"operationId":"getApiConnectorsComposioStatusReadConnectorStatus52","summary":"Read connector status","description":"Returns signed-in user's connected Composio accounts and OAuth callback URL.\n\nAudience: Workspace. Stability: MVP. Auth: Session.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session"],"parameters":[],"responses":{"200":{"description":"Returns signed-in user's connected Composio accounts and OAuth callback URL.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"connectedAccounts":[{"toolkit":"gmail","status":"connected"}],"callbackUrl":"https://agentmason.app/api/connectors/composio/callback"}},"examples":{"example":{"value":{"connectedAccounts":[{"toolkit":"gmail","status":"connected"}],"callbackUrl":"https://agentmason.app/api/connectors/composio/callback"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/connectors/composio/status\""}]}},"/api/connectors/composio/start":{"post":{"tags":["Connectors"],"operationId":"postApiConnectorsComposioStartStartConnectorOauth53","summary":"Start connector OAuth","description":"Creates a provider-hosted OAuth session and returns the URL where the user approves access.\n\nAudience: Workspace. Stability: MVP. Auth: Session.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"toolkit":"gmail"}},"examples":{"example":{"value":{"toolkit":"gmail"}}}}}},"responses":{"200":{"description":"Creates a provider-hosted OAuth session and returns the URL where the user approves access.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"redirectUrl":"https://backend.composio.dev/api/v3/connected_accounts/..."}},"examples":{"example":{"value":{"redirectUrl":"https://backend.composio.dev/api/v3/connected_accounts/..."}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/connectors/composio/start\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"toolkit\": \"gmail\"\n}'"}]}},"/api/integrations":{"get":{"tags":["Integrations"],"operationId":"getApiIntegrationsReadIntegrationSettings54","summary":"Read integration settings","description":"Returns redacted provider settings for OpenAI, Anthropic, Bedrock, and Ollama.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"responses":{"200":{"description":"Returns redacted provider settings for OpenAI, Anthropic, Bedrock, and Ollama.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"integrations":{"ollama":{"host":"https://ollama.your-company.example.com","model":"llama3.2:3b"}}}},"examples":{"example":{"value":{"integrations":{"ollama":{"host":"https://ollama.your-company.example.com","model":"llama3.2:3b"}}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s \"$AGENTMASON_BASE_URL/api/integrations\""}]},"post":{"tags":["Integrations"],"operationId":"postApiIntegrationsSaveIntegrationSettings55","summary":"Save integration settings","description":"Merges provider settings into secrets/integrations.json.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ollama":{"host":"https://ollama.your-company.example.com","model":"llama3.2:3b"}}},"examples":{"example":{"value":{"ollama":{"host":"https://ollama.your-company.example.com","model":"llama3.2:3b"}}}}}}},"responses":{"200":{"description":"Merges provider settings into secrets/integrations.json.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true,"integrations":{"ollama":{"host":"https://ollama.your-company.example.com"}}}},"examples":{"example":{"value":{"ok":true,"integrations":{"ollama":{"host":"https://ollama.your-company.example.com"}}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/integrations\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"ollama\": {\n    \"host\": \"https://ollama.your-company.example.com\",\n    \"model\": \"llama3.2:3b\"\n  }\n}'"}]}},"/api/integrations/{provider}/test":{"post":{"tags":["Integrations"],"operationId":"postApiIntegrationsProviderTestTestIntegrationProvider56","summary":"Test integration provider","description":"Checks provider connectivity for anthropic, openai, ollama, or bedrock.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Checks provider connectivity for anthropic, openai, ollama, or bedrock.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true,"message":"Connected."}},"examples":{"example":{"value":{"ok":true,"message":"Connected."}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/integrations/ollama/test\""}]}},"/api/integrations/apply":{"post":{"tags":["Integrations"],"operationId":"postApiIntegrationsApplyRefreshRuntimeIntegrations57","summary":"Refresh runtime integrations","description":"Confirms saved shared-runtime agents will use the latest integration credentials on their next request.\n\nAudience: Workspace. Stability: Operator. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"responses":{"200":{"description":"Confirms saved shared-runtime agents will use the latest integration credentials on their next request.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true,"agents":[{"slug":"multi-agent-orchestrator","ok":true}]}},"examples":{"example":{"value":{"ok":true,"agents":[{"slug":"multi-agent-orchestrator","ok":true}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/integrations/apply\""}]}},"/api/resolve":{"post":{"tags":["Resolver"],"operationId":"postApiResolveResolveIntentToAgents58","summary":"Resolve intent to agents","description":"Searches installed and marketplace agents for a natural-language task.\n\nAudience: Workspace. Stability: MVP. Auth: Session or dev user.","security":[{"sessionCookie":[]}],"x-agentmason-auth":["Session or dev user"],"parameters":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"prompt":"summarize pull requests","limit":5}},"examples":{"example":{"value":{"prompt":"summarize pull requests","limit":5}}}}}},"responses":{"200":{"description":"Searches installed and marketplace agents for a natural-language task.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"matches":[{"slug":"pr-summarizer","source":"marketplace"}]}},"examples":{"example":{"value":{"matches":[{"slug":"pr-summarizer","source":"marketplace"}]}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Request","source":"curl -s -X POST \"$AGENTMASON_BASE_URL/api/resolve\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n  \"prompt\": \"summarize pull requests\",\n  \"limit\": 5\n}'"}]}},"/api/runtime/mcp-credentials":{"get":{"tags":["Runtime Internal"],"operationId":"getApiRuntimeMcpCredentialsFetchMcpCredentialsForRuntime59","summary":"Fetch MCP credentials for runtime","description":"Container-only endpoint. Requires x-runtime-token and serverId query param.\n\nAudience: Runtime Internal. Stability: Internal. Auth: Runtime token.","security":[{"runtimeToken":[]}],"x-agentmason-auth":["Runtime token"],"parameters":[],"responses":{"200":{"description":"Container-only endpoint. Requires x-runtime-token and serverId query param.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"serverId":"mcp_srv_123","url":"https://example.com/mcp","authType":"bearer","headers":{"Authorization":"Bearer ..."}}},"examples":{"example":{"value":{"serverId":"mcp_srv_123","url":"https://example.com/mcp","authType":"bearer","headers":{"Authorization":"Bearer ..."}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Container request","source":"curl -s \"$AGENTMASON_BASE_URL/api/runtime/mcp-credentials?serverId=mcp_srv_123\" \\\n  -H \"x-runtime-token: $AGENTMASON_RUNTIME_TOKEN\""}]}},"/api/auth/{...nextauth}":{"get":{"tags":["Auth"],"operationId":"getApiAuthNextauthAuthJsGetRoutes60","summary":"Auth.js GET routes","description":"Framework-managed session/provider/callback endpoints used by NextAuth/Auth.js.\n\nAudience: Auth Framework. Stability: Framework. Auth: Auth.js.","security":[],"x-agentmason-auth":["Auth.js"],"parameters":[{"name":"...nextauth","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Framework-managed session/provider/callback endpoints used by NextAuth/Auth.js.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[{"lang":"curl","label":"Session check","source":"curl -s \"$AGENTMASON_BASE_URL/api/auth/session\""}]},"post":{"tags":["Auth"],"operationId":"postApiAuthNextauthAuthJsPostRoutes61","summary":"Auth.js POST routes","description":"Framework-managed sign-in/callback endpoints. Do not call directly from external integrations.\n\nAudience: Auth Framework. Stability: Framework. Auth: Auth.js.","security":[],"x-agentmason-auth":["Auth.js"],"parameters":[{"name":"...nextauth","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Framework-managed sign-in/callback endpoints. Do not call directly from external integrations.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"example":{"ok":true}}}}},"400":{"description":"Invalid request"},"401":{"description":"Authentication required or invalid credentials"},"403":{"description":"Forbidden"},"404":{"description":"Not found"},"429":{"description":"Rate limited"},"500":{"description":"Server error"}},"x-codeSamples":[]}}},"components":{"securitySchemes":{"bearerApiKey":{"type":"http","scheme":"bearer","bearerFormat":"AgentMason API key","description":"Create keys from Settings > API Keys. Read keys inspect; write/admin keys can run agents through MCP."},"sessionCookie":{"type":"apiKey","in":"cookie","name":"authjs.session-token","description":"Browser session managed by Auth.js. Local dev may fall back to the configured dev user."},"runtimeToken":{"type":"apiKey","in":"header","name":"x-runtime-token","description":"Shared secret for optional trusted external runtimes."}},"schemas":{"JsonObject":{"type":"object","additionalProperties":true},"JsonRpcEnvelope":{"type":"object","required":["jsonrpc","id","method"],"properties":{"jsonrpc":{"type":"string","const":"2.0"},"id":{"oneOf":[{"type":"string"},{"type":"number"},{"type":"null"}]},"method":{"type":"string"},"params":{"type":"object","additionalProperties":true}}}}}}