{"openapi":"3.1.0","info":{"title":"Membase Hosted API","version":"0.3.0"},"paths":{"/v1/auth/wallet/challenge":{"post":{"summary":"Wallet Challenge","operationId":"wallet_challenge_v1_auth_wallet_challenge_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletChallengeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Wallet Challenge V1 Auth Wallet Challenge Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/wallet":{"post":{"summary":"Wallet Sign In","operationId":"wallet_sign_in_v1_auth_wallet_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletSignInRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Wallet Sign In V1 Auth Wallet Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/privy":{"post":{"summary":"Privy Sign In","operationId":"privy_sign_in_v1_auth_privy_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrivySignInRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Privy Sign In V1 Auth Privy Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/methods":{"get":{"summary":"Auth Methods","operationId":"auth_methods_v1_auth_methods_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Auth Methods V1 Auth Methods Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/dev":{"post":{"summary":"Dev Sign In","operationId":"dev_sign_in_v1_auth_dev_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DevSignInRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Dev Sign In V1 Auth Dev Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/privy/session":{"post":{"summary":"Privy Session","operationId":"privy_session_v1_auth_privy_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrivySignInRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/privy/link":{"post":{"summary":"Privy Link","description":"Backfill the signed-in account's wallet from a fresh Privy token.\n\nPrivy mints the embedded wallet *during* the first login, so the token that\nlogin exchanged names no wallet and the account was created without one — and\nsince the exchange happens once per sign-in, it stayed missing for the whole\nsession. The web calls this as soon as the SDK reports a wallet, and gets the\nupdated session back so the address chip fills in without a reload.\n\nA session mutation, so it takes CSRF like every other one, and the service\nrefuses a token whose subject is not this session's account.","operationId":"privy_link_v1_auth_privy_link_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrivySignInRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/wallet/link":{"post":{"summary":"Wallet Link","description":"Backfill the signed-in account's wallet from a signed challenge.\n\nThe Privy backfill above needs an identity token, which a Privy app can simply\nnever issue (a dashboard setting) — but the embedded wallet can still sign, and\na signature over this server's own challenge is the proof a wallet sign-in\nalready accepts. Fill-empty only: an account that has a wallet keeps it.\n\nA session mutation, so it takes CSRF like every other one.","operationId":"wallet_link_v1_auth_wallet_link_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletSignInRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/wallet/session":{"post":{"summary":"Wallet Session","operationId":"wallet_session_v1_auth_wallet_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletSignInRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/dev/session":{"post":{"summary":"Dev Session","operationId":"dev_session_v1_auth_dev_session_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DevSignInRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/session":{"get":{"summary":"Get Session","operationId":"get_session_v1_session_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionView"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/session/logout":{"post":{"summary":"Logout","operationId":"logout_v1_session_logout_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Logout V1 Session Logout Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/desktop/authorize":{"post":{"summary":"Desktop Authorize","description":"Approval leg: an already signed-in browser session (cookie + CSRF, like every\nother consumer mutation) binds a one-time code to its account/account. The SPA\nperforms the returned redirect itself, exactly like /v1/oauth/consent. The code\nmust never enter server logs (ENGINEERING.md §9.2) — it appears only in this\nresponse body and the loopback redirect.","operationId":"desktop_authorize_v1_auth_desktop_authorize_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopAuthorizeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Desktop Authorize V1 Auth Desktop Authorize Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/auth/desktop/exchange":{"post":{"summary":"Desktop Exchange","description":"Redemption leg, called by the desktop app itself — unauthenticated like the\nother /v1/auth/ sign-in endpoints (all of which the rate-limit middleware skips).\nOne generic failure message on purpose: the caller learns nothing about *why* a\ncode was refused. The session is a fresh one, not a hand-off of the browser's —\nsigning out of the browser must not sign out the desktop app.","operationId":"desktop_exchange_v1_auth_desktop_exchange_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopExchangeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesktopSessionView"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/account":{"get":{"summary":"Account Status","operationId":"account_status_v1_account_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Account Status V1 Account Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Account Delete","operationId":"account_delete_v1_account_delete","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountDeleteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Account Delete V1 Account Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"patch":{"summary":"Account Update","operationId":"account_update_v1_account_patch","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AccountProfileRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Account Update V1 Account Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/account/export":{"get":{"summary":"Account Export","description":"Hand the owner their data. A GET because it is a read and because a download\nis what \"export\" means: the archive is built in memory and streamed back, not\nwritten into a server-side directory the owner can never reach (which is what\nthe old POST did, behind a button that fetched a `/v1/export` that never\nexisted). `X-Membase-Export-Memory` lets the UI say immediately whether the\nagent's memory made it in, without opening the archive.","operationId":"account_export_v1_account_export_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/account/invitation":{"get":{"summary":"Account Invitation","description":"The signed-in account's invite code, share link and the accounts it brought in.","operationId":"account_invitation_v1_account_invitation_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Account Invitation V1 Account Invitation Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/capabilities":{"get":{"summary":"Capabilities","operationId":"capabilities_v1_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilitiesView"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/uploads":{"post":{"summary":"Upload","operationId":"upload_v1_uploads_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_v1_uploads_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadRef"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/sources":{"get":{"summary":"List Sources","operationId":"list_sources_v1_sources_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Sources V1 Sources Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Create Source","operationId":"create_source_v1_sources_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Source V1 Sources Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/bridge/changeset":{"post":{"summary":"Bridge Changeset","operationId":"bridge_changeset_v1_bridge_changeset_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BridgeChangeset"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Bridge Changeset V1 Bridge Changeset Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/bridge/devices":{"post":{"summary":"Register Bridge Device","operationId":"register_bridge_device_v1_bridge_devices_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BridgeDeviceCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Register Bridge Device V1 Bridge Devices Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/bridge/devices/{token_id}":{"delete":{"summary":"Revoke Bridge Device","operationId":"revoke_bridge_device_v1_bridge_devices__token_id__delete","parameters":[{"name":"token_id","in":"path","required":true,"schema":{"type":"string","title":"Token Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Bridge Device V1 Bridge Devices  Token Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-memory":{"get":{"summary":"Agent Memory Overview","operationId":"agent_memory_overview_v1_agent_memory_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent Memory Overview V1 Agent Memory Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-memory/file":{"get":{"summary":"Agent Memory File","operationId":"agent_memory_file_v1_agent_memory_file_get","parameters":[{"name":"name","in":"query","required":true,"schema":{"type":"string","title":"Name"}},{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent Memory File V1 Agent Memory File Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"put":{"summary":"Agent Memory Write File","operationId":"agent_memory_write_file_v1_agent_memory_file_put","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent Memory Write File V1 Agent Memory File Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-memory/facts":{"get":{"summary":"Agent Memory Facts","operationId":"agent_memory_facts_v1_agent_memory_facts_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Fresh"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent Memory Facts V1 Agent Memory Facts Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-tooling":{"get":{"summary":"Agent Tooling","operationId":"agent_tooling_v1_agent_tooling_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent Tooling V1 Agent Tooling Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-session":{"get":{"summary":"Agent Session","operationId":"agent_session_v1_agent_session_get","parameters":[{"name":"agent_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Agent Id"}},{"name":"venue","in":"query","required":false,"schema":{"type":"string","default":"web","title":"Venue"}},{"name":"thread","in":"query","required":false,"schema":{"type":"string","default":"","title":"Thread"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent Session V1 Agent Session Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/operations/{operation_id}":{"get":{"summary":"Get Operation","operationId":"get_operation_v1_operations__operation_id__get","parameters":[{"name":"operation_id","in":"path","required":true,"schema":{"type":"string","title":"Operation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Operation V1 Operations  Operation Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/connections":{"get":{"summary":"List Connections","operationId":"list_connections_v1_connections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Connections V1 Connections Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Connect Source","operationId":"connect_source_v1_connections_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Connect Source V1 Connections Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/connections/{connection_id}/sync":{"post":{"summary":"Sync Connection","operationId":"sync_connection_v1_connections__connection_id__sync_post","parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Sync Connection V1 Connections  Connection Id  Sync Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/connections/{connection_id}/disconnect":{"post":{"summary":"Disconnect Connection","operationId":"disconnect_connection_v1_connections__connection_id__disconnect_post","parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DisconnectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Disconnect Connection V1 Connections  Connection Id  Disconnect Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/assistant":{"get":{"summary":"Get Default Assistant","description":"The account's personal assistant (an agent definition); scaffolds one on first\naccess so the Assistant tab is never empty.","operationId":"get_default_assistant_v1_assistant_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Get Default Assistant V1 Assistant Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Set Default Assistant","description":"Promote an existing agent definition to be the account's personal assistant.","operationId":"set_default_assistant_v1_assistant_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Set Default Assistant V1 Assistant Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/conversations":{"get":{"summary":"List Conversations","operationId":"list_conversations_v1_conversations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Conversations V1 Conversations Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Create Conversation","operationId":"create_conversation_v1_conversations_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationCreateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Conversation V1 Conversations Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/conversations/{conversation_id}":{"get":{"summary":"Get Conversation","operationId":"get_conversation_v1_conversations__conversation_id__get","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Conversation V1 Conversations  Conversation Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"patch":{"summary":"Rename Conversation","description":"Retitle a thread. The title is otherwise its first question, cut to a line.","operationId":"rename_conversation_v1_conversations__conversation_id__patch","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationRenameRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Rename Conversation V1 Conversations  Conversation Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Delete Conversation","description":"Forget: delete the transcript here and in the agent. The one irreversible verb —\n`?confirm=forget` is required.","operationId":"delete_conversation_v1_conversations__conversation_id__delete","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}},{"name":"confirm","in":"query","required":false,"schema":{"type":"string","default":"","title":"Confirm"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Conversation V1 Conversations  Conversation Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/conversations/{conversation_id}/messages":{"post":{"summary":"Append Conversation Message","operationId":"append_conversation_message_v1_conversations__conversation_id__messages_post","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationMessageRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Append Conversation Message V1 Conversations  Conversation Id  Messages Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/conversations/{conversation_id}/end":{"post":{"summary":"End Conversation","description":"End a conversation: it takes no more turns, stays readable here and searchable by\nthe agent. The assistant gets a flush turn first when the conversation earned one.","operationId":"end_conversation_v1_conversations__conversation_id__end_post","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response End Conversation V1 Conversations  Conversation Id  End Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/conversations/{conversation_id}/fork":{"post":{"summary":"Fork Conversation","description":"Branch this thread. The agent's session is forked (the source session ends — a\nbranch is a hand-off, the CLI's own semantics) and the new thread carries the\ntranscript forward; both rows record the lineage.","operationId":"fork_conversation_v1_conversations__conversation_id__fork_post","parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Fork Conversation V1 Conversations  Conversation Id  Fork Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-skills":{"get":{"summary":"List Agent Skills","operationId":"list_agent_skills_v1_agent_skills_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Agent Skills V1 Agent Skills Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Upsert Agent Skills","operationId":"upsert_agent_skills_v1_agent_skills_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response Upsert Agent Skills V1 Agent Skills Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-skills/import":{"post":{"summary":"Import Agent Skill","operationId":"import_agent_skill_v1_agent_skills_import_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Import Agent Skill V1 Agent Skills Import Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-skills/{skill_id}":{"delete":{"summary":"Delete Agent Skill","operationId":"delete_agent_skill_v1_agent_skills__skill_id__delete","parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Agent Skill V1 Agent Skills  Skill Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-skills/{skill_id}/publish":{"post":{"summary":"Publish Agent Skill","operationId":"publish_agent_skill_v1_agent_skills__skill_id__publish_post","parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Publish Agent Skill V1 Agent Skills  Skill Id  Publish Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-skills/upload":{"post":{"summary":"Upload Agent Skill Package","operationId":"upload_agent_skill_package_v1_agent_skills_upload_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_upload_agent_skill_package_v1_agent_skills_upload_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Upload Agent Skill Package V1 Agent Skills Upload Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/pets/capability":{"get":{"summary":"Pet Capability","description":"What this deployment can do, asked before the upload form is shown.","operationId":"pet_capability_v1_pets_capability_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Pet Capability V1 Pets Capability Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/pets":{"get":{"summary":"List Pets","operationId":"list_pets_v1_pets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Pets V1 Pets Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Create Pet","operationId":"create_pet_v1_pets_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_create_pet_v1_pets_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Pet V1 Pets Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/pets/{pet_id}":{"delete":{"summary":"Delete Pet","operationId":"delete_pet_v1_pets__pet_id__delete","parameters":[{"name":"pet_id","in":"path","required":true,"schema":{"type":"string","title":"Pet Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Pet V1 Pets  Pet Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/pets/{pet_id}/download":{"get":{"summary":"Download Pet","operationId":"download_pet_v1_pets__pet_id__download_get","parameters":[{"name":"pet_id","in":"path","required":true,"schema":{"type":"string","title":"Pet Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-skills/{skill_id}/download":{"get":{"summary":"Download Agent Skill Package","operationId":"download_agent_skill_package_v1_agent_skills__skill_id__download_get","parameters":[{"name":"skill_id","in":"path","required":true,"schema":{"type":"string","title":"Skill Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skill-market":{"get":{"summary":"List Skill Market","operationId":"list_skill_market_v1_skill_market_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Skill Market V1 Skill Market Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skill-market/{pub_id}/install":{"post":{"summary":"Install Skill From Market","operationId":"install_skill_from_market_v1_skill_market__pub_id__install_post","parameters":[{"name":"pub_id","in":"path","required":true,"schema":{"type":"string","title":"Pub Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Install Skill From Market V1 Skill Market  Pub Id  Install Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skill-market/{pub_id}/star":{"post":{"summary":"Star Skill","operationId":"star_skill_v1_skill_market__pub_id__star_post","parameters":[{"name":"pub_id","in":"path","required":true,"schema":{"type":"string","title":"Pub Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Star Skill V1 Skill Market  Pub Id  Star Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Unstar Skill","operationId":"unstar_skill_v1_skill_market__pub_id__star_delete","parameters":[{"name":"pub_id","in":"path","required":true,"schema":{"type":"string","title":"Pub Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Unstar Skill V1 Skill Market  Pub Id  Star Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/skill-market/{pub_id}":{"delete":{"summary":"Unpublish Agent Skill","operationId":"unpublish_agent_skill_v1_skill_market__pub_id__delete","parameters":[{"name":"pub_id","in":"path","required":true,"schema":{"type":"string","title":"Pub Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Unpublish Agent Skill V1 Skill Market  Pub Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-definitions":{"get":{"summary":"List Agent Definitions","operationId":"list_agent_definitions_v1_agent_definitions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Agent Definitions V1 Agent Definitions Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Create Agent Definition","operationId":"create_agent_definition_v1_agent_definitions_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Agent Definition V1 Agent Definitions Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-memory-providers":{"get":{"summary":"List Agent Memory Providers","description":"The memory providers an agent can use inside its container (inherited from Hermes),\neach with whether it stays local and what it can still be sold as.","operationId":"list_agent_memory_providers_v1_agent_memory_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Agent Memory Providers V1 Agent Memory Providers Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-definitions/{def_id}/memory-credential":{"put":{"summary":"Set Agent Memory Credential","description":"Store the API key this agent's memory provider needs. Write-only by design: the\nruntime is the only consumer, and a credential a UI can display is one that ends up in\na screenshot.","operationId":"set_agent_memory_credential_v1_agent_definitions__def_id__memory_credential_put","parameters":[{"name":"def_id","in":"path","required":true,"schema":{"type":"string","title":"Def Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Agent Memory Credential V1 Agent Definitions  Def Id  Memory Credential Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-definitions/{def_id}":{"get":{"summary":"Get Agent Definition","operationId":"get_agent_definition_v1_agent_definitions__def_id__get","parameters":[{"name":"def_id","in":"path","required":true,"schema":{"type":"string","title":"Def Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Agent Definition V1 Agent Definitions  Def Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"patch":{"summary":"Update Agent Definition","operationId":"update_agent_definition_v1_agent_definitions__def_id__patch","parameters":[{"name":"def_id","in":"path","required":true,"schema":{"type":"string","title":"Def Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Agent Definition V1 Agent Definitions  Def Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Delete Agent Definition","operationId":"delete_agent_definition_v1_agent_definitions__def_id__delete","parameters":[{"name":"def_id","in":"path","required":true,"schema":{"type":"string","title":"Def Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Agent Definition V1 Agent Definitions  Def Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-definitions/{def_id}/status":{"post":{"summary":"Set Agent Definition Status","operationId":"set_agent_definition_status_v1_agent_definitions__def_id__status_post","parameters":[{"name":"def_id","in":"path","required":true,"schema":{"type":"string","title":"Def Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Agent Definition Status V1 Agent Definitions  Def Id  Status Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-definitions/{def_id}/run":{"post":{"summary":"Run Agent Definition","description":"`wait: false` detaches the turn: the response is the running record and the caller\npolls GET /v1/agent-runs/{run_id} to a terminal state — a turn outlives what proxies\nin front of the API allow a single request to take.\n\n`conversation_id` names the web conversation this turn continues, so the agent resumes\nthat session and no other. Without one the turn is said in the `web` venue's own\nsession — this route IS the web surface. Telegram, schedules\nand MCP clients each speak in their own venue and never through here.","operationId":"run_agent_definition_v1_agent_definitions__def_id__run_post","parameters":[{"name":"def_id","in":"path","required":true,"schema":{"type":"string","title":"Def Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Run Agent Definition V1 Agent Definitions  Def Id  Run Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-definitions/{def_id}/mcp-servers":{"get":{"summary":"List Agent Mcp Servers","description":"The marketplace purchases attached to this agent as MCP tools.","operationId":"list_agent_mcp_servers_v1_agent_definitions__def_id__mcp_servers_get","parameters":[{"name":"def_id","in":"path","required":true,"schema":{"type":"string","title":"Def Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Agent Mcp Servers V1 Agent Definitions  Def Id  Mcp Servers Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Attach Purchase To Agent","description":"Attach a purchase this account holds to this agent, so it can call it as a tool.","operationId":"attach_purchase_to_agent_v1_agent_definitions__def_id__mcp_servers_post","parameters":[{"name":"def_id","in":"path","required":true,"schema":{"type":"string","title":"Def Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Attach Purchase To Agent V1 Agent Definitions  Def Id  Mcp Servers Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-definitions/{def_id}/mcp-servers/{listing_id}":{"delete":{"summary":"Detach Purchase From Agent","operationId":"detach_purchase_from_agent_v1_agent_definitions__def_id__mcp_servers__listing_id__delete","parameters":[{"name":"def_id","in":"path","required":true,"schema":{"type":"string","title":"Def Id"}},{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Detach Purchase From Agent V1 Agent Definitions  Def Id  Mcp Servers  Listing Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-definitions/{def_id}/runs":{"get":{"summary":"List Agent Definition Runs","operationId":"list_agent_definition_runs_v1_agent_definitions__def_id__runs_get","parameters":[{"name":"def_id","in":"path","required":true,"schema":{"type":"string","title":"Def Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Agent Definition Runs V1 Agent Definitions  Def Id  Runs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-runs/{run_id}":{"get":{"summary":"Get Agent Run","operationId":"get_agent_run_v1_agent_runs__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Agent Run V1 Agent Runs  Run Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-runs/{run_id}/cancel":{"post":{"summary":"Cancel Agent Run","operationId":"cancel_agent_run_v1_agent_runs__run_id__cancel_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Cancel Agent Run V1 Agent Runs  Run Id  Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-runs/{run_id}/retry":{"post":{"summary":"Retry Agent Run","operationId":"retry_agent_run_v1_agent_runs__run_id__retry_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Retry Agent Run V1 Agent Runs  Run Id  Retry Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-runs/{run_id}/approval":{"post":{"summary":"Answer Agent Run","description":"Answer the permission prompt this run is waiting on. `allow: true` grants it ONCE;\nanything else denies. There is no standing grant on this surface — the agent's own\n`session`/`always` choices are never offered, by invariant.","operationId":"answer_agent_run_v1_agent_runs__run_id__approval_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Answer Agent Run V1 Agent Runs  Run Id  Approval Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-jobs/{job_id}/{action}":{"post":{"summary":"Agent Job Action","description":"One management verb on a job the agent holds in its own box: pause / resume / run /\ndelete. The oversight half of agent-held scheduling: creation stays in the box, but\nthe owner can always see (GET /v1/agent-tooling) and stop what runs in their name.","operationId":"agent_job_action_v1_agent_jobs__job_id___action__post","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}},{"name":"action","in":"path","required":true,"schema":{"type":"string","title":"Action"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent Job Action V1 Agent Jobs  Job Id   Action  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-market":{"get":{"summary":"Memory Market","operationId":"memory_market_v1_memory_market_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response Memory Market V1 Memory Market Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/transactions":{"get":{"summary":"List Transactions","operationId":"list_transactions_v1_transactions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Transactions V1 Transactions Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-listings":{"get":{"summary":"List Memory Listings","operationId":"list_memory_listings_v1_memory_listings_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Memory Listings V1 Memory Listings Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Create Memory Listing","operationId":"create_memory_listing_v1_memory_listings_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Memory Listing V1 Memory Listings Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-market/{listing_id}":{"get":{"summary":"Get Memory Listing","operationId":"get_memory_listing_v1_memory_market__listing_id__get","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Memory Listing V1 Memory Market  Listing Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-listings/{listing_id}":{"patch":{"summary":"Update Memory Listing","operationId":"update_memory_listing_v1_memory_listings__listing_id__patch","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Memory Listing V1 Memory Listings  Listing Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Delete Memory Listing","operationId":"delete_memory_listing_v1_memory_listings__listing_id__delete","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Memory Listing V1 Memory Listings  Listing Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-market/{listing_id}/star":{"post":{"summary":"Star Memory Listing","operationId":"star_memory_listing_v1_memory_market__listing_id__star_post","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Star Memory Listing V1 Memory Market  Listing Id  Star Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Unstar Memory Listing","operationId":"unstar_memory_listing_v1_memory_market__listing_id__star_delete","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Unstar Memory Listing V1 Memory Market  Listing Id  Star Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-market/{listing_id}/subscribe":{"post":{"summary":"Subscribe Memory Listing","operationId":"subscribe_memory_listing_v1_memory_market__listing_id__subscribe_post","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}},{"name":"X-PAYMENT","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Payment"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Subscribe Memory Listing V1 Memory Market  Listing Id  Subscribe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-market/{listing_id}/items":{"get":{"summary":"Memory Listing Snapshot Items","description":"The frozen contents of a snapshot listing — seller, or buyer with an active\ngrant. This endpoint is the snapshot's fulfillment (deletion wins).","operationId":"memory_listing_snapshot_items_v1_memory_market__listing_id__items_get","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Memory Listing Snapshot Items V1 Memory Market  Listing Id  Items Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-market/{listing_id}/reissue":{"post":{"summary":"Reissue Memory Listing Credential","description":"Re-issue the MCP credential for an already-purchased listing (no charge;\nentitlement-gated by an active grant). Used by buyer-side OAuth and the\nLibrary 'reconnect' button.","operationId":"reissue_memory_listing_credential_v1_memory_market__listing_id__reissue_post","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Reissue Memory Listing Credential V1 Memory Market  Listing Id  Reissue Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-market/{listing_id}/x402/prepare":{"post":{"summary":"Prepare Memory Listing Payment","operationId":"prepare_memory_listing_payment_v1_memory_market__listing_id__x402_prepare_post","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Prepare Memory Listing Payment V1 Memory Market  Listing Id  X402 Prepare Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-listing-subscriptions":{"get":{"summary":"List Memory Listing Subscriptions","operationId":"list_memory_listing_subscriptions_v1_memory_listing_subscriptions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Response List Memory Listing Subscriptions V1 Memory Listing Subscriptions Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-listing-subscriptions/{listing_id}":{"delete":{"summary":"Unsubscribe Memory Listing","description":"Leave a listing this account bought: its credential dies at once.","operationId":"unsubscribe_memory_listing_v1_memory_listing_subscriptions__listing_id__delete","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Unsubscribe Memory Listing V1 Memory Listing Subscriptions  Listing Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-listings/{listing_id}/grants":{"get":{"summary":"List Memory Listing Grants","operationId":"list_memory_listing_grants_v1_memory_listings__listing_id__grants_get","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Memory Listing Grants V1 Memory Listings  Listing Id  Grants Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-listings/{listing_id}/grants/{grant_id}":{"delete":{"summary":"Revoke Memory Listing Grant","operationId":"revoke_memory_listing_grant_v1_memory_listings__listing_id__grants__grant_id__delete","parameters":[{"name":"listing_id","in":"path","required":true,"schema":{"type":"string","title":"Listing Id"}},{"name":"grant_id","in":"path","required":true,"schema":{"type":"string","title":"Grant Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Memory Listing Grant V1 Memory Listings  Listing Id  Grants  Grant Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/ai-providers":{"get":{"summary":"Ai Providers","operationId":"ai_providers_v1_ai_providers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ai Providers V1 Ai Providers Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/model-choices":{"get":{"summary":"Model Choices","operationId":"model_choices_v1_model_choices_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Model Choices V1 Model Choices Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/ai-providers/{provider}/credentials":{"post":{"summary":"Set Ai Provider Credentials","operationId":"set_ai_provider_credentials_v1_ai_providers__provider__credentials_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetAiProviderCredentialsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Ai Provider Credentials V1 Ai Providers  Provider  Credentials Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Delete Ai Provider Credentials","operationId":"delete_ai_provider_credentials_v1_ai_providers__provider__credentials_delete","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Ai Provider Credentials V1 Ai Providers  Provider  Credentials Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/ai-providers/{provider}/verify":{"post":{"summary":"Verify Ai Provider","operationId":"verify_ai_provider_v1_ai_providers__provider__verify_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Verify Ai Provider V1 Ai Providers  Provider  Verify Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/ai-providers/{provider}/activate":{"post":{"summary":"Activate Ai Provider","operationId":"activate_ai_provider_v1_ai_providers__provider__activate_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Activate Ai Provider V1 Ai Providers  Provider  Activate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/ai-providers/{provider}/model":{"post":{"summary":"Set Ai Provider Model","operationId":"set_ai_provider_model_v1_ai_providers__provider__model_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetAiProviderModelRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Ai Provider Model V1 Ai Providers  Provider  Model Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/ai-providers/{provider}/models":{"get":{"summary":"List Stored Ai Provider Models","operationId":"list_stored_ai_provider_models_v1_ai_providers__provider__models_get","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Stored Ai Provider Models V1 Ai Providers  Provider  Models Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"List Ai Provider Models","operationId":"list_ai_provider_models_v1_ai_providers__provider__models_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetAiProviderCredentialsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Ai Provider Models V1 Ai Providers  Provider  Models Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/ai-providers/{provider}/test":{"post":{"summary":"Test Ai Provider","operationId":"test_ai_provider_v1_ai_providers__provider__test_post","parameters":[{"name":"provider","in":"path","required":true,"schema":{"type":"string","title":"Provider"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TestAiProviderRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Test Ai Provider V1 Ai Providers  Provider  Test Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/intelligence/status":{"get":{"summary":"Intelligence Status","operationId":"intelligence_status_v1_intelligence_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Intelligence Status V1 Intelligence Status Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/anthropic-oauth/status":{"get":{"summary":"Anthropic Oauth Status","operationId":"anthropic_oauth_status_v1_anthropic_oauth_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Anthropic Oauth Status V1 Anthropic Oauth Status Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/anthropic-oauth/start":{"post":{"summary":"Anthropic Oauth Start","operationId":"anthropic_oauth_start_v1_anthropic_oauth_start_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Anthropic Oauth Start V1 Anthropic Oauth Start Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/anthropic-oauth/complete":{"post":{"summary":"Anthropic Oauth Complete","operationId":"anthropic_oauth_complete_v1_anthropic_oauth_complete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthCompleteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Anthropic Oauth Complete V1 Anthropic Oauth Complete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/anthropic-oauth/models":{"get":{"summary":"Anthropic Oauth Models","operationId":"anthropic_oauth_models_v1_anthropic_oauth_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Anthropic Oauth Models V1 Anthropic Oauth Models Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/anthropic-oauth":{"delete":{"summary":"Anthropic Oauth Disconnect","operationId":"anthropic_oauth_disconnect_v1_anthropic_oauth_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Anthropic Oauth Disconnect V1 Anthropic Oauth Delete"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/anthropic-oauth/test":{"post":{"summary":"Anthropic Oauth Test","operationId":"anthropic_oauth_test_v1_anthropic_oauth_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthTestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Anthropic Oauth Test V1 Anthropic Oauth Test Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/anthropic-oauth/model":{"post":{"summary":"Anthropic Oauth Set Model","operationId":"anthropic_oauth_set_model_v1_anthropic_oauth_model_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthActivateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Anthropic Oauth Set Model V1 Anthropic Oauth Model Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/anthropic-oauth/activate":{"post":{"summary":"Anthropic Oauth Activate","operationId":"anthropic_oauth_activate_v1_anthropic_oauth_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthActivateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Anthropic Oauth Activate V1 Anthropic Oauth Activate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/notion-oauth/status":{"get":{"summary":"Notion Oauth Status","operationId":"notion_oauth_status_v1_notion_oauth_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Notion Oauth Status V1 Notion Oauth Status Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/notion-oauth/start":{"post":{"summary":"Notion Oauth Start","operationId":"notion_oauth_start_v1_notion_oauth_start_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotionStartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Notion Oauth Start V1 Notion Oauth Start Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/notion-oauth/complete":{"post":{"summary":"Notion Oauth Complete","operationId":"notion_oauth_complete_v1_notion_oauth_complete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotionOAuthCompleteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Notion Oauth Complete V1 Notion Oauth Complete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/notion-oauth":{"delete":{"summary":"Notion Oauth Disconnect","operationId":"notion_oauth_disconnect_v1_notion_oauth_delete","parameters":[{"name":"authorization_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Notion Oauth Disconnect V1 Notion Oauth Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/notion-oauth/cancel":{"post":{"summary":"Notion Oauth Cancel","operationId":"notion_oauth_cancel_v1_notion_oauth_cancel_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotionCancelRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Notion Oauth Cancel V1 Notion Oauth Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/notion/token":{"post":{"summary":"Notion Token","operationId":"notion_token_v1_notion_token_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotionTokenRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Notion Token V1 Notion Token Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/notion/items":{"get":{"summary":"Notion Items","operationId":"notion_items_v1_notion_items_get","parameters":[{"name":"authorization_id","in":"query","required":true,"schema":{"type":"string","title":"Authorization Id"}},{"name":"value","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Value"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Notion Items V1 Notion Items Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/notion/selections/{connection_id}":{"patch":{"summary":"Notion Update Selection","operationId":"notion_update_selection_v1_notion_selections__connection_id__patch","parameters":[{"name":"connection_id","in":"path","required":true,"schema":{"type":"string","title":"Connection Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotionSelectionPatchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Notion Update Selection V1 Notion Selections  Connection Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/notion/selections":{"post":{"summary":"Notion Add","operationId":"notion_add_v1_notion_selections_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NotionSelectionRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Notion Add V1 Notion Selections Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openai-oauth/status":{"get":{"summary":"Openai Oauth Status","operationId":"openai_oauth_status_v1_openai_oauth_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Oauth Status V1 Openai Oauth Status Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openai-oauth/start":{"post":{"summary":"Openai Oauth Start","operationId":"openai_oauth_start_v1_openai_oauth_start_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Oauth Start V1 Openai Oauth Start Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openai-oauth/device/start":{"post":{"summary":"Openai Oauth Device Start","operationId":"openai_oauth_device_start_v1_openai_oauth_device_start_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Oauth Device Start V1 Openai Oauth Device Start Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openai-oauth/device/poll":{"post":{"summary":"Openai Oauth Device Poll","operationId":"openai_oauth_device_poll_v1_openai_oauth_device_poll_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Oauth Device Poll V1 Openai Oauth Device Poll Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openai-oauth/complete":{"post":{"summary":"Openai Oauth Complete","operationId":"openai_oauth_complete_v1_openai_oauth_complete_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthCompleteRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Oauth Complete V1 Openai Oauth Complete Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openai-oauth/models":{"get":{"summary":"Openai Oauth Models","operationId":"openai_oauth_models_v1_openai_oauth_models_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Oauth Models V1 Openai Oauth Models Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openai-oauth":{"delete":{"summary":"Openai Oauth Disconnect","operationId":"openai_oauth_disconnect_v1_openai_oauth_delete","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Oauth Disconnect V1 Openai Oauth Delete"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openai-oauth/test":{"post":{"summary":"Openai Oauth Test","operationId":"openai_oauth_test_v1_openai_oauth_test_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthTestRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Oauth Test V1 Openai Oauth Test Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openai-oauth/model":{"post":{"summary":"Openai Oauth Set Model","operationId":"openai_oauth_set_model_v1_openai_oauth_model_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthActivateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Oauth Set Model V1 Openai Oauth Model Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/openai-oauth/activate":{"post":{"summary":"Openai Oauth Activate","operationId":"openai_oauth_activate_v1_openai_oauth_activate_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OAuthActivateRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Openai Oauth Activate V1 Openai Oauth Activate Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/activity":{"get":{"summary":"Activity","operationId":"activity_v1_activity_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ActivityItemView"},"type":"array","title":"Response Activity V1 Activity Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/source-catalog":{"get":{"summary":"Source Catalog","operationId":"source_catalog_v1_source_catalog_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SourceCatalogItem"},"type":"array","title":"Response Source Catalog V1 Source Catalog Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/sources/preview":{"post":{"summary":"Preview Source","operationId":"preview_source_v1_sources_preview_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreviewSourceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Preview Source V1 Sources Preview Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/imports":{"post":{"summary":"Import Source","operationId":"import_source_v1_imports_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportSourceRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Import Source V1 Imports Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/sources/unibase-memory":{"get":{"summary":"Unibase Memory Status","operationId":"unibase_memory_status_v1_sources_unibase_memory_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Unibase Memory Status V1 Sources Unibase Memory Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Link Unibase Memory","operationId":"link_unibase_memory_v1_sources_unibase_memory_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UnibaseMemoryLink"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Link Unibase Memory V1 Sources Unibase Memory Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/source-items":{"get":{"summary":"List Source Items","description":"One page of rows, newest row first. The page size is capped, so a caller that\nwants the whole listing keeps raising `offset` until a short page comes back —\nwithout this, an import past the old fixed cap showed exactly 200 conversations\nno matter how many the count said.","operationId":"list_source_items_v1_source_items_get","parameters":[{"name":"connection_id","in":"query","required":false,"schema":{"type":"string","default":"","title":"Connection Id"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":200,"title":"Limit"}},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","default":0,"title":"Offset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Response List Source Items V1 Source Items Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/source-items/{item_id}/content":{"get":{"summary":"Source Item Content","operationId":"source_item_content_v1_source_items__item_id__content_get","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Source Item Content V1 Source Items  Item Id  Content Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agents/overview":{"get":{"summary":"Agents Overview","operationId":"agents_overview_v1_agents_overview_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agents Overview V1 Agents Overview Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agents/{aid}/verification":{"get":{"summary":"Agent Verification","operationId":"agent_verification_v1_agents__aid__verification_get","parameters":[{"name":"aid","in":"path","required":true,"schema":{"type":"string","title":"Aid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Agent Verification V1 Agents  Aid  Verification Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/onboarding/connect":{"post":{"summary":"Onboarding Connect","operationId":"onboarding_connect_v1_onboarding_connect_post","requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ConnectAgentRequest"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Onboarding Connect V1 Onboarding Connect Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/onboarding/connect/{aid}":{"get":{"summary":"Onboarding Status","operationId":"onboarding_status_v1_onboarding_connect__aid__get","parameters":[{"name":"aid","in":"path","required":true,"schema":{"type":"string","title":"Aid"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Onboarding Status V1 Onboarding Connect  Aid  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/intelligence/ask":{"post":{"summary":"Intelligence Ask","operationId":"intelligence_ask_v1_intelligence_ask_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Intelligence Ask V1 Intelligence Ask Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/intelligence/draft":{"post":{"summary":"Intelligence Draft","operationId":"intelligence_draft_v1_intelligence_draft_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Intelligence Draft V1 Intelligence Draft Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/intelligence/rewrite":{"post":{"summary":"Intelligence Rewrite","operationId":"intelligence_rewrite_v1_intelligence_rewrite_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Intelligence Rewrite V1 Intelligence Rewrite Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/intelligence/summarize":{"post":{"summary":"Intelligence Summarize","operationId":"intelligence_summarize_v1_intelligence_summarize_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Intelligence Summarize V1 Intelligence Summarize Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/collections":{"get":{"summary":"Space Collections","description":"The collection tags the account's documents carry.\n\nAn agent's memory scope is matched against these, so this is the only list where a\nselection can match anything. Its own endpoint rather than a field of the old\nworkbench payload: the caller wants a handful of strings, and workbench built a tree\nand a broken-link scan to hand them over — which on VM-backed storage means walking\nthe whole document tree.","operationId":"space_collections_v1_space_collections_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Collections V1 Space Collections Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/documents/{document_id}/markdown":{"get":{"summary":"Get Markdown","operationId":"get_markdown_v1_space_documents__document_id__markdown_get","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Markdown V1 Space Documents  Document Id  Markdown Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"put":{"summary":"Put Markdown","operationId":"put_markdown_v1_space_documents__document_id__markdown_put","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Put Markdown V1 Space Documents  Document Id  Markdown Put"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/assets":{"post":{"summary":"Upload Asset","operationId":"upload_asset_v1_space_assets_post","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Upload Asset V1 Space Assets Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"summary":"List Assets","operationId":"list_assets_v1_space_assets_get","parameters":[{"name":"document_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Assets V1 Space Assets Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/assets/{asset_id}":{"get":{"summary":"Get Asset","operationId":"get_asset_v1_space_assets__asset_id__get","parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","title":"Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Delete Asset","operationId":"delete_asset_v1_space_assets__asset_id__delete","parameters":[{"name":"asset_id","in":"path","required":true,"schema":{"type":"string","title":"Asset Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Asset V1 Space Assets  Asset Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/tree":{"get":{"summary":"Space Tree","operationId":"space_tree_v1_space_tree_get","parameters":[{"name":"path","in":"query","required":false,"schema":{"type":"string","default":"/","title":"Path"}},{"name":"depth","in":"query","required":false,"schema":{"type":"integer","default":2,"title":"Depth"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Tree V1 Space Tree Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/list":{"get":{"summary":"Space List","operationId":"space_list_v1_space_list_get","parameters":[{"name":"path","in":"query","required":false,"schema":{"type":"string","default":"/","title":"Path"}},{"name":"include_hidden","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Include Hidden"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space List V1 Space List Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/object":{"get":{"summary":"Space Object","operationId":"space_object_v1_space_object_get","parameters":[{"name":"path","in":"query","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Object V1 Space Object Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"patch":{"summary":"Space Rename","operationId":"space_rename_v1_space_object_patch","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RenameRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Rename V1 Space Object Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Space Delete","operationId":"space_delete_v1_space_object_delete","parameters":[{"name":"path","in":"query","required":true,"schema":{"type":"string","title":"Path"}},{"name":"hard","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Hard"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Delete V1 Space Object Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/search":{"get":{"summary":"Space Search","operationId":"space_search_v1_space_search_get","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","title":"Q"}},{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":50,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Search V1 Space Search Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/file":{"get":{"summary":"Space File","description":"One ordinary file's bytes, by path — because for a file the path *is* its identity.\n\nRendered inline only for types a browser can be trusted with: the account's own agent is\none of the authors of this tree, so \"the owner uploaded it\" is not the same as \"the owner\nwrote it\".","operationId":"space_file_v1_space_file_get","parameters":[{"name":"path","in":"query","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/archive":{"get":{"summary":"Space Archive","description":"Download one folder as a zip.\n\nStreamed rather than assembled: the archive is built inside the account's VM and its\nchunks are handed straight to the browser, so a large folder does not have to fit in this\nprocess's memory — and it costs one call to the VM instead of one per file, which is why\n\"folder download\" could not be offered before.","operationId":"space_archive_v1_space_archive_get","parameters":[{"name":"path","in":"query","required":true,"schema":{"type":"string","title":"Path"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/upload-capabilities":{"get":{"summary":"Space Upload Capabilities","operationId":"space_upload_capabilities_v1_space_upload_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Upload Capabilities V1 Space Upload Capabilities Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/folders":{"post":{"summary":"Space Create Folder","operationId":"space_create_folder_v1_space_folders_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FolderCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Create Folder V1 Space Folders Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/documents":{"post":{"summary":"Space Create Document","operationId":"space_create_document_v1_space_documents_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Create Document V1 Space Documents Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/move":{"post":{"summary":"Space Move","operationId":"space_move_v1_space_move_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoveRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Move V1 Space Move Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/uploads":{"post":{"summary":"Space Upload","operationId":"space_upload_v1_space_uploads_post","requestBody":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_space_upload_v1_space_uploads_post"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Upload V1 Space Uploads Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/runs":{"get":{"summary":"Space List Runs","operationId":"space_list_runs_v1_space_runs_get","parameters":[{"name":"kind","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Kind"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space List Runs V1 Space Runs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/runs/stats":{"get":{"summary":"Space Run Stats","operationId":"space_run_stats_v1_space_runs_stats_get","parameters":[{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Since"}},{"name":"until","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Until"}},{"name":"segments","in":"query","required":false,"schema":{"type":"integer","default":24,"title":"Segments"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Run Stats V1 Space Runs Stats Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/runs/{run_id}":{"get":{"summary":"Space Get Run","operationId":"space_get_run_v1_space_runs__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Get Run V1 Space Runs  Run Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/runs/{run_id}/trace":{"get":{"summary":"Space Run Trace","operationId":"space_run_trace_v1_space_runs__run_id__trace_get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Run Trace V1 Space Runs  Run Id  Trace Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/plan":{"get":{"summary":"Space Plan","operationId":"space_plan_v1_space_plan_get","parameters":[{"name":"scope","in":"query","required":false,"schema":{"type":"string","default":"space","title":"Scope"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Plan V1 Space Plan Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/entitlement-grant":{"get":{"summary":"Space Entitlement Grant","operationId":"space_entitlement_grant_v1_space_entitlement_grant_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Entitlement Grant V1 Space Entitlement Grant Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/plans":{"get":{"summary":"Space Billing Plans","operationId":"space_billing_plans_v1_space_billing_plans_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing Plans V1 Space Billing Plans Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/subscription":{"get":{"summary":"Space Billing Subscription","operationId":"space_billing_subscription_v1_space_billing_subscription_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing Subscription V1 Space Billing Subscription Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/upgrade":{"post":{"summary":"Space Billing Upgrade","operationId":"space_billing_upgrade_v1_space_billing_upgrade_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingPlanRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing Upgrade V1 Space Billing Upgrade Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/downgrade":{"post":{"summary":"Space Billing Downgrade","operationId":"space_billing_downgrade_v1_space_billing_downgrade_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingPlanRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing Downgrade V1 Space Billing Downgrade Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/plan-change":{"get":{"summary":"Space Billing Plan Change","description":"What switching to this plan would do, before the user commits to it: whether it\nis an upgrade or a downgrade, the amount due after crediting the unused part of the\ncurrent period, and when it takes effect.","operationId":"space_billing_plan_change_v1_space_billing_plan_change_get","parameters":[{"name":"plan_id","in":"query","required":true,"schema":{"type":"string","title":"Plan Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Billing Plan Change V1 Space Billing Plan Change Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/cancel-pending-change":{"post":{"summary":"Space Billing Cancel Pending Change","operationId":"space_billing_cancel_pending_change_v1_space_billing_cancel_pending_change_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing Cancel Pending Change V1 Space Billing Cancel Pending Change Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/expire":{"post":{"summary":"Space Billing Expire","operationId":"space_billing_expire_v1_space_billing_expire_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing Expire V1 Space Billing Expire Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/renew":{"post":{"summary":"Space Billing Renew","operationId":"space_billing_renew_v1_space_billing_renew_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing Renew V1 Space Billing Renew Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/cancel":{"post":{"summary":"Space Billing Cancel","operationId":"space_billing_cancel_v1_space_billing_cancel_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing Cancel V1 Space Billing Cancel Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/webhook":{"post":{"summary":"Space Billing Webhook","operationId":"space_billing_webhook_v1_space_billing_webhook_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingWebhookEvent"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing Webhook V1 Space Billing Webhook Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/x402/quote":{"get":{"summary":"Space Billing X402 Quote","operationId":"space_billing_x402_quote_v1_space_billing_x402_quote_get","parameters":[{"name":"plan_id","in":"query","required":true,"schema":{"type":"string","title":"Plan Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Billing X402 Quote V1 Space Billing X402 Quote Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/x402/prepare":{"post":{"summary":"Space Billing X402 Prepare","operationId":"space_billing_x402_prepare_v1_space_billing_x402_prepare_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing X402 Prepare V1 Space Billing X402 Prepare Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/tick":{"post":{"summary":"Space Billing Tick","operationId":"space_billing_tick_v1_space_billing_tick_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Space Billing Tick V1 Space Billing Tick Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/space/billing/x402/subscribe":{"post":{"summary":"Space Billing X402 Subscribe","operationId":"space_billing_x402_subscribe_v1_space_billing_x402_subscribe_post","parameters":[{"name":"X-PAYMENT","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Payment"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BillingPlanRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Space Billing X402 Subscribe V1 Space Billing X402 Subscribe Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-views":{"get":{"summary":"Memory Views List","operationId":"memory_views_list_v1_memory_views_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Memory Views List V1 Memory Views Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Memory View Create","operationId":"memory_view_create_v1_memory_views_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Memory View Create V1 Memory Views Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-views/referrers":{"get":{"summary":"Memory View Referrers","description":"Cross-surface dependency map for every view: agents, workflows, listings\n(with subscriber/revenue activity) and minted MCP credentials.","operationId":"memory_view_referrers_v1_memory_views_referrers_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Memory View Referrers V1 Memory Views Referrers Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-views/{view_id}":{"get":{"summary":"Memory View Get","operationId":"memory_view_get_v1_memory_views__view_id__get","parameters":[{"name":"view_id","in":"path","required":true,"schema":{"type":"string","title":"View Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Memory View Get V1 Memory Views  View Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"patch":{"summary":"Memory View Update","operationId":"memory_view_update_v1_memory_views__view_id__patch","parameters":[{"name":"view_id","in":"path","required":true,"schema":{"type":"string","title":"View Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Memory View Update V1 Memory Views  View Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Memory View Delete","operationId":"memory_view_delete_v1_memory_views__view_id__delete","parameters":[{"name":"view_id","in":"path","required":true,"schema":{"type":"string","title":"View Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Memory View Delete V1 Memory Views  View Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-views/{view_id}/learning":{"get":{"summary":"Memory View Learning","operationId":"memory_view_learning_v1_memory_views__view_id__learning_get","parameters":[{"name":"view_id","in":"path","required":true,"schema":{"type":"string","title":"View Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Memory View Learning V1 Memory Views  View Id  Learning Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memory-views/{view_id}/pipeline":{"post":{"summary":"Memory View Pipeline","description":"The Studio canvas of this memory view — found, adopted or drawn (Start → its agent).","operationId":"memory_view_pipeline_v1_memory_views__view_id__pipeline_post","parameters":[{"name":"view_id","in":"path","required":true,"schema":{"type":"string","title":"View Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Memory View Pipeline V1 Memory Views  View Id  Pipeline Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/agent-memory/learn":{"post":{"summary":"Agent Memory Learn","operationId":"agent_memory_learn_v1_agent_memory_learn_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Agent Memory Learn V1 Agent Memory Learn Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/exposures":{"get":{"summary":"List Exposures","description":"Unified Exposure catalog (ADR 0031) — the outbound half of the Input/Lens/Exposure\nmodel. MCP `AIAccess` bindings, marketplace listings and knowledge releases are all\nways to open one internal entity to the outside; this returns them as one list so the UI\ncan present a single Exposure surface instead of separate Agents/Marketplace/Releases\nentrypoints. Each entry carries its `mode` (mcp | listing | release) and `source`\nbackend.","operationId":"list_exposures_v1_exposures_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Exposures V1 Exposures Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Create Exposure","description":"Expose one entity: mode='mcp' mints a scoped MCP binding (agent/workflow),\nmode='listing' publishes a marketplace listing (release/workflow/agent).","operationId":"create_exposure_v1_exposures_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Exposure V1 Exposures Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/api-keys":{"post":{"summary":"Create Api Key","description":"Mint a developer key (docs/contract/agent-protocol.md): the owner's own credential\nfor scripts and SDKs. `profile` is read | suggest | manage, `view_ids` the containers\nit may use (narrowed live through PATCH /v1/exposures/{id}/views) or `all_views` for\nevery container including later ones, `profile_access` whether it may read the user's\nprofile, `expires_in_days` how long the token lives (omit: it does not expire),\n`replaces` the key this one rotates out. The token is returned once.","operationId":"create_api_key_v1_api_keys_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Create Api Key V1 Api Keys Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/api-keys/{key_id}":{"patch":{"summary":"Update Api Key","description":"Change a developer key in place: `name`, `profile` (its access level),\n`profile_access`, `all_views`. The grant changes for the key's next call; the token\nis untouched. Which containers it reaches is PATCH /v1/exposures/{id}/views.","operationId":"update_api_key_v1_api_keys__key_id__patch","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Update Api Key V1 Api Keys  Key Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/api-keys/{key_id}/usage":{"get":{"summary":"Api Key Usage","description":"What a developer key has been doing over the last `days`: calls per day, refused\ncalls, calls per tool, and the twenty most recent calls.","operationId":"api_key_usage_v1_api_keys__key_id__usage_get","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string","title":"Key Id"}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","default":30,"title":"Days"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Api Key Usage V1 Api Keys  Key Id  Usage Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/exposures/{exposure_id}/views":{"patch":{"summary":"Set Exposure Views","description":"Change which memory views one MCP connection may read.\n\nNarrowing is live: a view switched off here stops answering on that connection's next\nquery, with no credential re-minted and nothing to revoke (§9 — narrowing wins over\nanything already issued).","operationId":"set_exposure_views_v1_exposures__exposure_id__views_patch","parameters":[{"name":"exposure_id","in":"path","required":true,"schema":{"type":"string","title":"Exposure Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Set Exposure Views V1 Exposures  Exposure Id  Views Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/exposures/{exposure_id}":{"delete":{"summary":"Revoke Exposure","description":"Revoke one exposure; deletion/revocation wins over cached credentials and projections.","operationId":"revoke_exposure_v1_exposures__exposure_id__delete","parameters":[{"name":"exposure_id","in":"path","required":true,"schema":{"type":"string","title":"Exposure Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Revoke Exposure V1 Exposures  Exposure Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/containers":{"get":{"tags":["agent-protocol"],"summary":"List Containers","description":"The containers this credential may use — every one, for the account's owner.","operationId":"list_containers","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response List Containers"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/search":{"post":{"tags":["agent-protocol"],"summary":"Search Memories","description":"Passages the containers hold on a question, most relevant first, each naming its\ncontainer. Retrieval, not an answer — `POST /v1/ask` is the agent's answer.","operationId":"search_memories","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Search Memories"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/profile":{"get":{"tags":["agent-protocol"],"summary":"Get Profile","description":"Who the user is: standing facts (`static`), the most recently changed facts\n(`dynamic`), and — with `q` — the passages relevant to the topic (`results`).","operationId":"get_profile","parameters":[{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The current topic, for results.","title":"Q"},"description":"The current topic, for results."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Profile"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/rules":{"get":{"tags":["agent-protocol"],"summary":"Memory Rules","description":"The user's standing rules for how their memory is used by this credential.","operationId":"memory_rules","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Memory Rules"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/documents":{"get":{"tags":["agent-protocol"],"summary":"List Documents","description":"The documents the containers in reach have read, newest first.","operationId":"list_documents","parameters":[{"name":"container","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"One container id.","title":"Container"},"description":"One container id."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response List Documents"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"tags":["agent-protocol"],"summary":"Add Document","description":"Hand a document (text or url) to a container. Lands at once; learned in the\nbackground — poll `GET /v1/documents/{id}` for `learned`.","operationId":"add_document","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddDocumentRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Add Document"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/documents/{document_id}":{"get":{"tags":["agent-protocol"],"summary":"Get Document","description":"One document, with whether its container has learned it yet.","operationId":"get_document","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Get Document"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"tags":["agent-protocol"],"summary":"Delete Document","description":"Remove one document everywhere. Full access only: without `confirm=true` the answer\nis a request (`status: confirmation_required`); with it, a developer key deletes.","operationId":"delete_document","parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}},{"name":"confirm","in":"query","required":false,"schema":{"type":"boolean","description":"Developer keys: true to delete.","default":false,"title":"Confirm"},"description":"Developer keys: true to delete."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Delete Document"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memories":{"post":{"tags":["agent-protocol"],"summary":"Add Memory","description":"Save one fact. Static facts go to the user's profile; the rest to a container.","operationId":"add_memory","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddMemoryRequest"}}},"required":true},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Add Memory"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/memories/{memory_id}":{"delete":{"tags":["agent-protocol"],"summary":"Forget Memory","description":"Forget one learned fact. Same confirmation rule as deleting a document.","operationId":"forget_memory","parameters":[{"name":"memory_id","in":"path","required":true,"schema":{"type":"string","title":"Memory Id"}},{"name":"container","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"The container holding it.","title":"Container"},"description":"The container holding it."},{"name":"confirm","in":"query","required":false,"schema":{"type":"boolean","description":"Developer keys: true to forget.","default":false,"title":"Confirm"},"description":"Developer keys: true to forget."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Forget Memory"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/ask":{"post":{"tags":["agent-protocol"],"summary":"Ask Agent","description":"Send a message to the agent this credential exposes and get its reply.","operationId":"ask_agent","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Ask Agent"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/channels/telegram":{"get":{"summary":"Telegram Status","operationId":"telegram_status_v1_channels_telegram_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Telegram Status V1 Channels Telegram Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/channels/telegram/config":{"post":{"summary":"Telegram Configure","operationId":"telegram_configure_v1_channels_telegram_config_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Telegram Configure V1 Channels Telegram Config Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/channels/telegram/bind-codes":{"post":{"summary":"Telegram Bind Code","operationId":"telegram_bind_code_v1_channels_telegram_bind_codes_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Telegram Bind Code V1 Channels Telegram Bind Codes Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/channels/bindings/{binding_id}":{"delete":{"summary":"Channel Binding Revoke","operationId":"channel_binding_revoke_v1_channels_bindings__binding_id__delete","parameters":[{"name":"binding_id","in":"path","required":true,"schema":{"type":"string","title":"Binding Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Channel Binding Revoke V1 Channels Bindings  Binding Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/channels/chats/{chat_id}/thread":{"get":{"summary":"Channel Chat Thread","description":"The recent turns of one connected chat, so the owner can read on the web what they\nsaid to their assistant from their phone. A rolling window, not a full history — the\nresponse carries `window` so the surface can say which.","operationId":"channel_chat_thread_v1_channels_chats__chat_id__thread_get","parameters":[{"name":"chat_id","in":"path","required":true,"schema":{"type":"string","title":"Chat Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Channel Chat Thread V1 Channels Chats  Chat Id  Thread Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/channels/telegram/platform":{"get":{"summary":"Telegram Platform Status","operationId":"telegram_platform_status_v1_channels_telegram_platform_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Telegram Platform Status V1 Channels Telegram Platform Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/channels/telegram/platform/bind-codes":{"post":{"summary":"Telegram Platform Bind Code","operationId":"telegram_platform_bind_code_v1_channels_telegram_platform_bind_codes_post","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Body"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Telegram Platform Bind Code V1 Channels Telegram Platform Bind Codes Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/channels/telegram/platform/bindings/{chat_id}":{"delete":{"summary":"Telegram Platform Binding Revoke","operationId":"telegram_platform_binding_revoke_v1_channels_telegram_platform_bindings__chat_id__delete","parameters":[{"name":"chat_id","in":"path","required":true,"schema":{"type":"string","title":"Chat Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Telegram Platform Binding Revoke V1 Channels Telegram Platform Bindings  Chat Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflows":{"get":{"summary":"Workflow List","operationId":"workflow_list_v1_workflows_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Workflow List V1 Workflows Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Workflow Create","operationId":"workflow_create_v1_workflows_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Workflow Create V1 Workflows Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflows/{workflow_id}":{"get":{"summary":"Workflow Get","operationId":"workflow_get_v1_workflows__workflow_id__get","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Get V1 Workflows  Workflow Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"patch":{"summary":"Workflow Save","operationId":"workflow_save_v1_workflows__workflow_id__patch","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Save V1 Workflows  Workflow Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"delete":{"summary":"Workflow Archive","description":"Delete an agent: archives the workflow (run history kept) and pauses its schedules.","operationId":"workflow_archive_v1_workflows__workflow_id__delete","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Archive V1 Workflows  Workflow Id  Delete"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflows/{workflow_id}/deploy":{"post":{"summary":"Workflow Deploy","operationId":"workflow_deploy_v1_workflows__workflow_id__deploy_post","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/WorkflowDeploy"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Deploy V1 Workflows  Workflow Id  Deploy Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflows/{workflow_id}/deployments":{"get":{"summary":"Workflow Deployment List","operationId":"workflow_deployment_list_v1_workflows__workflow_id__deployments_get","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Deployment List V1 Workflows  Workflow Id  Deployments Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflows/{workflow_id}/runs":{"post":{"summary":"Workflow Run","operationId":"workflow_run_v1_workflows__workflow_id__runs_post","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/WorkflowRunCreate"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Run V1 Workflows  Workflow Id  Runs Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"get":{"summary":"Workflow Run List","operationId":"workflow_run_list_v1_workflows__workflow_id__runs_get","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Run List V1 Workflows  Workflow Id  Runs Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflows/{workflow_id}/invoke":{"post":{"summary":"Workflow Invoke","operationId":"workflow_invoke_v1_workflows__workflow_id__invoke_post","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/WorkflowRunCreate"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Invoke V1 Workflows  Workflow Id  Invoke Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflows/{workflow_id}/webhook":{"post":{"summary":"Workflow Webhook","operationId":"workflow_webhook_v1_workflows__workflow_id__webhook_post","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/WorkflowWebhookCreate"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Webhook V1 Workflows  Workflow Id  Webhook Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflow-runs/{run_id}":{"get":{"summary":"Workflow Run Get","operationId":"workflow_run_get_v1_workflow_runs__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Run Get V1 Workflow Runs  Run Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflow-runs/{run_id}/cancel":{"post":{"summary":"Workflow Run Cancel","operationId":"workflow_run_cancel_v1_workflow_runs__run_id__cancel_post","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Run Cancel V1 Workflow Runs  Run Id  Cancel Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflow-schedules":{"get":{"summary":"Workflow Schedule List","operationId":"workflow_schedule_list_v1_workflow_schedules_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Workflow Schedule List V1 Workflow Schedules Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"post":{"summary":"Workflow Schedule Create","description":"Schedule a published agent. The Schedules page's own way to make one — publishing a\ncanvas Schedule block is the other, and neither replaces the other.","operationId":"workflow_schedule_create_v1_workflow_schedules_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowScheduleCreate"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Workflow Schedule Create V1 Workflow Schedules Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflow-schedules/tick":{"post":{"summary":"Workflow Schedule Tick","operationId":"workflow_schedule_tick_v1_workflow_schedules_tick_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Workflow Schedule Tick V1 Workflow Schedules Tick Post"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflow-schedules/{schedule_id}":{"patch":{"summary":"Workflow Schedule Update","operationId":"workflow_schedule_update_v1_workflow_schedules__schedule_id__patch","parameters":[{"name":"schedule_id","in":"path","required":true,"schema":{"type":"string","title":"Schedule Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowScheduleUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Schedule Update V1 Workflow Schedules  Schedule Id  Patch"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/workflows/{workflow_id}/active":{"post":{"summary":"Workflow Set Active","operationId":"workflow_set_active_v1_workflows__workflow_id__active_post","parameters":[{"name":"workflow_id","in":"path","required":true,"schema":{"type":"string","title":"Workflow Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/WorkflowSetActive"},{"type":"null"}],"title":"Body"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Workflow Set Active V1 Workflows  Workflow Id  Active Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/runs":{"post":{"summary":"Run Start","operationId":"run_start_v1_runs_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunStartRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Run Start V1 Runs Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/runs/{run_id}":{"get":{"summary":"Run Get","operationId":"run_get_v1_runs__run_id__get","parameters":[{"name":"run_id","in":"path","required":true,"schema":{"type":"string","title":"Run Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Run Get V1 Runs  Run Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/mcp/info":{"get":{"summary":"Mcp Info","operationId":"mcp_info_v1_mcp_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Mcp Info V1 Mcp Info Get"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}},"/v1/oauth/consent":{"post":{"summary":"Consent","description":"Approval step of the MCP OAuth flow. Three roles share it:\n- owner exposing a set of their memory views → mints a provision_view_binding;\n- owner exposing their own agent → mints a provision_agent_binding\n  (the owner gate lives in provision_*, which is @owner_only);\n- buyer connecting a purchased listing (kind='listing') → re-issues the\n  existing cross-tenant listing credential, gated by an active grant in\n  reissue_memory_listing_credential (never charges, never provisions new\n  access). Either way the token is wrapped in a one-time code.","operationId":"consent_v1_oauth_consent_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsentRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Consent V1 Oauth Consent Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"default":{"description":"Error envelope (ADR 0027)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}}}},"components":{"schemas":{"AccountDeleteRequest":{"properties":{"reason":{"type":"string","title":"Reason"}},"type":"object","required":["reason"],"title":"AccountDeleteRequest"},"AccountProfileRequest":{"properties":{"display_name":{"type":"string","title":"Display Name"}},"type":"object","required":["display_name"],"title":"AccountProfileRequest"},"ActivityItemView":{"properties":{"id":{"type":"string","title":"Id"},"what":{"title":"What"},"status":{"title":"Status"},"status_label":{"title":"Status Label"},"when":{"title":"When"}},"type":"object","required":["id"],"title":"ActivityItemView"},"AddDocumentRequest":{"properties":{"container":{"type":"string","title":"Container","description":"Which container reads it."},"content":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Content","description":"The document's full text."},"url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Url","description":"A public web address to fetch instead."},"title":{"type":"string","title":"Title","default":""},"metadata":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metadata","description":"Your own tags, as an object."},"custom_id":{"type":"string","title":"Custom Id","description":"Your own id; adding the same custom_id again is a no-op.","default":""}},"type":"object","required":["container"],"title":"AddDocumentRequest"},"AddMemoryRequest":{"properties":{"content":{"type":"string","title":"Content","description":"The fact, as the user said it."},"container":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container","description":"Which container keeps it; required when more than one."},"static":{"type":"boolean","title":"Static","description":"A standing fact about the user themselves.","default":false},"title":{"type":"string","title":"Title","default":""}},"type":"object","required":["content"],"title":"AddMemoryRequest"},"AskRequest":{"properties":{"message":{"type":"string","title":"Message","default":""},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","title":"AskRequest"},"BillingPlanRequest":{"properties":{"plan_id":{"type":"string","title":"Plan Id"}},"type":"object","required":["plan_id"],"title":"BillingPlanRequest"},"BillingWebhookEvent":{"properties":{"type":{"type":"string","title":"Type"},"plan_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan Id"},"data":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Data"}},"type":"object","required":["type"],"title":"BillingWebhookEvent"},"Body_create_pet_v1_pets_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"name":{"type":"string","title":"Name"},"mode":{"type":"string","title":"Mode","default":"subject"}},"type":"object","required":["file","name"],"title":"Body_create_pet_v1_pets_post"},"Body_space_upload_v1_space_uploads_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path"},"document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Id"}},"type":"object","required":["file"],"title":"Body_space_upload_v1_space_uploads_post"},"Body_upload_agent_skill_package_v1_agent_skills_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_agent_skill_package_v1_agent_skills_upload_post"},"Body_upload_v1_uploads_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"}},"type":"object","required":["file"],"title":"Body_upload_v1_uploads_post"},"BridgeChangeset":{"properties":{"folder":{"type":"string","title":"Folder"},"device":{"type":"string","title":"Device"},"flavor":{"type":"string","title":"Flavor","default":"folder"},"upserts":{"items":{"$ref":"#/components/schemas/BridgeUpsert"},"type":"array","title":"Upserts","default":[]},"deletes":{"items":{"type":"string"},"type":"array","title":"Deletes","default":[]}},"type":"object","required":["folder","device"],"title":"BridgeChangeset"},"BridgeDeviceCreate":{"properties":{"name":{"type":"string","title":"Name"}},"type":"object","required":["name"],"title":"BridgeDeviceCreate"},"BridgeUpsert":{"properties":{"path":{"type":"string","title":"Path"},"text":{"type":"string","title":"Text"}},"type":"object","required":["path","text"],"title":"BridgeUpsert"},"CapabilitiesView":{"properties":{"principal":{"type":"string","title":"Principal"},"surfaces":{"items":{"type":"string"},"type":"array","title":"Surfaces"},"tools":{"items":{"type":"string"},"type":"array","title":"Tools"}},"type":"object","required":["principal","surfaces","tools"],"title":"CapabilitiesView"},"ConnectAgentRequest":{"properties":{"product":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Product"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"scope":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scope"},"collection_ids":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Collection Ids"},"engine":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engine"},"source_ids":{"anyOf":[{"items":{},"type":"array"},{"type":"null"}],"title":"Source Ids"}},"additionalProperties":true,"type":"object","title":"ConnectAgentRequest"},"ConnectRequest":{"properties":{"connector":{"type":"string","title":"Connector"},"config":{"additionalProperties":true,"type":"object","title":"Config","default":{}}},"type":"object","required":["connector"],"title":"ConnectRequest"},"ConsentRequest":{"properties":{"client_id":{"type":"string","title":"Client Id"},"redirect_uri":{"type":"string","title":"Redirect Uri"},"code_challenge":{"type":"string","title":"Code Challenge"},"resource":{"type":"string","title":"Resource","default":""},"state":{"type":"string","title":"State","default":""},"approve":{"type":"boolean","title":"Approve","default":true},"kind":{"type":"string","title":"Kind","default":"agent"},"subject_id":{"type":"string","title":"Subject Id","default":""},"subject_ids":{"items":{"type":"string"},"type":"array","title":"Subject Ids","default":[]},"profile_access":{"type":"boolean","title":"Profile Access","default":false}},"type":"object","required":["client_id","redirect_uri","code_challenge"],"title":"ConsentRequest"},"ConversationCreateRequest":{"properties":{"title":{"type":"string","title":"Title","default":""}},"type":"object","title":"ConversationCreateRequest"},"ConversationMessageRequest":{"properties":{"role":{"type":"string","title":"Role"},"text":{"type":"string","title":"Text"},"mentions":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Mentions"},"activity":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Activity"},"usage":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Usage"},"duration_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Duration Ms"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id"}},"type":"object","required":["role","text"],"title":"ConversationMessageRequest"},"ConversationRenameRequest":{"properties":{"title":{"type":"string","title":"Title"}},"type":"object","required":["title"],"title":"ConversationRenameRequest"},"DesktopAuthorizeRequest":{"properties":{"redirect_uri":{"type":"string","title":"Redirect Uri"},"code_challenge":{"type":"string","title":"Code Challenge"},"state":{"type":"string","title":"State","default":""}},"type":"object","required":["redirect_uri","code_challenge"],"title":"DesktopAuthorizeRequest"},"DesktopExchangeRequest":{"properties":{"code":{"type":"string","title":"Code"},"code_verifier":{"type":"string","title":"Code Verifier"}},"type":"object","required":["code","code_verifier"],"title":"DesktopExchangeRequest"},"DesktopSessionView":{"properties":{"account_id":{"type":"string","title":"Account Id"},"method":{"type":"string","title":"Method"},"expires_at":{"type":"string","title":"Expires At"},"csrf_token":{"type":"string","title":"Csrf Token"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"wallet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wallet"},"session_token":{"type":"string","title":"Session Token"}},"type":"object","required":["account_id","method","expires_at","csrf_token","session_token"],"title":"DesktopSessionView","description":"SessionView plus the raw session credential. The desktop app is not a browser —\nit cannot read an httpOnly cookie — so the exchange hands it the cookie value\n(\"<session_id>.<secret>\") in the body to store in its own keychain."},"DevSignInRequest":{"properties":{"email":{"type":"string","title":"Email"},"invite_code":{"type":"string","title":"Invite Code","default":""}},"type":"object","required":["email"],"title":"DevSignInRequest"},"DisconnectRequest":{"properties":{"delete_content":{"type":"boolean","title":"Delete Content","default":false},"detach":{"type":"boolean","title":"Detach","default":false}},"type":"object","title":"DisconnectRequest"},"DocumentCreate":{"properties":{"path":{"type":"string","title":"Path"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Title"},"template":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Template"}},"type":"object","required":["path"],"title":"DocumentCreate"},"FolderCreate":{"properties":{"path":{"type":"string","title":"Path"}},"type":"object","required":["path"],"title":"FolderCreate"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ImportSourceRequest":{"properties":{"connector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connector"},"mode":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mode"},"destination_collection":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Collection"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config"}},"additionalProperties":true,"type":"object","title":"ImportSourceRequest"},"MoveRequest":{"properties":{"src":{"type":"string","title":"Src"},"dst":{"type":"string","title":"Dst"}},"type":"object","required":["src","dst"],"title":"MoveRequest"},"NotionCancelRequest":{"properties":{"state":{"type":"string","title":"State"}},"type":"object","required":["state"],"title":"NotionCancelRequest"},"NotionOAuthCompleteRequest":{"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"},"state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"State"}},"type":"object","title":"NotionOAuthCompleteRequest"},"NotionSelectionPatchRequest":{"properties":{"paused":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Paused"},"roots":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Roots"},"include_children":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Include Children"},"root_names":{"anyOf":[{"additionalProperties":{"type":"string"},"type":"object"},{"type":"null"}],"title":"Root Names"},"destination_collection":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Collection"}},"type":"object","title":"NotionSelectionPatchRequest","description":"What the owner can change on a selection once it exists: pause or resume it, or\nrepoint it at other pages. Titles travel with the ids so the source can say what it\nreads without asking Notion again."},"NotionSelectionRequest":{"properties":{"authorization_id":{"type":"string","title":"Authorization Id"},"roots":{"items":{"type":"string"},"type":"array","title":"Roots"},"include_children":{"type":"boolean","title":"Include Children","default":true},"destination_collection":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Collection"},"root_names":{"additionalProperties":{"type":"string"},"type":"object","title":"Root Names","default":{}},"label":{"type":"string","title":"Label","default":""}},"type":"object","required":["authorization_id","roots"],"title":"NotionSelectionRequest"},"NotionStartRequest":{"properties":{"destination_collection":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Destination Collection"},"authorization_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization Id"}},"type":"object","title":"NotionStartRequest"},"NotionTokenRequest":{"properties":{"token":{"type":"string","title":"Token"}},"type":"object","required":["token"],"title":"NotionTokenRequest"},"OAuthActivateRequest":{"properties":{"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","title":"OAuthActivateRequest"},"OAuthCompleteRequest":{"properties":{"code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Code"}},"type":"object","title":"OAuthCompleteRequest"},"OAuthTestRequest":{"properties":{"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","title":"OAuthTestRequest"},"PreviewSourceRequest":{"properties":{"connector":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Connector"},"config":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Config"}},"type":"object","title":"PreviewSourceRequest"},"PrivySignInRequest":{"properties":{"access_token":{"type":"string","title":"Access Token"},"invite_code":{"type":"string","title":"Invite Code","default":""}},"type":"object","required":["access_token"],"title":"PrivySignInRequest"},"RenameRequest":{"properties":{"path":{"type":"string","title":"Path"},"name":{"type":"string","title":"Name"}},"type":"object","required":["path","name"],"title":"RenameRequest"},"RunRef":{"properties":{"kind":{"type":"string","title":"Kind"},"id":{"type":"string","title":"Id"}},"type":"object","required":["kind","id"],"title":"RunRef"},"RunStartRequest":{"properties":{"ref":{"$ref":"#/components/schemas/RunRef"},"input":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input"}},"type":"object","required":["ref"],"title":"RunStartRequest"},"SearchRequest":{"properties":{"q":{"type":"string","title":"Q","description":"The question, in natural language."},"container":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Container","description":"One container id; omit to search every container in reach."},"limit":{"anyOf":[{"type":"integer","maximum":50.0,"minimum":1.0},{"type":"null"}],"title":"Limit","description":"How many passages to return in all, not per container. A fan-out over five containers with limit 5 answers with five passages, taking each container's best before any container's second. Unset covers every container in reach (at least 8), so none is left unheard; a container that had passages but lost them all to the budget comes back with `truncated: true`."}},"type":"object","required":["q"],"title":"SearchRequest"},"SessionView":{"properties":{"account_id":{"type":"string","title":"Account Id"},"method":{"type":"string","title":"Method"},"expires_at":{"type":"string","title":"Expires At"},"csrf_token":{"type":"string","title":"Csrf Token"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"display_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Display Name"},"wallet":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Wallet"}},"type":"object","required":["account_id","method","expires_at","csrf_token"],"title":"SessionView"},"SetAiProviderCredentialsRequest":{"properties":{"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key"},"base_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Base Url"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","title":"SetAiProviderCredentialsRequest"},"SetAiProviderModelRequest":{"properties":{"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model"}},"type":"object","title":"SetAiProviderModelRequest"},"SourceCatalogItem":{"properties":{"id":{"type":"string","title":"Id"},"name":{"title":"Name"},"kind":{"title":"Kind"},"available":{"title":"Available"},"native":{"title":"Native"},"note":{"title":"Note"},"connect_via":{"title":"Connect Via"}},"type":"object","required":["id"],"title":"SourceCatalogItem"},"SourceCreate":{"properties":{"uri":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Uri"},"text":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Text"},"upload_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upload Id"},"kind":{"type":"string","title":"Kind","default":"document"},"idempotency_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Idempotency Key"}},"type":"object","title":"SourceCreate"},"TestAiProviderRequest":{"properties":{"prompt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Prompt"}},"type":"object","title":"TestAiProviderRequest"},"UnibaseMemoryLink":{"properties":{"owner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Owner"},"signature":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Signature"},"hub_token":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hub Token"},"hub_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hub Url"}},"additionalProperties":true,"type":"object","title":"UnibaseMemoryLink"},"UploadRef":{"properties":{"id":{"type":"string","title":"Id"},"filename":{"type":"string","title":"Filename"},"media_type":{"type":"string","title":"Media Type"},"bytes":{"type":"integer","title":"Bytes"},"sha256":{"type":"string","title":"Sha256"}},"type":"object","required":["id","filename","media_type","bytes","sha256"],"title":"UploadRef"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WalletChallengeRequest":{"properties":{"address":{"type":"string","title":"Address"}},"type":"object","required":["address"],"title":"WalletChallengeRequest"},"WalletSignInRequest":{"properties":{"message":{"type":"string","title":"Message"},"signature":{"type":"string","title":"Signature"},"invite_code":{"type":"string","title":"Invite Code","default":""}},"type":"object","required":["message","signature"],"title":"WalletSignInRequest"},"WorkflowCreate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"definition":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Definition"}},"type":"object","title":"WorkflowCreate"},"WorkflowDeploy":{"properties":{"triggers":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Triggers"}},"type":"object","title":"WorkflowDeploy"},"WorkflowRunCreate":{"properties":{"input":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Input"},"trigger":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Trigger"}},"type":"object","title":"WorkflowRunCreate"},"WorkflowScheduleCreate":{"properties":{"workflow_id":{"type":"string","title":"Workflow Id"},"cron":{"type":"string","title":"Cron"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"}},"type":"object","required":["workflow_id","cron"],"title":"WorkflowScheduleCreate"},"WorkflowScheduleUpdate":{"properties":{"cron":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cron"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status"}},"type":"object","title":"WorkflowScheduleUpdate"},"WorkflowSetActive":{"properties":{"active":{"type":"boolean","title":"Active","default":true}},"type":"object","title":"WorkflowSetActive"},"WorkflowUpdate":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Name"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"definition":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Definition"}},"type":"object","title":"WorkflowUpdate"},"WorkflowWebhookCreate":{"properties":{"payload":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Payload"},"secret":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Secret"}},"type":"object","title":"WorkflowWebhookCreate"},"ErrorBody":{"type":"object","title":"ErrorBody","properties":{"code":{"type":"string","description":"Stable machine-readable error code."},"message":{"type":"string","description":"Human-readable summary."},"details":{"type":"object","nullable":true,"additionalProperties":true,"description":"Optional structured context (e.g. validation fields)."},"retryable":{"type":"boolean"},"trace_id":{"type":"string","description":"Maps to the OTel trace for support."}},"required":["code","message","retryable","trace_id"]},"ErrorEnvelope":{"type":"object","title":"ErrorEnvelope","properties":{"error":{"$ref":"#/components/schemas/ErrorBody"}},"required":["error"]}}}}