{"openapi":"3.1.0","info":{"title":"Symposium WorkspaceAPI","version":"2.7.0","description":"Workspace-local API. SYM-node performs final authentication, authorization, execution, and data access. Runtime controls are intentionally explicit: a chat-targeted Hermes reset is currently requested by sending /new through send_agent_message; no first-class session rebind, chat-runtime restart, profile Gateway restart, tmux kill, or force-new-runtime operation is exposed. Account app and browser Pass operations are part of WorkspaceAPI but require account credentials. Account routes override the server to https://app.sym.so/v1; conversation delegation requires BOTH credentials."},"servers":[{"url":"https://{workspace_worker}/api/v1","variables":{"workspace_worker":{"default":"worker.example.ts.net"}}}],"paths":{"/":{"get":{"summary":"Get WorkspaceAPI root","operationId":"get_workspaceapi_root","x-symposium-realtime-signal-id":"get_workspaceapi_root","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"workspace:read"}},"/openapi.json":{"get":{"summary":"Get WorkspaceAPI OpenAPI contract","operationId":"get_workspaceapi_openapi_contract","x-symposium-realtime-signal-id":"get_workspaceapi_openapi_contract","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}}}},"/oauth/token":{"post":{"summary":"Exchange OAuth token","operationId":"exchange_oauth_token","x-symposium-realtime-signal-id":"exchange_oauth_token","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/me":{"get":{"summary":"Get current identity","operationId":"get_current_identity","x-symposium-realtime-signal-id":"get_current_identity","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"workspace:read"}},"/workspace":{"get":{"summary":"Get workspace","operationId":"get_workspace","x-symposium-realtime-signal-id":"get_workspace","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"workspace:read"}},"/machine":{"get":{"summary":"Get safe machine state","operationId":"get_safe_machine_state","x-symposium-realtime-signal-id":"get_safe_machine_state","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"machine:read"}},"/machine/storage":{"get":{"summary":"Get storage state","operationId":"get_storage_state","x-symposium-realtime-signal-id":"get_storage_state","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"machine:read"}},"/machine/memory":{"get":{"summary":"Get memory state","operationId":"get_memory_state","x-symposium-realtime-signal-id":"get_memory_state","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"machine:read"}},"/api-keys":{"get":{"summary":"List my workspace API keys","operationId":"list_workspace_api_keys","x-symposium-realtime-signal-id":"list_workspace_api_keys","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["ok","items","scopes"],"properties":{"ok":{"type":"boolean"},"items":{"type":"array","items":{"$ref":"#/components/schemas/WorkspaceApiKey"}},"scopes":{"type":"array","items":{"type":"string"}},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"api_keys:read"},"post":{"summary":"Create a workspace API key","operationId":"create_workspace_api_key","x-symposium-realtime-signal-id":"create_workspace_api_key","responses":{"200":{"description":"Success"},"201":{"description":"Created; raw key revealed once","content":{"application/json":{"schema":{"type":"object","required":["ok","item","key","reveal_once"],"properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/WorkspaceApiKey"},"request_id":{"type":"string"},"key":{"type":"string","description":"Raw secret returned once. Never logged or returned by list operations."},"reveal_once":{"type":"boolean"},"previous_key_revoked":{"type":"boolean"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"api_keys:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkspaceApiKeyCreate"}}}}}},"/api-keys/{key_id}/rotate":{"post":{"summary":"Rotate a workspace API key","operationId":"rotate_workspace_api_key","x-symposium-realtime-signal-id":"rotate_workspace_api_key","responses":{"200":{"description":"Success"},"201":{"description":"Rotated; replacement key revealed once","content":{"application/json":{"schema":{"type":"object","required":["ok","item","key","reveal_once"],"properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/WorkspaceApiKey"},"request_id":{"type":"string"},"key":{"type":"string","description":"Raw secret returned once. Never logged or returned by list operations."},"reveal_once":{"type":"boolean"},"previous_key_revoked":{"type":"boolean"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"api_keys:write","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string"},"description":"User-owned workspace API key ID."}]}},"/api-keys/{key_id}":{"delete":{"summary":"Revoke a workspace API key","operationId":"revoke_workspace_api_key","x-symposium-realtime-signal-id":"revoke_workspace_api_key","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["ok","item"],"properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/WorkspaceApiKey"},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"api_keys:write","parameters":[{"name":"key_id","in":"path","required":true,"schema":{"type":"string"},"description":"User-owned workspace API key ID."}]}},"/agents":{"get":{"summary":"List Agents","operationId":"list_agents","x-symposium-realtime-signal-id":"list_agents","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"agents:read"},"post":{"summary":"Create Agent","operationId":"create_agent","x-symposium-realtime-signal-id":"create_agent","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"agents:create","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/agents/{agent_id}":{"get":{"summary":"Get Agent","operationId":"get_agent","x-symposium-realtime-signal-id":"get_agent","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"agents:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]},"patch":{"summary":"Update Agent","operationId":"update_agent","x-symposium-realtime-signal-id":"update_agent","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"agents:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]},"delete":{"summary":"Delete Agent","operationId":"delete_agent","x-symposium-realtime-signal-id":"delete_agent","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"agents:delete","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/agents/{agent_id}/settings":{"get":{"summary":"Get Agent runtime settings","operationId":"get_agent_settings","x-symposium-realtime-signal-id":"get_agent_settings","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["ok","item"],"properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/AgentRuntimeSettings"},"applies_immediately":{"type":"boolean"},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"settings:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Reads the persistent Hermes command-approval mode only. This endpoint does not reset chats, rotate session bindings, restart an Agent Gateway, or control tmux/runtime processes."},"put":{"summary":"Update Agent runtime settings","operationId":"update_agent_settings","x-symposium-realtime-signal-id":"update_agent_settings","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["ok","item"],"properties":{"ok":{"type":"boolean"},"item":{"$ref":"#/components/schemas/AgentRuntimeSettings"},"applies_immediately":{"type":"boolean"},"request_id":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"settings:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRuntimeSettingsUpdate"}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Updates approval_mode only. It does not reset or restart any chat, session, Gateway, tmux process, or Agent runtime."}},"/agents/{agent_id}/files":{"get":{"summary":"List Agent files","operationId":"list_agent_files","x-symposium-realtime-signal-id":"list_agent_files","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"files:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]},"delete":{"summary":"Delete Agent file","operationId":"delete_agent_file","x-symposium-realtime-signal-id":"delete_agent_file","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"files:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/agents/{agent_id}/files/content":{"get":{"summary":"Read Agent file","operationId":"read_agent_file","x-symposium-realtime-signal-id":"read_agent_file","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"files:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]},"put":{"summary":"Write Agent file","operationId":"write_agent_file","x-symposium-realtime-signal-id":"write_agent_file","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"files:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/agents/{agent_id}/files/download":{"get":{"summary":"Download Agent file","operationId":"download_agent_file","x-symposium-realtime-signal-id":"download_agent_file","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"files:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/agents/{agent_id}/files/directories":{"post":{"summary":"Create Agent directory","operationId":"create_agent_directory","x-symposium-realtime-signal-id":"create_agent_directory","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"files:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/agents/{agent_id}/files/move":{"post":{"summary":"Move Agent file","operationId":"move_agent_file","x-symposium-realtime-signal-id":"move_agent_file","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"files:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/agents/{agent_id}/chats":{"get":{"summary":"List Agent chats","operationId":"list_agent_chats","x-symposium-realtime-signal-id":"list_agent_chats","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"chats:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]},"post":{"summary":"Create Agent chat","operationId":"create_agent_chat","x-symposium-realtime-signal-id":"create_agent_chat","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"chats:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentChatCreate"}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Creates a durable chat record and optional initial message. A new chat is not a profile-runtime restart and does not guarantee recovery from a stuck Agent Gateway or stale profile-level session restoration."}},"/agents/{agent_id}/chats/{chat_id}":{"get":{"summary":"Get Agent chat","operationId":"get_agent_chat","x-symposium-realtime-signal-id":"get_agent_chat","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"chats:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}}]},"patch":{"summary":"Update Agent chat","operationId":"update_agent_chat","x-symposium-realtime-signal-id":"update_agent_chat","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"chats:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}}]},"delete":{"summary":"Archive Agent chat","operationId":"archive_agent_chat","x-symposium-realtime-signal-id":"archive_agent_chat","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"chats:write","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Archives the durable chat record and preserves history. It does not send /new, terminate a session, kill tmux, rotate a Gateway session key, or restart the Agent runtime."}},"/agents/{agent_id}/chats/{chat_id}/messages":{"get":{"summary":"List chat messages","operationId":"list_chat_messages","x-symposium-realtime-signal-id":"list_chat_messages","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"messages:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}}]},"post":{"summary":"Send Agent message","operationId":"send_agent_message","x-symposium-realtime-signal-id":"send_agent_message","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"messages:send","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentMessageCreate"},"examples":{"conversation_reset":{"summary":"Request a reset of this chat's current Hermes conversation","value":{"content":"/new","client_message_id":"reset-chat-unique-001"}}}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Queues a message to this exact Agent chat and its current session binding. Hermes slash commands are preserved exactly; send content /new to request a conversation-scoped Hermes reset. Success proves durable queueing/dispatch, not that a stuck runtime consumed or acknowledged the reset.","x-browser-delegation":{"gateway":"https://app.sym.so/v1/workspaces/{workspace_id}","header":"X-Sym-Account-Authorization","scope":"browser_passes:delegate","requires":["matching credential owner","workspace:read","messages:send","content","client_message_id"],"raw_account_key_forwarded":false,"worker_ticket_ttl_seconds":60,"note":"Ordinary authenticated workspace messages reuse the sending user's existing conversation Browser Pass grants, like UI messages; no account header is required. This optional header retains explicit account-ticket admission. Creating or changing Pass grants still requires separate account authority. Never send account credentials directly to a worker."}}},"/agents/{agent_id}/chats/{chat_id}/events":{"get":{"summary":"Stream Agent events","operationId":"stream_agent_events","x-symposium-realtime-signal-id":"stream_agent_events","responses":{"200":{"description":"Success","content":{"text/event-stream":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"messages:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/messages/{message_id}":{"get":{"summary":"Get message","operationId":"get_message","x-symposium-realtime-signal-id":"get_message","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"messages:read","parameters":[{"name":"message_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/operations":{"get":{"summary":"List operations","operationId":"list_operations","x-symposium-realtime-signal-id":"list_operations","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"operations:read"}},"/operations/{operation_id}":{"get":{"summary":"Get operation","operationId":"get_operation","x-symposium-realtime-signal-id":"get_operation","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"operations:read","parameters":[{"name":"operation_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/operations/{operation_id}/events":{"get":{"summary":"Stream operation events","operationId":"stream_operation_events","x-symposium-realtime-signal-id":"stream_operation_events","responses":{"200":{"description":"Success","content":{"text/event-stream":{"schema":{"type":"string"}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"operations:read","parameters":[{"name":"operation_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/operations/{operation_id}/cancel":{"post":{"summary":"Cancel operation","operationId":"cancel_operation","x-symposium-realtime-signal-id":"cancel_operation","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"operations:cancel","parameters":[{"name":"operation_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/webhooks":{"get":{"summary":"List webhooks","operationId":"list_webhooks","x-symposium-realtime-signal-id":"list_webhooks","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"webhooks:read"},"post":{"summary":"Create webhook","operationId":"create_webhook","x-symposium-realtime-signal-id":"create_webhook","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"webhooks:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/webhooks/{webhook_id}":{"patch":{"summary":"Update webhook","operationId":"update_webhook","x-symposium-realtime-signal-id":"update_webhook","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"webhooks:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string"}}]},"delete":{"summary":"Revoke webhook","operationId":"revoke_webhook","x-symposium-realtime-signal-id":"revoke_webhook","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"webhooks:write","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/webhooks/{webhook_id}/test":{"post":{"summary":"Test webhook","operationId":"test_webhook","x-symposium-realtime-signal-id":"test_webhook","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"webhooks:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/webhooks/{webhook_id}/deliveries":{"get":{"summary":"List webhook deliveries","operationId":"list_webhook_deliveries","x-symposium-realtime-signal-id":"list_webhook_deliveries","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"webhooks:read","parameters":[{"name":"webhook_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/schedules":{"get":{"summary":"List schedules","operationId":"list_schedules","x-symposium-realtime-signal-id":"list_schedules","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"schedules:read"}},"/workspace/instructions":{"get":{"summary":"Get workspace instructions","operationId":"get_workspace_instructions","x-symposium-realtime-signal-id":"get_workspace_instructions","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"instructions:read"},"put":{"summary":"Update workspace instructions","operationId":"update_workspace_instructions","x-symposium-realtime-signal-id":"update_workspace_instructions","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"instructions:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}}}},"/agents/{agent_id}/soul":{"get":{"summary":"Get Agent soul","operationId":"get_agent_soul","x-symposium-realtime-signal-id":"get_agent_soul","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"instructions:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]},"put":{"summary":"Update Agent soul","operationId":"update_agent_soul","x-symposium-realtime-signal-id":"update_agent_soul","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"instructions:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/agents/{agent_id}/apps":{"get":{"summary":"List Agent apps","operationId":"list_agent_apps","x-symposium-realtime-signal-id":"list_agent_apps","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"apps:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/agents/{agent_id}/secrets":{"get":{"summary":"List Agent secret configuration","operationId":"list_agent_secret_configuration","x-symposium-realtime-signal-id":"list_agent_secret_configuration","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"secrets:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]},"post":{"summary":"Set or remove Agent secrets","operationId":"set_or_remove_agent_secrets","x-symposium-realtime-signal-id":"set_or_remove_agent_secrets","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"secrets:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object"}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Set or remove write-only profile secrets. Exact-name values automatically satisfy same-profile app declarations; matching running apps refresh, while undeclared and sibling-profile secrets remain excluded. Values are never returned."}},"/agents/{agent_id}/apps/{app_id}/secrets":{"get":{"summary":"List app secret configuration","operationId":"list_app_secret_configuration","x-symposium-realtime-signal-id":"list_app_secret_configuration","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"secrets:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"app_id","in":"path","required":true,"schema":{"type":"string"}}]},"post":{"summary":"Set, assign, or remove app secrets","operationId":"set_or_remove_app_secrets","x-symposium-realtime-signal-id":"set_or_remove_app_secrets","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"secrets:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"profile_secret_refs":{"type":"object","maxProperties":20,"additionalProperties":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{0,127}$"}},"values":{"type":"object","additionalProperties":{"type":"string"},"writeOnly":true},"unset":{"type":"array","items":{"type":"string","pattern":"^[A-Z][A-Z0-9_]{0,127}$"}}},"additionalProperties":false}}}},"parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"app_id","in":"path","required":true,"schema":{"type":"string"}}],"description":"Configure an alias when a manifest-declared app-secret name differs from an existing same-profile secret, set new write-only app values, or remove app secrets. Exact-name profile secrets bind automatically and do not need profile_secret_refs. Values are resolved inside SYM-node and never returned."}},"/settings":{"get":{"summary":"Get workspace settings","operationId":"get_workspace_settings","x-symposium-realtime-signal-id":"get_workspace_settings","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"settings:read"}},"/search":{"get":{"summary":"Search accessible chats and messages","operationId":"search_workspace","x-symposium-realtime-signal-id":"search_workspace","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"search:read"}},"/activity/recent":{"get":{"summary":"Get recent workspace activity","operationId":"get_recent_workspace_activity","x-symposium-realtime-signal-id":"get_recent_workspace_activity","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"chats:read","parameters":[{"name":"per_agent","in":"query","schema":{"type":"integer","minimum":1,"maximum":5,"default":3}},{"name":"message_limit","in":"query","schema":{"type":"integer","minimum":0,"maximum":3,"default":2}},{"name":"include_messages","in":"query","schema":{"type":"boolean","default":true},"description":"Including messages additionally requires messages:read."}]}},"/overview":{"get":{"summary":"Get compact workspace overview","operationId":"get_compact_workspace_overview","x-symposium-realtime-signal-id":"get_compact_workspace_overview","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"workspace:read"}},"/agents/{agent_id}/brief":{"get":{"summary":"Get Agent brief","operationId":"get_agent_brief","x-symposium-realtime-signal-id":"get_agent_brief","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"agents:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}}]}},"/agents/{agent_id}/chats/{chat_id}/tail":{"get":{"summary":"Get latest chat messages","operationId":"get_latest_chat_messages","x-symposium-realtime-signal-id":"get_latest_chat_messages","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"messages:read","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":20,"default":5}}]}},"/connections/cosmise":{"get":{"summary":"Get safe Cosmise connection status","operationId":"get_safe_cosmise_connection_status","x-symposium-realtime-signal-id":"get_safe_cosmise_connection_status","responses":{"200":{"description":"Success"},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[]}],"x-symposium-scope":"connections:read"}},"/account/bridge-apps":{"get":{"summary":"List account Bridge apps","operationId":"list_bridge_apps","x-symposium-realtime-signal-id":"list_bridge_apps","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"protocol":"bridge-app-management-v2","instances":[]}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"accountBearer":[]}],"x-symposium-scope":"bridge_apps:read","description":"List account Bridge apps. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority. Base URL: https://app.sym.so/v1 (not a workspace URL). Metadata does not prove device readiness. No credentials are returned.","parameters":[],"servers":[{"url":"https://app.sym.so/v1"}],"x-account-scopes":["bridge_apps:read"]}},"/account/bridge-apps/{app_id}":{"get":{"summary":"Inspect app readiness","operationId":"get_bridge_app","x-symposium-realtime-signal-id":"get_bridge_app","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"deviceId":"11111111-1111-4111-8111-111111111111","result":{"ready":true,"browserAccess":true,"managementAllowed":true}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"accountBearer":[]}],"x-symposium-scope":"bridge_apps:read","description":"Inspect app readiness. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority. Base URL: https://app.sym.so/v1 (not a workspace URL). Metadata does not prove device readiness. No credentials are returned.","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1"}],"x-account-scopes":["bridge_apps:read"]}},"/account/bridge-apps/{app_id}/profiles":{"get":{"summary":"List connected Chrome profiles","operationId":"list_bridge_profiles","x-symposium-realtime-signal-id":"list_bridge_profiles","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"deviceId":"11111111-1111-4111-8111-111111111111","result":{"profiles":[{"profile":"ext:example","label":"Example browser","connectionState":"connected","tabCount":1}]}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"accountBearer":[]}],"x-symposium-scope":"bridge_apps:read","description":"List connected Chrome profiles. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority. Base URL: https://app.sym.so/v1 (not a workspace URL). Metadata does not prove device readiness. No credentials are returned.","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1"}],"x-account-scopes":["bridge_apps:read"]}},"/account/bridge-apps/{app_id}/receipts":{"get":{"summary":"Inspect recent app management receipts","operationId":"get_bridge_receipts","x-symposium-realtime-signal-id":"get_bridge_receipts","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"deviceId":"11111111-1111-4111-8111-111111111111","result":{"receipts":[]}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"accountBearer":[]}],"x-symposium-scope":"bridge_apps:read","description":"Inspect recent app management receipts. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority. Base URL: https://app.sym.so/v1 (not a workspace URL). Metadata does not prove device readiness. No credentials are returned.","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1"}],"x-account-scopes":["bridge_apps:read"]}},"/account/bridge-apps/{app_id}/access":{"patch":{"summary":"Enable or disable app browser access","operationId":"set_bridge_access","x-symposium-realtime-signal-id":"set_bridge_access","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"deviceId":"11111111-1111-4111-8111-111111111111","result":{"receipt":{"id":"11111111-1111-4111-8111-111111111111","status":"completed","result":{"enabled":true}},"replayed":false}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"accountBearer":[]}],"x-symposium-scope":"bridge_apps:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"enabled":{"type":"boolean"},"request_id":{"type":"string","format":"uuid"},"issued_at":{"type":"integer","description":"Unix milliseconds within 60 seconds. Example timestamp is illustrative; generate a fresh value."}},"required":["enabled","request_id","issued_at"],"additionalProperties":false},"example":{"enabled":true,"request_id":"11111111-1111-4111-8111-111111111111","issued_at":1800000000000}}}},"description":"Enable or disable app browser access. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority. Base URL: https://app.sym.so/v1 (not a workspace URL). App management is the access switch and browser Pass management, not desktop control. Management Off in the native app is a local veto. The app must be connected and support bridge-app-management-v2. No automatic retries: HTTP 200 alone is not mutation success. Check result.receipt.status; outcome_unknown requires receipts/state inspection.","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1"}],"x-account-scopes":["bridge_apps:write"]}},"/account/browser-passes":{"get":{"summary":"List account-authorized browser Passes","operationId":"list_account_browser_passes","x-symposium-realtime-signal-id":"list_account_browser_passes","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"items":[]}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"accountBearer":[]}],"x-symposium-scope":"browser_passes:read","description":"List account-authorized browser Passes. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority. Base URL: https://app.sym.so/v1 (not a workspace URL). Metadata does not prove device readiness. No credentials are returned.","parameters":[],"servers":[{"url":"https://app.sym.so/v1"}],"x-account-scopes":["browser_passes:read"]}},"/account/bridge-apps/{app_id}/browser-passes":{"get":{"summary":"List browser Passes on one app","operationId":"list_app_browser_passes","x-symposium-realtime-signal-id":"list_app_browser_passes","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"deviceId":"11111111-1111-4111-8111-111111111111","result":{"passes":[]}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"accountBearer":[]}],"x-symposium-scope":"browser_passes:read","description":"List browser Passes on one app. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority. Base URL: https://app.sym.so/v1 (not a workspace URL). Metadata does not prove device readiness. No credentials are returned.","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1"}],"x-account-scopes":["browser_passes:read"]},"post":{"summary":"Create an app browser Pass","operationId":"create_app_browser_pass","x-symposium-realtime-signal-id":"create_app_browser_pass","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"deviceId":"11111111-1111-4111-8111-111111111111","result":{"receipt":{"id":"11111111-1111-4111-8111-111111111111","status":"completed","result":{"pass":{"id":"11111111-1111-4111-8111-111111111111","name":"Example browser access","scope":"read","profiles":["ext:example"]}}},"replayed":false}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"accountBearer":[]}],"x-symposium-scope":"browser_passes:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"},"profiles":{"type":"array","items":{"type":"string"},"minItems":1,"maxItems":50,"uniqueItems":true},"scope":{"type":"string","enum":["read","full"]},"request_id":{"type":"string","format":"uuid"},"issued_at":{"type":"integer","description":"Unix milliseconds within 60 seconds. Example timestamp is illustrative; generate a fresh value."}},"required":["name","profiles","scope","request_id","issued_at"],"additionalProperties":false},"example":{"name":"Example browser access","profiles":["ext:example"],"scope":"read","request_id":"11111111-1111-4111-8111-111111111111","issued_at":1800000000000}}}},"description":"Create an app browser Pass. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority. Base URL: https://app.sym.so/v1 (not a workspace URL). App management is the access switch and browser Pass management, not desktop control. Management Off in the native app is a local veto. The app must be connected and support bridge-app-management-v2. No automatic retries: HTTP 200 alone is not mutation success. Check result.receipt.status; outcome_unknown requires receipts/state inspection.","parameters":[{"name":"app_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1"}],"x-account-scopes":["browser_passes:write"]}},"/account/bridge-apps/{app_id}/browser-passes/{pass_id}":{"delete":{"summary":"Revoke a browser Pass on its app","operationId":"revoke_app_browser_pass","x-symposium-realtime-signal-id":"revoke_app_browser_pass","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"deviceId":"11111111-1111-4111-8111-111111111111","result":{"receipt":{"id":"11111111-1111-4111-8111-111111111111","status":"completed","result":{"revoked":true}},"replayed":false}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"accountBearer":[]}],"x-symposium-scope":"browser_passes:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid"},"issued_at":{"type":"integer","description":"Unix milliseconds within 60 seconds. Example timestamp is illustrative; generate a fresh value."}},"required":["request_id","issued_at"],"additionalProperties":false},"example":{"request_id":"11111111-1111-4111-8111-111111111111","issued_at":1800000000000}}}},"description":"Revoke a browser Pass on its app. Account API key only; a workspace key, workspace administrator role or attached browser Pass is not account authority. Base URL: https://app.sym.so/v1 (not a workspace URL). App management is the access switch and browser Pass management, not desktop control. Management Off in the native app is a local veto. The app must be connected and support bridge-app-management-v2. No automatic retries: HTTP 200 alone is not mutation success. Check result.receipt.status; outcome_unknown requires receipts/state inspection.","parameters":[{"name":"pass_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"app_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1"}],"x-account-scopes":["browser_passes:write"]}},"/agents/{agent_id}/chats/{chat_id}/browser-passes":{"get":{"summary":"List conversation browser Pass","operationId":"list_conversation_browser_pass","x-symposium-realtime-signal-id":"list_conversation_browser_pass","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"conversationId":"chat_example","profileId":"agent_example","attachments":[],"runtimeReady":true}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[],"accountDelegation":[]}],"x-symposium-scope":"browser_passes:read","description":"Requires separate account delegation and workspace authority belonging to the same user, plus current target profile/chat access. Reuses the UI grant lifecycle; never executes browser actions. Workspace key additionally requires workspace:read. Account key requires browser_passes:delegate. Neither credential alone is sufficient. Read/full permission cannot exceed the underlying Pass. Detach revokes only this conversation; already-dispatched actions may finish. Grants expire after 30 days. Reattaching creates a new generation; stale handles must not revive. To use attached Passes, send a message with both credentials. Ordinary workspace-only messages gain no personal browser authority.","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1/workspaces/{workspace_id}","variables":{"workspace_id":{"default":"workspace-id"}}}],"x-account-scopes":["browser_passes:delegate"],"x-workspace-scopes":["workspace:read","browser_passes:read"]},"post":{"summary":"Attach conversation browser Pass","operationId":"attach_conversation_browser_pass","x-symposium-realtime-signal-id":"attach_conversation_browser_pass","responses":{"200":{"description":"Success"},"201":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true,"attachment":{"id":"attachment_example","scope":"read"}}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[],"accountDelegation":[]}],"x-symposium-scope":"browser_passes:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"device_id":{"type":"string"},"pass_id":{"type":"string"},"scope":{"type":"string","enum":["read","full"]}},"required":["device_id","pass_id","scope"],"additionalProperties":false},"example":{"device_id":"11111111-1111-4111-8111-111111111111","pass_id":"11111111-1111-4111-8111-111111111111","scope":"read"}}}},"description":"Requires separate account delegation and workspace authority belonging to the same user, plus current target profile/chat access. Reuses the UI grant lifecycle; never executes browser actions. Workspace key additionally requires workspace:read. Account key requires browser_passes:delegate. Neither credential alone is sufficient. Read/full permission cannot exceed the underlying Pass. Detach revokes only this conversation; already-dispatched actions may finish. Grants expire after 30 days. Reattaching creates a new generation; stale handles must not revive. To use attached Passes, send a message with both credentials. Ordinary workspace-only messages gain no personal browser authority.","parameters":[{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1/workspaces/{workspace_id}","variables":{"workspace_id":{"default":"workspace-id"}}}],"x-account-scopes":["browser_passes:delegate"],"x-workspace-scopes":["workspace:read","browser_passes:write"]}},"/agents/{agent_id}/chats/{chat_id}/browser-passes/{attachment_id}":{"patch":{"summary":"Permission conversation browser Pass","operationId":"permission_conversation_browser_pass","x-symposium-realtime-signal-id":"permission_conversation_browser_pass","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[],"accountDelegation":[]}],"x-symposium-scope":"browser_passes:write","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scope":{"type":"string","enum":["read","full"]}},"required":["scope"],"additionalProperties":false},"example":{"scope":"full"}}}},"description":"Requires separate account delegation and workspace authority belonging to the same user, plus current target profile/chat access. Reuses the UI grant lifecycle; never executes browser actions. Workspace key additionally requires workspace:read. Account key requires browser_passes:delegate. Neither credential alone is sufficient. Read/full permission cannot exceed the underlying Pass. Detach revokes only this conversation; already-dispatched actions may finish. Grants expire after 30 days. Reattaching creates a new generation; stale handles must not revive. To use attached Passes, send a message with both credentials. Ordinary workspace-only messages gain no personal browser authority.","parameters":[{"name":"attachment_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1/workspaces/{workspace_id}","variables":{"workspace_id":{"default":"workspace-id"}}}],"x-account-scopes":["browser_passes:delegate"],"x-workspace-scopes":["workspace:read","browser_passes:write"]},"delete":{"summary":"Detach conversation browser Pass","operationId":"detach_conversation_browser_pass","x-symposium-realtime-signal-id":"detach_conversation_browser_pass","responses":{"200":{"description":"Success; inspect mutation receipt status","content":{"application/json":{"schema":{"type":"object"},"example":{"ok":true}}}},"400":{"description":"Invalid request"},"401":{"description":"Invalid or revoked credential"},"403":{"description":"Insufficient live access"},"404":{"description":"Resource not found"},"429":{"description":"Rate limited"}},"security":[{"bearerAuth":[],"accountDelegation":[]}],"x-symposium-scope":"browser_passes:write","description":"Requires separate account delegation and workspace authority belonging to the same user, plus current target profile/chat access. Reuses the UI grant lifecycle; never executes browser actions. Workspace key additionally requires workspace:read. Account key requires browser_passes:delegate. Neither credential alone is sufficient. Read/full permission cannot exceed the underlying Pass. Detach revokes only this conversation; already-dispatched actions may finish. Grants expire after 30 days. Reattaching creates a new generation; stale handles must not revive. To use attached Passes, send a message with both credentials. Ordinary workspace-only messages gain no personal browser authority.","parameters":[{"name":"attachment_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"agent_id","in":"path","required":true,"schema":{"type":"string"}},{"name":"chat_id","in":"path","required":true,"schema":{"type":"string"}}],"servers":[{"url":"https://app.sym.so/v1/workspaces/{workspace_id}","variables":{"workspace_id":{"default":"workspace-id"}}}],"x-account-scopes":["browser_passes:delegate"],"x-workspace-scopes":["workspace:read","browser_passes:write"]}}},"x-symposium-chat-runtime-controls":{"conversationReset":{"supported":true,"operationId":"send_agent_message","content":"/new","target":"exact agent_id + chat_id current session binding","successMeaning":"message durably queued and dispatched; runtime acknowledgement is not guaranteed"},"createChat":{"runtimeRestart":false,"note":"Creating a chat does not restart the profile runtime or Agent Gateway."},"archiveChat":{"runtimeControl":false,"note":"Archiving preserves history and does not reset or terminate the runtime."},"agentSettings":{"writableFields":["approval_mode"],"runtimeControl":false},"unsupportedOperations":["first-class chat reset acknowledgement","session binding rotation/rebind","chat runtime restart","profile Agent Gateway restart","tmux/session kill","force new runtime"]},"x-symposium-realtime-signals":{"eventType":"workspace.api.invoked","subscription":{"type":"subscribe","topics":["workspace.api.invoked"]},"delivery":"ephemeral_best_effort","emittedFor":"successful_authorized_invocations","payloadFields":["v","type","workspace_id","signal_id","request_id"]},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"Workspace API key or OAuth access token"},"accountBearer":{"type":"http","scheme":"bearer","description":"Account API key sym_ac_; workspace-only credentials rejected"},"accountDelegation":{"type":"apiKey","in":"header","name":"X-Sym-Account-Authorization","description":"Bearer account API key with browser_passes:delegate; same owner as workspace bearer"}},"schemas":{"WorkspaceApiKey":{"type":"object","required":["id","name","prefix","last_four","scopes","created_at","use_count"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"prefix":{"type":"string"},"last_four":{"type":"string"},"scopes":{"type":"array","items":{"type":"string"}},"created_at":{"type":["string","null"],"format":"date-time"},"expires_at":{"type":["string","null"],"format":"date-time"},"revoked_at":{"type":["string","null"],"format":"date-time"},"last_used_at":{"type":["string","null"],"format":"date-time"},"use_count":{"type":"integer","minimum":0}}},"WorkspaceApiKeyCreate":{"type":"object","required":["name","scopes"],"properties":{"name":{"type":"string","maxLength":80},"scopes":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string"}},"expires_at":{"type":["string","null"],"format":"date-time"}}},"AgentRuntimeSettings":{"type":"object","required":["profile_id","approval_mode","can_manage"],"properties":{"profile_id":{"type":"string"},"hermes_profile":{"type":"string"},"approval_mode":{"type":"string","enum":["manual","smart","off"],"description":"Persistent Hermes command-approval mode. off is Full access in SYM-OS."},"can_manage":{"type":"boolean"},"config_present":{"type":"boolean"},"changed":{"type":"boolean"}}},"AgentRuntimeSettingsUpdate":{"type":"object","required":["approval_mode"],"additionalProperties":false,"properties":{"approval_mode":{"type":"string","enum":["manual","smart","off"]}}},"AgentChatCreate":{"type":"object","properties":{"chat_id":{"type":"string"},"title":{"type":"string"},"session_id":{"type":"string"},"initial_message":{"type":"string","description":"Optional first user message. Creating a chat does not restart the Agent Gateway or guarantee a fresh profile runtime."}}},"AgentMessageCreate":{"type":"object","required":["content"],"properties":{"content":{"type":"string","description":"User-authored message. Hermes slash commands are preserved exactly. Use /new to request a reset of this chat's current Hermes conversation."},"client_message_id":{"type":"string","description":"Stable client-generated message ID for deduplication."},"attachments":{"type":"array","items":{"type":"object"}}}}}}}