{"openapi":"3.1.0","info":{"title":"Zeriq Teams API","summary":"Your AI teammates — knowledge, rooms, action items and meetings — from your own systems.","version":"1.0.0"},"servers":[{"url":"https://api.zeriq.app","description":"Production"},{"url":"https://api.qa.zeriq.app","description":"QA"}],"paths":{"/v1/me":{"get":{"tags":["account"],"summary":"The org and API key this request is authenticated as","operationId":"me_v1_me_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Me"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"ApiKey":[]}]}},"/v1/knowledge/documents":{"post":{"tags":["knowledge"],"summary":"Add or upsert a document","description":"Upload a file (multipart), or send JSON with `text` + `title` or a `url`. It's searchable once\n`status` is `ready`. With an `external_id` that already exists, this replaces that document.","operationId":"create_document_v1_knowledge_documents_post","security":[{"ApiKey":[]}],"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateDocument"}},"multipart/form-data":{"schema":{"type":"object","required":["file"],"properties":{"file":{"type":"string","format":"binary","description":"Up to 25 MB (PDF, DOCX, text, Markdown, HTML)."},"title":{"type":"string"},"external_id":{"type":"string","maxLength":255},"room_id":{"type":"string"},"metadata":{"type":"string","description":"A JSON object, as a string."}}}}}}},"get":{"tags":["knowledge"],"summary":"List documents","description":"Newest first. Room documents are included only for rooms you can use.","operationId":"list_documents_v1_knowledge_documents_get","security":[{"ApiKey":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}},{"name":"external_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"}},{"name":"room_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Room Id"}},{"name":"source","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentList"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/knowledge/documents/{document_id}":{"get":{"tags":["knowledge"],"summary":"Get a document","operationId":"get_document_v1_knowledge_documents__document_id__get","security":[{"ApiKey":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Document"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["knowledge"],"summary":"Delete a document","operationId":"delete_document_v1_knowledge_documents__document_id__delete","security":[{"ApiKey":[]}],"parameters":[{"name":"document_id","in":"path","required":true,"schema":{"type":"string","title":"Document Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Deleted"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/knowledge/search":{"post":{"tags":["knowledge"],"summary":"Search knowledge (no AI model, no credits)","description":"The most relevant passages from your workspace's knowledge, best first.","operationId":"search_v1_knowledge_search_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/personas":{"get":{"tags":["personas"],"summary":"List AI teammates","operationId":"list_personas_v1_personas_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PersonaList"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"ApiKey":[]}]}},"/v1/personas/{persona_id}":{"get":{"tags":["personas"],"summary":"Get an AI teammate","operationId":"get_persona_v1_personas__persona_id__get","security":[{"ApiKey":[]}],"parameters":[{"name":"persona_id","in":"path","required":true,"schema":{"type":"string","title":"Persona Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Persona"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/personas/{persona_id}/ask":{"post":{"tags":["personas"],"summary":"Ask an AI teammate","description":"One answer from the teammate, grounded in your knowledge, with citations and usage.","operationId":"ask_v1_personas__persona_id__ask_post","security":[{"ApiKey":[]}],"parameters":[{"name":"persona_id","in":"path","required":true,"schema":{"type":"string","title":"Persona Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AskRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Answer"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations":{"get":{"tags":["personas","conversations"],"summary":"List this key's conversations","operationId":"list_conversations_v1_conversations_get","security":[{"ApiKey":[]}],"parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":50,"minimum":1,"default":20,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationList"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/conversations/{conversation_id}":{"get":{"tags":["personas","conversations"],"summary":"Get a conversation with its messages","operationId":"get_conversation_v1_conversations__conversation_id__get","security":[{"ApiKey":[]}],"parameters":[{"name":"conversation_id","in":"path","required":true,"schema":{"type":"string","title":"Conversation Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConversationDetail"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rooms":{"post":{"tags":["rooms"],"summary":"Create a room","description":"A room run by this API key with the AI teammates you choose, and optionally people from your\nworkspace. With `first_message`, the teammates start replying. Anyone who isn't a current member\nis rejected with `400 not_an_org_member`.","operationId":"create_room_v1_rooms_post","security":[{"ApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateRoom"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Room"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["rooms"],"summary":"List rooms","description":"Rooms this key created (all rooms with `rooms:read:all`), newest first.","operationId":"list_rooms_v1_rooms_get","security":[{"ApiKey":[]}],"parameters":[{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"enum":["active","scheduled","ended","archived"],"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":20,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RoomList"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rooms/{room_id}":{"get":{"tags":["rooms"],"summary":"Get a room","operationId":"get_room_v1_rooms__room_id__get","security":[{"ApiKey":[]}],"parameters":[{"name":"room_id","in":"path","required":true,"schema":{"type":"string","title":"Room Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Room"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rooms/{room_id}/messages":{"post":{"tags":["rooms"],"summary":"Post a message","description":"Posted as this API key. The room's AI teammates reply in the background: stream them with\n`GET /rooms/{id}/events?run_id=<run_id>`, or poll `GET /rooms/{id}/messages?after=`.","operationId":"post_message_v1_rooms__room_id__messages_post","security":[{"ApiKey":[]}],"parameters":[{"name":"room_id","in":"path","required":true,"schema":{"type":"string","title":"Room Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostMessage"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostedMessage"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"get":{"tags":["rooms"],"summary":"List messages","operationId":"list_messages_v1_rooms__room_id__messages_get","security":[{"ApiKey":[]}],"parameters":[{"name":"room_id","in":"path","required":true,"schema":{"type":"string","title":"Room Id"}},{"name":"after","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only messages after this message id (`msg_…`).","title":"After"},"description":"Only messages after this message id (`msg_…`)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MessageList"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rooms/{room_id}/events":{"get":{"tags":["rooms"],"summary":"Stream room events","description":"Live events for a room you can read:\n\n- `persona.thinking`: which AI teammates are working on a reply\n- `message.created`: a message from a person, an AI teammate or an API key\n- `run.completed` / `run.failed`: a reply run finished\n\nWith `run_id` it replays that run from the start, then ends when the run does. Without it, it streams\nlive; after `Last-Event-ID` it first replays what you missed. A `: keep-alive` comment comes every 15\nseconds, and a stream closes after 10 minutes (reconnect with `Last-Event-ID`).","operationId":"room_events_v1_rooms__room_id__events_get","security":[{"ApiKey":[]}],"parameters":[{"name":"room_id","in":"path","required":true,"schema":{"type":"string","title":"Room Id"}},{"name":"run_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Only this reply run's events; the stream ends when the run does.","title":"Run Id"},"description":"Only this reply run's events; the stream ends when the run does."},{"name":"Last-Event-ID","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Resume after this event (browsers and the SDKs send it on reconnect).","title":"Last-Event-Id"},"description":"Resume after this event (browsers and the SDKs send it on reconnect)."}],"responses":{"200":{"description":"Server-sent events (`text/event-stream`). Each event has `id:` (an `evt_…`), `event:` and JSON `data:`.","content":{"text/event-stream":{"schema":{"type":"string"},"example":"id: evt_…\nevent: message.created\ndata: {\"type\":\"message.created\",\"room_id\":\"room_…\",\"run_id\":\"run_…\",\"message\":{…}}\n\n"}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rooms/{room_id}/end":{"post":{"tags":["rooms"],"summary":"End a room","description":"Ends it; a title, summary and action items follow in the background.","operationId":"end_room_v1_rooms__room_id__end_post","security":[{"ApiKey":[]}],"parameters":[{"name":"room_id","in":"path","required":true,"schema":{"type":"string","title":"Room Id"}}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/EndRoom"},{"type":"null"}],"title":"Req"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Room"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rooms/{room_id}/summarize":{"post":{"tags":["rooms"],"summary":"Summarize a room","operationId":"summarize_v1_rooms__room_id__summarize_post","security":[{"ApiKey":[]}],"parameters":[{"name":"room_id","in":"path","required":true,"schema":{"type":"string","title":"Room Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Room"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/rooms/{room_id}/reports":{"post":{"tags":["rooms"],"summary":"Generate a report","operationId":"report_v1_rooms__room_id__reports_post","security":[{"ApiKey":[]}],"parameters":[{"name":"room_id","in":"path","required":true,"schema":{"type":"string","title":"Room Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Report"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/action-items":{"get":{"tags":["action items"],"summary":"List action items","description":"Across every room you can read, newest first.","operationId":"list_action_items_v1_action_items_get","security":[{"ApiKey":[]}],"parameters":[{"name":"room_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Room Id"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"enum":["open","done"],"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"assignee","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assignee"}},{"name":"since","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"Created at or after this time (ISO 8601).","title":"Since"},"description":"Created at or after this time (ISO 8601)."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionItemList"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"post":{"tags":["action items"],"summary":"Create an action item","operationId":"create_action_item_v1_action_items_post","security":[{"ApiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateActionItem"}}}},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionItem"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/action-items/{item_id}":{"patch":{"tags":["action items"],"summary":"Update an action item","description":"Mark it done or open, and/or link where it's tracked (`external_ref`).","operationId":"update_action_item_v1_action_items__item_id__patch","security":[{"ApiKey":[]}],"parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"string","title":"Item Id"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateActionItem"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActionItem"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/meetings/bots":{"get":{"tags":["meetings"],"summary":"List meeting bots","operationId":"list_bots_v1_meetings_bots_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BotList"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"ApiKey":[]}]}},"/v1/meetings/bots/{bot_id}":{"get":{"tags":["meetings"],"summary":"Get a meeting bot","operationId":"get_bot_v1_meetings_bots__bot_id__get","security":[{"ApiKey":[]}],"parameters":[{"name":"bot_id","in":"path","required":true,"schema":{"type":"string","title":"Bot Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Bot"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/meetings/bots/{bot_id}/transcript":{"get":{"tags":["meetings"],"summary":"Get a transcript","operationId":"transcript_v1_meetings_bots__bot_id__transcript_get","security":[{"ApiKey":[]}],"parameters":[{"name":"bot_id","in":"path","required":true,"schema":{"type":"string","title":"Bot Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transcript"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/meetings/bots/{bot_id}/report":{"get":{"tags":["meetings"],"summary":"Get a meeting report","operationId":"meeting_report_v1_meetings_bots__bot_id__report_get","security":[{"ApiKey":[]}],"parameters":[{"name":"bot_id","in":"path","required":true,"schema":{"type":"string","title":"Bot Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MeetingReport"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/event-types":{"get":{"tags":["webhooks"],"summary":"List event types","operationId":"list_event_types_v1_webhooks_event_types_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EventTypeList"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"ApiKey":[]}]}},"/v1/webhooks/endpoints":{"get":{"tags":["webhooks"],"summary":"List webhook endpoints","operationId":"list_endpoints_v1_webhooks_endpoints_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointList"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}},"security":[{"ApiKey":[]}]},"post":{"tags":["webhooks"],"summary":"Create a webhook endpoint","description":"The response is the only time the signing secret is shown.","operationId":"create_endpoint_v1_webhooks_endpoints_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookEndpoint"}}},"required":true},"responses":{"201":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecret"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}},"security":[{"ApiKey":[]}]}},"/v1/webhooks/endpoints/{endpoint}":{"get":{"tags":["webhooks"],"summary":"Get a webhook endpoint","operationId":"get_endpoint_v1_webhooks_endpoints__endpoint__get","security":[{"ApiKey":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string","title":"Endpoint"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"patch":{"tags":["webhooks"],"summary":"Update a webhook endpoint","description":"Change the URL or events, or turn it off and on (`status`).","operationId":"update_endpoint_v1_webhooks_endpoints__endpoint__patch","security":[{"ApiKey":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string","title":"Endpoint"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookEndpoint"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpoint"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"tags":["webhooks"],"summary":"Delete a webhook endpoint","operationId":"delete_endpoint_v1_webhooks_endpoints__endpoint__delete","security":[{"ApiKey":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string","title":"Endpoint"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeletedWebhookEndpoint"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/endpoints/{endpoint}/rotate-secret":{"post":{"tags":["webhooks"],"summary":"Rotate an endpoint's signing secret","description":"A new secret, shown only now. For 24 hours deliveries are signed with both.","operationId":"rotate_secret_v1_webhooks_endpoints__endpoint__rotate_secret_post","security":[{"ApiKey":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string","title":"Endpoint"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookEndpointWithSecret"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/endpoints/{endpoint}/test":{"post":{"tags":["webhooks"],"summary":"Send a test event","description":"Sends a `webhook.test` event right away and returns the result (not retried).","operationId":"send_test_v1_webhooks_endpoints__endpoint__test_post","security":[{"ApiKey":[]}],"parameters":[{"name":"endpoint","in":"path","required":true,"schema":{"type":"string","title":"Endpoint"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDelivery"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/deliveries":{"get":{"tags":["webhooks"],"summary":"List deliveries","description":"Newest first.","operationId":"list_deliveries_v1_webhooks_deliveries_get","security":[{"ApiKey":[]}],"parameters":[{"name":"endpoint_id","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint Id"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"enum":["pending","succeeded","failed","skipped"],"type":"string"},{"type":"null"}],"title":"Status"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Limit"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cursor"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryList"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/webhooks/deliveries/{delivery}/redeliver":{"post":{"tags":["webhooks"],"summary":"Send a delivery again","description":"A fresh round of attempts, e.g. after you've fixed your endpoint.","operationId":"redeliver_v1_webhooks_deliveries__delivery__redeliver_post","security":[{"ApiKey":[]}],"parameters":[{"name":"delivery","in":"path","required":true,"schema":{"type":"string","title":"Delivery"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDelivery"}}}},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}},"description":"Too Many Requests"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"ActionItem":{"properties":{"id":{"type":"string","title":"Id","examples":["ai_51d2…"]},"object":{"type":"string","enum":["action_item"],"const":"action_item","title":"Object","default":"action_item"},"room_id":{"type":"string","title":"Room Id"},"title":{"type":"string","title":"Title"},"assignee":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Assignee"},"status":{"anyOf":[{"type":"string","enum":["open","done"]},{"type":"string"}],"title":"Status"},"external_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Ref","description":"Where it's tracked elsewhere, e.g. a PR or ticket URL."},"created_by":{"type":"string","title":"Created By"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","room_id","title","status","created_by","created_at"],"title":"ActionItem"},"ActionItemList":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/ActionItem"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["data"],"title":"ActionItemList"},"Actor":{"properties":{"type":{"type":"string","enum":["user","persona","api_key","system"],"title":"Type"},"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id"},"name":{"type":"string","title":"Name"}},"type":"object","required":["type","name"],"title":"Actor"},"Answer":{"properties":{"object":{"type":"string","enum":["answer"],"const":"answer","title":"Object","default":"answer"},"answer":{"type":"string","title":"Answer"},"citations":{"items":{"$ref":"#/components/schemas/Citation"},"type":"array","title":"Citations"},"tools_used":{"items":{"type":"string"},"type":"array","title":"Tools Used"},"conversation_id":{"type":"string","title":"Conversation Id"},"usage":{"$ref":"#/components/schemas/Usage"}},"type":"object","required":["answer","citations","tools_used","conversation_id","usage"],"title":"Answer"},"AskRequest":{"properties":{"input":{"type":"string","maxLength":20000,"minLength":1,"title":"Input","description":"Your question or instruction."},"conversation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Conversation Id","description":"Continue a conversation this key started."},"use_knowledge":{"type":"boolean","title":"Use Knowledge","description":"Search your workspace's knowledge for context.","default":true},"tools":{"type":"string","enum":["none","read_only","allowed"],"title":"Tools","description":"What the teammate may use; see above.","default":"none"},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"A model id from your plan; defaults to the free model."},"allow_downgrade":{"type":"boolean","title":"Allow Downgrade","description":"Use the free model instead of failing when credits run out.","default":false}},"type":"object","required":["input"],"title":"AskRequest"},"Bot":{"properties":{"id":{"type":"string","title":"Id"},"object":{"type":"string","enum":["meeting_bot"],"const":"meeting_bot","title":"Object","default":"meeting_bot"},"persona_name":{"type":"string","title":"Persona Name"},"meeting_url":{"type":"string","title":"Meeting Url"},"status":{"type":"string","title":"Status"},"theme":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Theme"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","persona_name","meeting_url","status","created_at"],"title":"Bot"},"BotList":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/Bot"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"BotList"},"Citation":{"properties":{"document_id":{"type":"string","title":"Document Id"},"chunk_id":{"type":"string","title":"Chunk Id"},"title":{"type":"string","title":"Title"},"snippet":{"type":"string","title":"Snippet"},"score":{"type":"number","title":"Score"},"source":{"type":"string","title":"Source"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"}},"type":"object","required":["document_id","chunk_id","title","snippet","score","source"],"title":"Citation"},"Conversation":{"properties":{"id":{"type":"string","title":"Id"},"object":{"type":"string","enum":["conversation"],"const":"conversation","title":"Object","default":"conversation"},"title":{"type":"string","title":"Title"},"persona_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","title","created_at"],"title":"Conversation"},"ConversationDetail":{"properties":{"id":{"type":"string","title":"Id"},"object":{"type":"string","enum":["conversation"],"const":"conversation","title":"Object","default":"conversation"},"title":{"type":"string","title":"Title"},"persona_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Persona Id"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"},"messages":{"items":{"$ref":"#/components/schemas/ConversationMessage"},"type":"array","title":"Messages"}},"type":"object","required":["id","title","created_at","messages"],"title":"ConversationDetail"},"ConversationList":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/Conversation"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"ConversationList"},"ConversationMessage":{"properties":{"role":{"type":"string","title":"Role"},"content":{"type":"string","title":"Content"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["role","content","created_at"],"title":"ConversationMessage"},"CreateActionItem":{"properties":{"room_id":{"type":"string","title":"Room Id"},"title":{"type":"string","maxLength":512,"minLength":1,"title":"Title"},"assignee":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Assignee"},"external_ref":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"External Ref"}},"type":"object","required":["room_id","title"],"title":"CreateActionItem"},"CreateRoom":{"properties":{"title":{"type":"string","maxLength":255,"minLength":1,"title":"Title"},"topic":{"anyOf":[{"type":"string","maxLength":5000},{"type":"null"}],"title":"Topic"},"personas":{"items":{"type":"string"},"type":"array","title":"Personas","description":"Persona ids (`prs_…`), up to 6."},"first_message":{"anyOf":[{"type":"string","maxLength":20000},{"type":"null"}],"title":"First Message","description":"Posted right away; the personas reply."},"model":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model","description":"Model for the personas' replies; defaults to the free model."},"members":{"items":{"$ref":"#/components/schemas/MemberRef"},"type":"array","maxItems":50,"title":"Members","description":"People to add: current workspace members only."},"host":{"anyOf":[{"$ref":"#/components/schemas/MemberRef"},{"type":"null"}],"description":"A member who can also manage and end the room in the web app."},"notify":{"type":"string","enum":["email","none"],"title":"Notify","description":"Email the people you add an invite.","default":"email"}},"type":"object","required":["title"],"title":"CreateRoom"},"CreateWebhookEndpoint":{"properties":{"url":{"type":"string","maxLength":2048,"title":"Url","description":"https, on a public host."},"description":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Description"},"event_types":{"items":{"type":"string","enum":["document.ready","document.failed","room.created","room.message.created","room.ended","room.summary.ready","room.report.ready","action_item.created","action_item.updated","meeting.bot.status_changed","meeting.report.ready","credits.low"]},"type":"array","title":"Event Types","description":"Empty means every event."}},"type":"object","required":["url"],"title":"CreateWebhookEndpoint"},"Deleted":{"properties":{"id":{"type":"string","title":"Id"},"object":{"type":"string","enum":["document"],"const":"document","title":"Object","default":"document"},"deleted":{"type":"boolean","enum":[true],"const":true,"title":"Deleted","default":true}},"type":"object","required":["id"],"title":"Deleted"},"DeletedWebhookEndpoint":{"properties":{"id":{"type":"string","title":"Id"},"object":{"type":"string","enum":["webhook_endpoint"],"const":"webhook_endpoint","title":"Object","default":"webhook_endpoint"},"deleted":{"type":"boolean","enum":[true],"const":true,"title":"Deleted","default":true}},"type":"object","required":["id"],"title":"DeletedWebhookEndpoint"},"Document":{"properties":{"id":{"type":"string","title":"Id","examples":["doc_3f1c…"]},"object":{"type":"string","enum":["document"],"const":"document","title":"Object","default":"document"},"title":{"type":"string","title":"Title"},"mime_type":{"type":"string","title":"Mime Type"},"size_bytes":{"type":"integer","title":"Size Bytes"},"status":{"type":"string","enum":["processing","ready","empty","failed"],"title":"Status","description":"`processing` until it's searchable; `empty` if no text was found."},"source":{"type":"string","title":"Source","description":"`upload` for files, URLs and text; otherwise the integration it was synced from."},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id","description":"Your own id for this document (unique in the workspace)."},"replacing":{"type":"boolean","title":"Replacing","description":"True while this new version waits to replace the one with the same external_id.","default":false},"room_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Room Id","description":"Set when the document belongs to one room."},"metadata":{"anyOf":[{"type":"object"},{"type":"null"}],"title":"Metadata"},"chunk_count":{"type":"integer","title":"Chunk Count"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","title","mime_type","size_bytes","status","source","chunk_count","created_at"],"title":"Document"},"DocumentList":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/Document"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor","description":"Pass as `cursor` for the next page; null on the last page."}},"type":"object","required":["data"],"title":"DocumentList"},"EndRoom":{"properties":{"outcome":{"anyOf":[{"type":"string","enum":["success","followup","failure","cancelled"]},{"type":"null"}],"title":"Outcome"}},"type":"object","title":"EndRoom"},"ErrorBody":{"properties":{"type":{"type":"string","title":"Type"},"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"},"param":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Param"},"request_id":{"type":"string","title":"Request Id"}},"type":"object","required":["type","code","message","request_id"],"title":"ErrorBody"},"ErrorEnvelope":{"properties":{"error":{"$ref":"#/components/schemas/ErrorBody"}},"type":"object","required":["error"],"title":"ErrorEnvelope","description":"Every /v1 error looks like this."},"EventTypeInfo":{"properties":{"type":{"type":"string","title":"Type"},"description":{"type":"string","title":"Description"}},"type":"object","required":["type","description"],"title":"EventTypeInfo"},"EventTypeList":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/EventTypeInfo"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"EventTypeList"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Me":{"properties":{"org_id":{"type":"string","title":"Org Id"},"api_key_id":{"type":"string","title":"Api Key Id"},"scopes":{"items":{"type":"string"},"type":"array","title":"Scopes"},"tool_access":{"type":"string","title":"Tool Access"}},"type":"object","required":["org_id","api_key_id","scopes","tool_access"],"title":"Me"},"MeetingReport":{"properties":{"object":{"type":"string","enum":["meeting_report"],"const":"meeting_report","title":"Object","default":"meeting_report"},"bot_id":{"type":"string","title":"Bot Id"},"theme":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Theme"},"content":{"type":"string","title":"Content"},"generated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Generated At"}},"type":"object","required":["bot_id","content"],"title":"MeetingReport"},"MemberRef":{"properties":{"email":{"anyOf":[{"type":"string","maxLength":320},{"type":"null"}],"title":"Email"},"member_id":{"anyOf":[{"type":"string","maxLength":128},{"type":"null"}],"title":"Member Id"}},"type":"object","title":"MemberRef","description":"A current member of the workspace: exactly one of `email` or `member_id`."},"Message":{"properties":{"id":{"type":"string","title":"Id"},"object":{"type":"string","enum":["message"],"const":"message","title":"Object","default":"message"},"room_id":{"type":"string","title":"Room Id"},"type":{"anyOf":[{"type":"string","enum":["human","ai","system"]},{"type":"string"}],"title":"Type"},"sender":{"$ref":"#/components/schemas/Actor"},"content":{"type":"string","title":"Content"},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","room_id","type","sender","content","created_at"],"title":"Message"},"MessageList":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/Message"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"MessageList"},"Participant":{"properties":{"member_id":{"type":"string","title":"Member Id"},"name":{"type":"string","title":"Name"},"role":{"anyOf":[{"type":"string","enum":["host","member"]},{"type":"string"}],"title":"Role"}},"type":"object","required":["member_id","name","role"],"title":"Participant"},"Persona":{"properties":{"id":{"type":"string","title":"Id","examples":["prs_8sKq…"]},"object":{"type":"string","enum":["persona"],"const":"persona","title":"Object","default":"persona"},"name":{"type":"string","title":"Name"},"role":{"type":"string","title":"Role"},"description":{"type":"string","title":"Description"},"avatar_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Avatar Url"}},"type":"object","required":["id","name","role","description"],"title":"Persona"},"PersonaList":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/Persona"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"PersonaList"},"PostMessage":{"properties":{"content":{"type":"string","maxLength":20000,"minLength":1,"title":"Content"}},"additionalProperties":false,"type":"object","required":["content"],"title":"PostMessage","description":"Always posted as this API key: there's no way to post as a member."},"PostedMessage":{"properties":{"id":{"type":"string","title":"Id"},"object":{"type":"string","enum":["message"],"const":"message","title":"Object","default":"message"},"room_id":{"type":"string","title":"Room Id"},"type":{"anyOf":[{"type":"string","enum":["human","ai","system"]},{"type":"string"}],"title":"Type"},"sender":{"$ref":"#/components/schemas/Actor"},"content":{"type":"string","title":"Content"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id","description":"The AI teammates' reply run, when they'll answer: stream it with `GET /rooms/{id}/events?run_id=`."}},"type":"object","required":["id","room_id","type","sender","content","created_at"],"title":"PostedMessage"},"Report":{"properties":{"object":{"type":"string","enum":["report"],"const":"report","title":"Object","default":"report"},"type":{"type":"string","title":"Type"},"content":{"type":"string","title":"Content"},"document_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Document Id","description":"Set when it was saved to the knowledge base."}},"type":"object","required":["type","content"],"title":"Report"},"ReportRequest":{"properties":{"type":{"type":"string","enum":["summary","plan","pitch","security","funding"],"title":"Type","default":"summary"},"save_to_knowledge":{"type":"boolean","title":"Save To Knowledge","description":"Also add the report to your knowledge base.","default":false}},"type":"object","title":"ReportRequest"},"Room":{"properties":{"id":{"type":"string","title":"Id","examples":["room_7b0e…"]},"object":{"type":"string","enum":["room"],"const":"room","title":"Object","default":"room"},"title":{"type":"string","title":"Title"},"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Topic"},"status":{"anyOf":[{"type":"string","enum":["active","scheduled","ended","archived"]},{"type":"string"}],"title":"Status"},"outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Outcome"},"summary":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Summary"},"action_plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Action Plan"},"created_by":{"$ref":"#/components/schemas/Actor"},"participants":{"items":{"$ref":"#/components/schemas/Participant"},"type":"array","title":"Participants"},"personas":{"items":{"$ref":"#/components/schemas/RoomPersona"},"type":"array","title":"Personas"},"message_count":{"type":"integer","title":"Message Count"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"ended_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Ended At"}},"type":"object","required":["id","title","status","created_by","participants","personas","message_count","created_at"],"title":"Room"},"RoomList":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/Room"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["data"],"title":"RoomList"},"RoomPersona":{"properties":{"id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Id","description":"Null for one-off guest experts added in the web app."},"name":{"type":"string","title":"Name"},"role":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Role"}},"type":"object","required":["name"],"title":"RoomPersona"},"SearchRequest":{"properties":{"query":{"type":"string","maxLength":2000,"minLength":1,"title":"Query"},"top_k":{"type":"integer","maximum":20.0,"minimum":1.0,"title":"Top K","default":5},"room_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Room Id","description":"Also search this room's documents."},"sources":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Sources","description":"Only these sources, e.g. `[\"upload\", \"jira\"]`."}},"type":"object","required":["query"],"title":"SearchRequest"},"SearchResponse":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/SearchResult"},"type":"array","title":"Data"}},"type":"object","required":["data"],"title":"SearchResponse"},"SearchResult":{"properties":{"chunk_id":{"type":"string","title":"Chunk Id"},"document_id":{"type":"string","title":"Document Id"},"title":{"type":"string","title":"Title"},"content":{"type":"string","title":"Content"},"score":{"type":"number","title":"Score","description":"Similarity, 0–1."},"source":{"type":"string","title":"Source"},"source_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Url"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"}},"type":"object","required":["chunk_id","document_id","title","content","score","source"],"title":"SearchResult"},"Transcript":{"properties":{"object":{"type":"string","enum":["transcript"],"const":"transcript","title":"Object","default":"transcript"},"bot_id":{"type":"string","title":"Bot Id"},"data":{"items":{"$ref":"#/components/schemas/TranscriptLine"},"type":"array","title":"Data"}},"type":"object","required":["bot_id","data"],"title":"Transcript"},"TranscriptLine":{"properties":{"speaker":{"type":"string","title":"Speaker"},"text":{"type":"string","title":"Text"},"timestamp":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Timestamp"}},"type":"object","required":["speaker","text"],"title":"TranscriptLine"},"UpdateActionItem":{"properties":{"status":{"anyOf":[{"type":"string","enum":["open","done"]},{"type":"null"}],"title":"Status"},"external_ref":{"anyOf":[{"type":"string","maxLength":1024},{"type":"null"}],"title":"External Ref","description":"Set to an empty string to clear it."}},"type":"object","title":"UpdateActionItem"},"UpdateWebhookEndpoint":{"properties":{"url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Url"},"description":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"title":"Description"},"event_types":{"anyOf":[{"items":{"type":"string","enum":["document.ready","document.failed","room.created","room.message.created","room.ended","room.summary.ready","room.report.ready","action_item.created","action_item.updated","meeting.bot.status_changed","meeting.report.ready","credits.low"]},"type":"array"},{"type":"null"}],"title":"Event Types"},"status":{"anyOf":[{"type":"string","enum":["active","disabled"]},{"type":"null"}],"title":"Status","description":"`active` turns a disabled endpoint back on."}},"type":"object","title":"UpdateWebhookEndpoint"},"Usage":{"properties":{"credits_charged":{"type":"integer","title":"Credits Charged"},"model":{"type":"string","title":"Model"},"downgraded":{"type":"boolean","title":"Downgraded","description":"True when allow_downgrade was used."}},"type":"object","required":["credits_charged","model","downgraded"],"title":"Usage"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"WebhookDelivery":{"properties":{"id":{"type":"string","title":"Id","examples":["whd_1a2b…"]},"object":{"type":"string","enum":["webhook_delivery"],"const":"webhook_delivery","title":"Object","default":"webhook_delivery"},"endpoint_id":{"type":"string","title":"Endpoint Id"},"event_id":{"type":"string","title":"Event Id"},"event_type":{"type":"string","title":"Event Type"},"status":{"type":"string","enum":["pending","succeeded","failed","skipped"],"title":"Status"},"attempts":{"type":"integer","title":"Attempts"},"last_status_code":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Status Code"},"last_response_ms":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Response Ms"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"last_response":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Response","description":"The start of your endpoint's last response body."},"next_attempt_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Next Attempt At"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At"}},"type":"object","required":["id","endpoint_id","event_id","event_type","status","attempts","created_at"],"title":"WebhookDelivery"},"WebhookDeliveryList":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/WebhookDelivery"},"type":"array","title":"Data"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["data"],"title":"WebhookDeliveryList"},"WebhookEndpoint":{"properties":{"id":{"type":"string","title":"Id","examples":["whe_9c4e…"]},"object":{"type":"string","enum":["webhook_endpoint"],"const":"webhook_endpoint","title":"Object","default":"webhook_endpoint"},"url":{"type":"string","title":"Url"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"event_types":{"items":{"type":"string"},"type":"array","title":"Event Types","description":"Event types it receives; empty means all."},"status":{"type":"string","enum":["active","disabled"],"title":"Status"},"disabled_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disabled Reason"},"failing_since":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Failing Since","description":"Deliveries have failed since then; 3 days disables it."},"previous_secret_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Previous Secret Expires At","description":"Until then the old secret also signs."},"created_at":{"type":"string","format":"date-time","title":"Created At"}},"type":"object","required":["id","url","event_types","status","created_at"],"title":"WebhookEndpoint"},"WebhookEndpointList":{"properties":{"object":{"type":"string","enum":["list"],"const":"list","title":"Object","default":"list"},"data":{"items":{"$ref":"#/components/schemas/WebhookEndpoint"},"type":"array","title":"Data"},"limit":{"type":"integer","title":"Limit","description":"How many endpoints your plan allows."}},"type":"object","required":["data","limit"],"title":"WebhookEndpointList"},"WebhookEndpointWithSecret":{"properties":{"id":{"type":"string","title":"Id","examples":["whe_9c4e…"]},"object":{"type":"string","enum":["webhook_endpoint"],"const":"webhook_endpoint","title":"Object","default":"webhook_endpoint"},"url":{"type":"string","title":"Url"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"event_types":{"items":{"type":"string"},"type":"array","title":"Event Types","description":"Event types it receives; empty means all."},"status":{"type":"string","enum":["active","disabled"],"title":"Status"},"disabled_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Disabled Reason"},"failing_since":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Failing Since","description":"Deliveries have failed since then; 3 days disables it."},"previous_secret_expires_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Previous Secret Expires At","description":"Until then the old secret also signs."},"created_at":{"type":"string","format":"date-time","title":"Created At"},"secret":{"type":"string","title":"Secret","description":"`whsec_…`: shown only now. Keep it on your server."}},"type":"object","required":["id","url","event_types","status","created_at","secret"],"title":"WebhookEndpointWithSecret"},"CreateDocument":{"description":"JSON body: exactly one of `text` (with `title`) or `url`. Files use multipart/form-data.","properties":{"text":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Plain text or Markdown, up to 5 MB.","title":"Text"},"url":{"anyOf":[{"format":"uri","maxLength":2083,"minLength":1,"type":"string"},{"type":"null"}],"default":null,"description":"A public web page to fetch.","title":"Url"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Title"},"external_id":{"anyOf":[{"maxLength":255,"type":"string"},{"type":"null"}],"default":null,"description":"Upsert: replaces your document with this id.","title":"External Id"},"room_id":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Only that room's participants (and its AI teammates) can use it.","title":"Room Id"},"metadata":{"anyOf":[{"type":"object"},{"type":"null"}],"default":null,"description":"Your own key/values, up to 16 KB.","title":"Metadata"}},"title":"CreateDocument","type":"object"}},"securitySchemes":{"ApiKey":{"type":"http","description":"A secret API key from Settings → Developers: `Authorization: Bearer zqt_sk_live_…`","scheme":"bearer"}}},"security":[{"ApiKey":[]}]}