{ "openapi": "3.1.0", "info": { "title": "Onyx API", "description": "Onyx API for AI-powered chat with search, document indexing, agents, and more", "version": "Development" }, "servers": [ { "url": "https://cloud.onyx.app/api" } ], "paths": { "/chat/get-user-chat-sessions": { "get": { "tags": [ "public" ], "summary": "Get User Chat Sessions", "operationId": "get_user_chat_sessions", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "project_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Project Id" } }, { "name": "only_non_project_chats", "in": "query", "required": false, "schema": { "type": "boolean", "default": true, "title": "Only Non Project Chats" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatSessionsResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/get-chat-session/{session_id}": { "get": { "tags": [ "public" ], "summary": "Get Chat Session", "operationId": "get_chat_session", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "title": "Session Id" } }, { "name": "is_shared", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Is Shared" } }, { "name": "include_deleted", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Include Deleted" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatSessionDetailResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/create-chat-session": { "post": { "tags": [ "public" ], "summary": "Create New Chat Session", "operationId": "create_new_chat_session", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatSessionCreationRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateChatSessionID" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/delete-all-chat-sessions": { "delete": { "tags": [ "public" ], "summary": "Delete All Chat Sessions", "operationId": "delete_all_chat_sessions", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/delete-chat-session/{session_id}": { "delete": { "tags": [ "public" ], "summary": "Delete Chat Session By Id", "operationId": "delete_chat_session_by_id", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "title": "Session Id" } }, { "name": "hard_delete", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hard Delete" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/send-message": { "post": { "tags": [ "public" ], "summary": "Handle New Chat Message", "description": "This endpoint is both used for all the following purposes:\n- Sending a new message in the session\n- Regenerating a message in the session (just send the same one again)\n- Editing a message (similar to regenerating but sending a different message)\n- Kicking off a seeded chat session (set `use_existing_user_message`)\n\nAssumes that previous messages have been set as the latest to minimize overhead.\n\nArgs:\n chat_message_req (CreateChatMessageRequest): Details about the new chat message.\n request (Request): The current HTTP request context.\n user (User | None): The current user, obtained via dependency injection.\n _ (None): Rate limit check is run if user/group/global rate limits are enabled.\n\nReturns:\n StreamingResponse: Streams the response to the new chat message.", "operationId": "handle_new_chat_message", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateChatMessageRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/send-chat-message": { "post": { "tags": [ "public" ], "summary": "Handle Send Chat Message", "description": "This endpoint is used to send a new chat message.\n\nArgs:\n chat_message_req (SendMessageRequest): Details about the new chat message.\n - When stream=True (default): Returns StreamingResponse with SSE\n - When stream=False: Returns ChatFullResponse with complete data\n request (Request): The current HTTP request context.\n user (User | None): The current user, obtained via dependency injection.\n _ (None): Rate limit check is run if user/group/global rate limits are enabled.\n\nReturns:\n StreamingResponse | ChatFullResponse: Either streams or returns complete response.", "operationId": "handle_send_chat_message", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SendMessageRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/seed-chat-session": { "post": { "tags": [ "public" ], "summary": "Seed Chat", "operationId": "seed_chat", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatSeedRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatSeedResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/file/{file_id}": { "get": { "tags": [ "public" ], "summary": "Fetch Chat File", "operationId": "fetch_chat_file", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string", "title": "File Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/search": { "get": { "tags": [ "public" ], "summary": "Search Chats", "description": "Search for chat sessions based on the provided query.\nIf no query is provided, returns recent chat sessions.", "operationId": "search_chats", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "query", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Query" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "default": 1, "title": "Page" } }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "default": 10, "title": "Page Size" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatSearchResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/stop-chat-session/{chat_session_id}": { "post": { "tags": [ "public" ], "summary": "Stop Chat Session", "description": "Stop a chat session by setting a stop signal in Redis.\nThis endpoint is called by the frontend when the user clicks the stop button.", "operationId": "stop_chat_session", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "chat_session_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "title": "Chat Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": { "type": "string" }, "title": "Response Stop Chat Session Chat Stop Chat Session Chat Session Id Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/query/document-search": { "post": { "tags": [ "public" ], "summary": "Handle Search Request", "description": "Simple search endpoint, does not create a new message or records in the DB", "operationId": "handle_search_request", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DocumentSearchRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DocumentSearchResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/set-user-role": { "patch": { "tags": [ "public" ], "summary": "Set User Role", "operationId": "set_user_role", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserRoleUpdateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/users/accepted": { "get": { "tags": [ "public" ], "summary": "List Accepted Users", "operationId": "list_accepted_users", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } }, { "name": "page_num", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Page Num" } }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "default": 10, "title": "Page Size" } }, { "name": "roles", "in": "query", "required": false, "schema": { "type": "array", "items": { "$ref": "#/components/schemas/UserRole" }, "default": [], "title": "Roles" } }, { "name": "is_active", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Active" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedReturn_FullUserSnapshot_" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/users/invited": { "get": { "tags": [ "public" ], "summary": "List Invited Users", "operationId": "list_invited_users", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/InvitedUserSnapshot" }, "title": "Response List Invited Users Manage Users Invited Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/users": { "get": { "tags": [ "public" ], "summary": "List All Users", "operationId": "list_all_users", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } }, { "name": "accepted_page", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Accepted Page" } }, { "name": "slack_users_page", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Slack Users Page" } }, { "name": "invited_page", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Invited Page" } }, { "name": "include_api_keys", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Include Api Keys" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AllUsersResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/users": { "put": { "tags": [ "public" ], "summary": "Bulk Invite Users", "description": "emails are string validated. If any email fails validation, no emails are\ninvited and an exception is raised.", "operationId": "bulk_invite_users", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Body_bulk_invite_users_manage_admin_users_put" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "integer", "title": "Response Bulk Invite Users Manage Admin Users Put" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/remove-invited-user": { "patch": { "tags": [ "public" ], "summary": "Remove Invited User", "operationId": "remove_invited_user", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserByEmail" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "integer", "title": "Response Remove Invited User Manage Admin Remove Invited User Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/deactivate-user": { "patch": { "tags": [ "public" ], "summary": "Deactivate User Api", "operationId": "deactivate_user_api", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserByEmail" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/delete-user": { "delete": { "tags": [ "public" ], "summary": "Delete User", "operationId": "delete_user", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserByEmail" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/activate-user": { "patch": { "tags": [ "public" ], "summary": "Activate User Api", "operationId": "activate_user_api", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserByEmail" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/users": { "get": { "tags": [ "public" ], "summary": "List All Users Basic Info", "operationId": "list_all_users_basic_info", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/MinimalUserSnapshot" }, "title": "Response List All Users Basic Info Users Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/get-user-role": { "get": { "tags": [ "public" ], "summary": "Get User Role", "operationId": "get_user_role", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserRoleResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/me": { "get": { "tags": [ "public" ], "summary": "Verify User Logged In", "operationId": "verify_user_logged_in", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserInfo" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/deletion-attempt": { "post": { "tags": [ "public" ], "summary": "Create Deletion Attempt For Connector Id", "operationId": "create_deletion_attempt_for_connector_id", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorCredentialPairIdentifier" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/connector/file/upload": { "post": { "tags": [ "public" ], "summary": "Upload Files Api", "operationId": "upload_files_api", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_files_api_manage_admin_connector_file_upload_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileUploadResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/connector/{connector_id}/files": { "get": { "tags": [ "public" ], "summary": "List Connector Files", "description": "List all files in a file connector.", "operationId": "list_connector_files", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "connector_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Connector Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorFilesResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/connector/{connector_id}/files/update": { "post": { "tags": [ "public" ], "summary": "Update Connector Files", "description": "Update files in a connector by adding new files and/or removing existing ones.\nThis is an atomic operation that validates, updates the connector config, and triggers indexing.", "operationId": "update_connector_files", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "connector_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Connector Id" } } ], "requestBody": { "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_update_connector_files_manage_admin_connector__connector_id__files_update_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FileUploadResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/connector": { "get": { "tags": [ "public" ], "summary": "Get Connectors By Credential", "description": "Get a list of connectors. Allow filtering by a specific credential id.", "operationId": "get_connectors_by_credential", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "credential", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Credential" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ConnectorSnapshot" }, "title": "Response Get Connectors By Credential Manage Admin Connector Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "public" ], "summary": "Create Connector From Model", "operationId": "create_connector_from_model", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorUpdateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ObjectCreationIdResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/connector/failed-indexing-status": { "get": { "tags": [ "public" ], "summary": "Get Currently Failed Indexing Status", "operationId": "get_currently_failed_indexing_status", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "secondary_index", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Secondary Index" } }, { "name": "get_editable", "in": "query", "required": false, "schema": { "type": "boolean", "description": "If true, return editable document sets", "default": false, "title": "Get Editable" }, "description": "If true, return editable document sets" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/FailedConnectorIndexingStatus" }, "title": "Response Get Currently Failed Indexing Status Manage Admin Connector Failed Indexing Status Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/connector/status": { "get": { "tags": [ "public" ], "summary": "Get Connector Status", "operationId": "get_connector_status", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ConnectorStatus" }, "title": "Response Get Connector Status Manage Admin Connector Status Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/connector/indexing-status": { "post": { "tags": [ "public" ], "summary": "Get Connector Indexing Status", "operationId": "get_connector_indexing_status", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IndexingStatusRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ConnectorIndexingStatusLiteResponse" }, "title": "Response Get Connector Indexing Status Manage Admin Connector Indexing Status Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/connector/{connector_id}": { "patch": { "tags": [ "public" ], "summary": "Update Connector From Model", "operationId": "update_connector_from_model", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "connector_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Connector Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorUpdateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConnectorSnapshot" }, { "$ref": "#/components/schemas/StatusResponse_int_" } ], "title": "Response Update Connector From Model Manage Admin Connector Connector Id Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "public" ], "summary": "Delete Connector By Id", "operationId": "delete_connector_by_id", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "connector_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Connector Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusResponse_int_" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/connector/run-once": { "post": { "tags": [ "public" ], "summary": "Connector Run Once", "description": "Used to trigger indexing on a set of cc_pairs associated with a\nsingle connector.", "operationId": "connector_run_once", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunConnectorRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusResponse_int_" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/connector": { "get": { "tags": [ "public" ], "summary": "Get Connectors", "operationId": "get_connectors", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ConnectorSnapshot" }, "title": "Response Get Connectors Manage Connector Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/indexed-sources": { "get": { "tags": [ "public" ], "summary": "Get Indexed Sources", "operationId": "get_indexed_sources", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IndexedSourcesResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/connector/{connector_id}": { "get": { "tags": [ "public" ], "summary": "Get Connector By Id", "operationId": "get_connector_by_id", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "connector_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Connector Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConnectorSnapshot" }, { "$ref": "#/components/schemas/StatusResponse_int_" } ], "title": "Response Get Connector By Id Manage Connector Connector Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/connector-status": { "get": { "tags": [ "public" ], "summary": "Get Basic Connector Indexing Status", "operationId": "get_basic_connector_indexing_status", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/BasicCCPairInfo" }, "title": "Response Get Basic Connector Indexing Status Manage Connector Status Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/credential": { "get": { "tags": [ "public" ], "summary": "List Credentials Admin", "description": "Lists all public credentials", "operationId": "list_credentials_admin", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CredentialSnapshot" }, "title": "Response List Credentials Admin Manage Admin Credential Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/similar-credentials/{source_type}": { "get": { "tags": [ "public" ], "summary": "Get Cc Source Full Info", "operationId": "get_cc_source_full_info", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "source_type", "in": "path", "required": true, "schema": { "$ref": "#/components/schemas/DocumentSource" } }, { "name": "get_editable", "in": "query", "required": false, "schema": { "type": "boolean", "description": "If true, return editable credentials", "default": false, "title": "Get Editable" }, "description": "If true, return editable credentials" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CredentialSnapshot" }, "title": "Response Get Cc Source Full Info Manage Admin Similar Credentials Source Type Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/credential/{credential_id}": { "delete": { "tags": [ "public" ], "summary": "Delete Credential By Id Admin", "description": "Same as the user endpoint, but can delete any credential (not just the user's own)", "operationId": "delete_credential_by_id_admin", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "credential_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Credential Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "public" ], "summary": "Update Credential Data", "operationId": "update_credential_data", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "credential_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Credential Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CredentialDataUpdateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CredentialBase" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/credential/swap": { "put": { "tags": [ "public" ], "summary": "Swap Credentials For Connector", "operationId": "swap_credentials_for_connector", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CredentialSwapRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/credential": { "post": { "tags": [ "public" ], "summary": "Create Credential From Model", "operationId": "create_credential_from_model", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CredentialBase" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ObjectCreationIdResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "public" ], "summary": "List Credentials", "operationId": "list_credentials", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/CredentialSnapshot" }, "title": "Response List Credentials Manage Credential Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/credential/private-key": { "post": { "tags": [ "public" ], "summary": "Create Credential With Private Key", "operationId": "create_credential_with_private_key", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_create_credential_with_private_key_manage_credential_private_key_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ObjectCreationIdResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/credential/{credential_id}": { "get": { "tags": [ "public" ], "summary": "Get Credential By Id", "operationId": "get_credential_by_id", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "credential_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Credential Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/CredentialSnapshot" }, { "$ref": "#/components/schemas/StatusResponse_int_" } ], "title": "Response Get Credential By Id Manage Credential Credential Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "public" ], "summary": "Update Credential From Model", "operationId": "update_credential_from_model", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "credential_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Credential Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CredentialBase" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/CredentialSnapshot" }, { "$ref": "#/components/schemas/StatusResponse_int_" } ], "title": "Response Update Credential From Model Manage Credential Credential Id Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "public" ], "summary": "Delete Credential By Id", "operationId": "delete_credential_by_id", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "credential_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Credential Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/credential/private-key/{credential_id}": { "put": { "tags": [ "public" ], "summary": "Update Credential Private Key", "operationId": "update_credential_private_key", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "credential_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Credential Id" } } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_update_credential_private_key_manage_admin_credential_private_key__credential_id__put" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CredentialBase" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/credential/force/{credential_id}": { "delete": { "tags": [ "public" ], "summary": "Force Delete Credential By Id", "operationId": "force_delete_credential_by_id", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "credential_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Credential Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/cc-pair/{cc_pair_id}/index-attempts": { "get": { "tags": [ "public" ], "summary": "Get Cc Pair Index Attempts", "operationId": "get_cc_pair_index_attempts", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "cc_pair_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Cc Pair Id" } }, { "name": "page_num", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Page Num" } }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "default": 10, "title": "Page Size" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedReturn_IndexAttemptSnapshot_" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/cc-pair/{cc_pair_id}": { "get": { "tags": [ "public" ], "summary": "Get Cc Pair Full Info", "operationId": "get_cc_pair_full_info", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "cc_pair_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Cc Pair Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CCPairFullInfo" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/cc-pair/{cc_pair_id}/status": { "put": { "tags": [ "public" ], "summary": "Update Cc Pair Status", "description": "This method returns nearly immediately. It simply sets some signals and\noptimistically assumes any running background processes will clean themselves up.\nThis is done to improve the perceived end user experience.\n\nReturns HTTPStatus.OK if everything finished.", "operationId": "update_cc_pair_status", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "cc_pair_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Cc Pair Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CCStatusUpdateRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/cc-pair/{cc_pair_id}/prune": { "post": { "tags": [ "public" ], "summary": "Prune Cc Pair", "description": "Triggers pruning on a particular cc_pair immediately", "operationId": "prune_cc_pair", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "cc_pair_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Cc Pair Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusResponse_list_int__" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/admin/cc-pair/{cc_pair_id}/errors": { "get": { "tags": [ "public" ], "summary": "Get Cc Pair Indexing Errors", "description": "Gives back all errors for a given CC Pair. Allows pagination based on page and page_size params.\n\nArgs:\n cc_pair_id: ID of the connector-credential pair to get errors for\n include_resolved: Whether to include resolved errors in the results\n page_num: Page number for pagination, starting at 0\n page_size: Number of errors to return per page\n _: Current user, must be curator or admin\n db_session: Database session\n\nReturns:\n Paginated list of indexing errors for the CC pair.", "operationId": "get_cc_pair_indexing_errors", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "cc_pair_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Cc Pair Id" } }, { "name": "include_resolved", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Include Resolved" } }, { "name": "page_num", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Page Num" } }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 10, "title": "Page Size" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedReturn_IndexAttemptErrorPydantic_" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/manage/connector/{connector_id}/credential/{credential_id}": { "put": { "tags": [ "public" ], "summary": "Associate Credential To Connector", "description": "NOTE(rkuo): internally discussed and the consensus is this endpoint\nand create_connector_with_mock_credential should be combined.\n\nThe intent of this endpoint is to handle connectors that actually need credentials.", "operationId": "associate_credential_to_connector", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "connector_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Connector Id" } }, { "name": "credential_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Credential Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorCredentialPairMetadata" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusResponse_int_" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "public" ], "summary": "Dissociate Credential From Connector", "operationId": "dissociate_credential_from_connector", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "connector_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Connector Id" } }, { "name": "credential_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Credential Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusResponse_int_" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/": { "get": { "tags": [ "public" ], "summary": "Get Projects", "operationId": "get_projects", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/UserProjectSnapshot" }, "title": "Response Get Projects User Projects Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/create": { "post": { "tags": [ "public" ], "summary": "Create Project", "operationId": "create_project", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "name", "in": "query", "required": true, "schema": { "type": "string", "title": "Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProjectSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/file/upload": { "post": { "tags": [ "public" ], "summary": "Upload User Files", "operationId": "upload_user_files", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "multipart/form-data": { "schema": { "$ref": "#/components/schemas/Body_upload_user_files_user_projects_file_upload_post" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CategorizedFilesSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/{project_id}": { "get": { "tags": [ "public" ], "summary": "Get Project", "operationId": "get_project", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProjectSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "public" ], "summary": "Update Project", "operationId": "update_project", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Project Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateProjectRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserProjectSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "public" ], "summary": "Delete Project", "operationId": "delete_project", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/files/{project_id}": { "get": { "tags": [ "public" ], "summary": "Get Files In Project", "operationId": "get_files_in_project", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/UserFileSnapshot" }, "title": "Response Get Files In Project User Projects Files Project Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/{project_id}/files/{file_id}": { "delete": { "tags": [ "public" ], "summary": "Unlink User File From Project", "description": "Unlink an existing user file from a specific project for the current user.\n\nDoes not delete the underlying file; only removes the association.", "operationId": "unlink_user_file_from_project", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Project Id" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "title": "File Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "public" ], "summary": "Link User File To Project", "description": "Link an existing user file to a specific project for the current user.\n\nCreates the association in the Project__UserFile join table if it does not exist.\nReturns the linked user file snapshot.", "operationId": "link_user_file_to_project", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Project Id" } }, { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "title": "File Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserFileSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/{project_id}/instructions": { "get": { "tags": [ "public" ], "summary": "Get Project Instructions", "operationId": "get_project_instructions", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectInstructionsResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "public" ], "summary": "Upsert Project Instructions", "description": "Create or update this project's instructions stored on the project itself.", "operationId": "upsert_project_instructions", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Project Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpsertProjectInstructionsRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectInstructionsResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/{project_id}/details": { "get": { "tags": [ "public" ], "summary": "Get Project Details", "operationId": "get_project_details", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectPayload" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/file/{file_id}": { "delete": { "tags": [ "public" ], "summary": "Delete User File", "description": "Delete a user file belonging to the current user.\n\nThis will also remove any project associations for the file.", "operationId": "delete_user_file", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "title": "File Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserFileDeleteResult" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "public" ], "summary": "Get User File", "description": "Fetch a single user file by ID for the current user.\n\nIncludes files in any status (including FAILED) to allow status polling.", "operationId": "get_user_file", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "file_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid", "title": "File Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserFileSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/file/statuses": { "post": { "tags": [ "public" ], "summary": "Get User File Statuses", "description": "Fetch statuses for a set of user file IDs owned by the current user.\n\nIncludes files in any status so the client can detect transitions to FAILED.", "operationId": "get_user_file_statuses", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UserFileIdsRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/UserFileSnapshot" }, "title": "Response Get User File Statuses User Projects File Statuses Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user/projects/session/{chat_session_id}/files": { "get": { "tags": [ "public" ], "summary": "Get Chat Session Project Files", "description": "Return user files for the project linked to the given chat session.\n\nIf the chat session has no project, returns an empty list.\nOnly returns files owned by the current user and not FAILED.", "operationId": "get_chat_session_project_files", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "chat_session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Chat Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/UserFileSnapshot" }, "title": "Response Get Chat Session Project Files User Projects Session Chat Session Id Files Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/persona": { "post": { "tags": [ "public" ], "summary": "Create Persona", "operationId": "create_persona", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersonaUpsertRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersonaSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/persona/{persona_id}": { "patch": { "tags": [ "public" ], "summary": "Update Persona", "operationId": "update_persona", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Persona Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersonaUpsertRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PersonaSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "public" ], "summary": "Delete Persona", "operationId": "delete_persona", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "public" ], "summary": "Get Persona", "operationId": "get_persona", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FullPersonaSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/persona": { "get": { "tags": [ "public" ], "summary": "List Personas Admin", "operationId": "list_personas_admin", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "include_deleted", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Include Deleted" } }, { "name": "get_editable", "in": "query", "required": false, "schema": { "type": "boolean", "description": "If true, return editable personas", "default": false, "title": "Get Editable" }, "description": "If true, return editable personas" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/PersonaSnapshot" }, "title": "Response List Personas Admin Admin Persona Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/persona/{persona_id}/undelete": { "patch": { "tags": [ "public" ], "summary": "Undelete Persona", "operationId": "undelete_persona", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "persona_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Persona Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/agents": { "get": { "tags": [ "public" ], "summary": "Get Agents Paginated", "description": "Paginated endpoint for listing agents available to the user.\n\nReturns items for the requested page plus total count.\nPersonas are ordered by display_priority (ASC, nulls last) then by ID (ASC).\n\nNOTE: persona_ids filter is not supported with pagination. Use the\nnon-paginated endpoint if filtering by specific IDs is needed.", "operationId": "get_agents_paginated", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "page_num", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page number (0-indexed).", "default": 0, "title": "Page Num" }, "description": "Page number (0-indexed)." }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "description": "Items per page.", "default": 10, "title": "Page Size" }, "description": "Items per page." }, { "name": "include_deleted", "in": "query", "required": false, "schema": { "type": "boolean", "description": "If true, includes deleted personas.", "default": false, "title": "Include Deleted" }, "description": "If true, includes deleted personas." }, { "name": "get_editable", "in": "query", "required": false, "schema": { "type": "boolean", "description": "If true, only returns editable personas.", "default": false, "title": "Get Editable" }, "description": "If true, only returns editable personas." }, { "name": "include_default", "in": "query", "required": false, "schema": { "type": "boolean", "description": "If true, includes builtin/default personas.", "default": true, "title": "Include Default" }, "description": "If true, includes builtin/default personas." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedReturn_MinimalPersonaSnapshot_" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/agents": { "get": { "tags": [ "public" ], "summary": "Get Agents Admin Paginated", "description": "Paginated endpoint for listing agents (formerly personas) (admin view).\n\nReturns items for the requested page plus total count.\nAgents are ordered by display_priority (ASC, nulls last) then by ID (ASC).", "operationId": "get_agents_admin_paginated", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "page_num", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "description": "Page number (0-indexed).", "default": 0, "title": "Page Num" }, "description": "Page number (0-indexed)." }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "description": "Items per page.", "default": 10, "title": "Page Size" }, "description": "Items per page." }, { "name": "include_deleted", "in": "query", "required": false, "schema": { "type": "boolean", "description": "If true, includes deleted personas.", "default": false, "title": "Include Deleted" }, "description": "If true, includes deleted personas." }, { "name": "get_editable", "in": "query", "required": false, "schema": { "type": "boolean", "description": "If true, only returns editable personas.", "default": false, "title": "Get Editable" }, "description": "If true, only returns editable personas." }, { "name": "include_default", "in": "query", "required": false, "schema": { "type": "boolean", "description": "If true, includes builtin/default personas.", "default": true, "title": "Include Default" }, "description": "If true, includes builtin/default personas." } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaginatedReturn_PersonaSnapshot_" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/tool/openapi": { "get": { "tags": [ "public" ], "summary": "List Openapi Tools", "operationId": "list_openapi_tools", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ToolSnapshot" }, "title": "Response List Openapi Tools Tool Openapi Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/tool/{tool_id}": { "get": { "tags": [ "public" ], "summary": "Get Custom Tool", "operationId": "get_custom_tool", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "tool_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Tool Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/tool": { "get": { "tags": [ "public" ], "summary": "List Tools", "operationId": "list_tools", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ToolSnapshot" }, "title": "Response List Tools Tool Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/tool/custom": { "post": { "tags": [ "public" ], "summary": "Create Custom Tool", "operationId": "create_custom_tool", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomToolCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/tool/custom/{tool_id}": { "put": { "tags": [ "public" ], "summary": "Update Custom Tool", "operationId": "update_custom_tool", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "tool_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Tool Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomToolUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolSnapshot" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "public" ], "summary": "Delete Custom Tool", "operationId": "delete_custom_tool", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "tool_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Tool Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/tool/custom/validate": { "post": { "tags": [ "public" ], "summary": "Validate Tool", "operationId": "validate_tool", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateToolRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ValidateToolResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/health": { "get": { "tags": [ "public" ], "summary": "Healthcheck", "operationId": "healthcheck", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusResponse" } } } } } } }, "/auth/type": { "get": { "tags": [ "public" ], "summary": "Get Auth Type", "operationId": "get_auth_type", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuthTypeResponse" } } } } } } }, "/version": { "get": { "tags": [ "public" ], "summary": "Get Version", "operationId": "get_version", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VersionResponse" } } } } } } }, "/versions": { "get": { "tags": [ "public" ], "summary": "Get Versions", "description": "Fetches the latest stable and beta versions of Onyx Docker images.\nSince DockerHub does not explicitly flag stable and beta images,\nthis endpoint can be used to programmatically check for new images.", "operationId": "get_versions", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AllVersions" } } } } } } }, "/web-search/search": { "post": { "tags": [ "public" ], "summary": "Execute Web Search", "description": "Perform a web search and immediately fetch content for the returned URLs.\n\nUse this when you want both snippets and page contents from one call.\n\nIf you want to selectively fetch content (i.e. let the LLM decide which URLs to read),\nuse `/search-lite` and then call `/open-urls` separately.", "operationId": "execute_web_search", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebSearchToolRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebSearchWithContentResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/web-search/search-lite": { "post": { "tags": [ "public" ], "summary": "Execute Web Search Lite", "description": "Lightweight search-only endpoint. Returns search snippets and URLs without\nfetching page contents. Pair with `/open-urls` if you need to fetch content\nlater.", "operationId": "execute_web_search_lite", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebSearchToolRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebSearchToolResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/web-search/open-urls": { "post": { "tags": [ "public" ], "summary": "Execute Open Urls", "description": "Fetch content for specific URLs using the configured content provider.\nIntended to complement `/search-lite` when you need content for a subset of URLs.", "operationId": "execute_open_urls", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenUrlsToolRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpenUrlsToolResponse" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/token-rate-limits/global": { "get": { "tags": [ "public" ], "summary": "Get Global Token Limit Settings", "operationId": "get_global_token_limit_settings", "security": [ { "BearerAuth": [] } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TokenRateLimitDisplay" }, "title": "Response Get Global Token Limit Settings Admin Token Rate Limits Global Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "public" ], "summary": "Create Global Token Limit Settings", "operationId": "create_global_token_limit_settings", "security": [ { "BearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenRateLimitArgs" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenRateLimitDisplay" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/admin/token-rate-limits/rate-limit/{token_rate_limit_id}": { "put": { "tags": [ "public" ], "summary": "Update Token Limit Settings", "operationId": "update_token_limit_settings", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "token_rate_limit_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Token Rate Limit Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenRateLimitArgs" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenRateLimitDisplay" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "public" ], "summary": "Delete Token Limit Settings", "operationId": "delete_token_limit_settings", "security": [ { "BearerAuth": [] } ], "parameters": [ { "name": "token_rate_limit_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Token Rate Limit Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "DocumentSearchResponse": { "properties": { "top_documents": { "items": { "$ref": "#/components/schemas/SavedSearchDocWithContent" }, "type": "array", "title": "Top Documents" }, "llm_indices": { "items": { "type": "integer" }, "type": "array", "title": "Llm Indices" }, "pagination": { "$ref": "#/components/schemas/DocumentSearchPagination" } }, "type": "object", "required": [ "top_documents", "llm_indices", "pagination" ], "title": "DocumentSearchResponse" }, "TenantInfo": { "properties": { "invitation": { "anyOf": [ { "$ref": "#/components/schemas/TenantSnapshot" }, { "type": "null" } ] }, "new_tenant": { "anyOf": [ { "$ref": "#/components/schemas/TenantSnapshot" }, { "type": "null" } ] } }, "type": "object", "title": "TenantInfo" }, "CustomToolStart": { "properties": { "type": { "type": "string", "const": "custom_tool_start", "title": "Type", "default": "custom_tool_start" }, "tool_name": { "type": "string", "title": "Tool Name" } }, "type": "object", "required": [ "tool_name" ], "title": "CustomToolStart" }, "CitationInfo": { "properties": { "type": { "type": "string", "const": "citation_info", "title": "Type", "default": "citation_info" }, "citation_number": { "type": "integer", "title": "Citation Number" }, "document_id": { "type": "string", "title": "Document Id" } }, "type": "object", "required": [ "citation_number", "document_id" ], "title": "CitationInfo" }, "AuthTypeResponse": { "properties": { "auth_type": { "$ref": "#/components/schemas/AuthType" }, "requires_verification": { "type": "boolean", "title": "Requires Verification" }, "anonymous_user_enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Anonymous User Enabled" }, "password_min_length": { "type": "integer", "title": "Password Min Length" } }, "type": "object", "required": [ "auth_type", "requires_verification", "password_min_length" ], "title": "AuthTypeResponse" }, "StatusResponse_list_int__": { "properties": { "success": { "type": "boolean", "title": "Success" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message" }, "data": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "title": "Data" } }, "type": "object", "required": [ "success" ], "title": "StatusResponse[list[int]]" }, "PermissionSyncStatus": { "type": "string", "enum": [ "not_started", "in_progress", "success", "canceled", "failed", "completed_with_errors" ], "title": "PermissionSyncStatus", "description": "Status enum for permission sync attempts" }, "LLMOverride": { "properties": { "model_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model Provider" }, "model_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model Version" }, "temperature": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Temperature" } }, "type": "object", "title": "LLMOverride" }, "ThemePreference": { "type": "string", "enum": [ "light", "dark", "system" ], "title": "ThemePreference" }, "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" }, "PaginatedReturn_IndexAttemptSnapshot_": { "properties": { "items": { "items": { "$ref": "#/components/schemas/IndexAttemptSnapshot" }, "type": "array", "title": "Items" }, "total_items": { "type": "integer", "title": "Total Items" } }, "type": "object", "required": [ "items", "total_items" ], "title": "PaginatedReturn[IndexAttemptSnapshot]" }, "AccessType": { "type": "string", "enum": [ "public", "private", "sync" ], "title": "AccessType" }, "UserProjectSnapshot": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "type": "string", "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "user_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "User Id" }, "instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Instructions" }, "chat_sessions": { "items": { "$ref": "#/components/schemas/ChatSessionDetails" }, "type": "array", "title": "Chat Sessions" } }, "type": "object", "required": [ "id", "name", "description", "created_at", "user_id", "chat_sessions" ], "title": "UserProjectSnapshot" }, "FailedConnectorIndexingStatus": { "properties": { "cc_pair_id": { "type": "integer", "title": "Cc Pair Id" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "error_msg": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error Msg" }, "is_deletable": { "type": "boolean", "title": "Is Deletable" }, "connector_id": { "type": "integer", "title": "Connector Id" }, "credential_id": { "type": "integer", "title": "Credential Id" } }, "type": "object", "required": [ "cc_pair_id", "name", "error_msg", "is_deletable", "connector_id", "credential_id" ], "title": "FailedConnectorIndexingStatus", "description": "Simplified version of ConnectorIndexingStatus for failed indexing attempts" }, "ToolSnapshot": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "type": "string", "title": "Name" }, "description": { "type": "string", "title": "Description" }, "definition": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Definition" }, "display_name": { "type": "string", "title": "Display Name" }, "in_code_tool_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "In Code Tool Id" }, "custom_headers": { "anyOf": [ { "items": {}, "type": "array" }, { "type": "null" } ], "title": "Custom Headers" }, "passthrough_auth": { "type": "boolean", "title": "Passthrough Auth" }, "mcp_server_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Mcp Server Id" }, "user_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "User Id" }, "oauth_config_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Oauth Config Id" }, "oauth_config_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Oauth Config Name" }, "enabled": { "type": "boolean", "title": "Enabled", "default": true }, "chat_selectable": { "type": "boolean", "title": "Chat Selectable", "default": true }, "agent_creation_selectable": { "type": "boolean", "title": "Agent Creation Selectable", "default": true }, "default_enabled": { "type": "boolean", "title": "Default Enabled", "default": false } }, "type": "object", "required": [ "id", "name", "description", "definition", "display_name", "in_code_tool_id", "custom_headers", "passthrough_auth" ], "title": "ToolSnapshot" }, "OpenUrlsToolResponse": { "properties": { "results": { "items": { "$ref": "#/components/schemas/LlmOpenUrlResult" }, "type": "array", "title": "Results" }, "provider_type": { "anyOf": [ { "$ref": "#/components/schemas/WebContentProviderType" }, { "type": "null" } ] } }, "type": "object", "required": [ "results" ], "title": "OpenUrlsToolResponse" }, "ChatSessionsResponse": { "properties": { "sessions": { "items": { "$ref": "#/components/schemas/ChatSessionDetails" }, "type": "array", "title": "Sessions" } }, "type": "object", "required": [ "sessions" ], "title": "ChatSessionsResponse" }, "PersonaLabelSnapshot": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "type": "string", "title": "Name" } }, "type": "object", "required": [ "id", "name" ], "title": "PersonaLabelSnapshot" }, "ToolConfig": { "properties": { "id": { "type": "integer", "title": "Id" } }, "type": "object", "required": [ "id" ], "title": "ToolConfig" }, "PaginatedReturn_IndexAttemptErrorPydantic_": { "properties": { "items": { "items": { "$ref": "#/components/schemas/IndexAttemptErrorPydantic" }, "type": "array", "title": "Items" }, "total_items": { "type": "integer", "title": "Total Items" } }, "type": "object", "required": [ "items", "total_items" ], "title": "PaginatedReturn[IndexAttemptErrorPydantic]" }, "Header": { "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" } }, "type": "object", "required": [ "key", "value" ], "title": "Header" }, "AllVersions": { "properties": { "stable": { "$ref": "#/components/schemas/ContainerVersions" }, "dev": { "$ref": "#/components/schemas/ContainerVersions" }, "migration": { "$ref": "#/components/schemas/ContainerVersions" } }, "type": "object", "required": [ "stable", "dev", "migration" ], "title": "AllVersions" }, "RecencyBiasSetting": { "type": "string", "enum": [ "favor_recent", "base_decay", "no_decay", "auto" ], "title": "RecencyBiasSetting" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "IndexingStatusRequest": { "properties": { "secondary_index": { "type": "boolean", "title": "Secondary Index", "default": false }, "source": { "anyOf": [ { "$ref": "#/components/schemas/DocumentSource" }, { "type": "null" } ] }, "access_type_filters": { "items": { "$ref": "#/components/schemas/AccessType" }, "type": "array", "title": "Access Type Filters" }, "last_status_filters": { "items": { "$ref": "#/components/schemas/IndexingStatus" }, "type": "array", "title": "Last Status Filters" }, "docs_count_operator": { "anyOf": [ { "$ref": "#/components/schemas/DocsCountOperator" }, { "type": "null" } ] }, "docs_count_value": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Docs Count Value" }, "name_filter": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name Filter" }, "source_to_page": { "additionalProperties": { "type": "integer" }, "propertyNames": { "$ref": "#/components/schemas/DocumentSource" }, "type": "object", "title": "Source To Page" }, "get_all_connectors": { "type": "boolean", "title": "Get All Connectors", "default": false } }, "type": "object", "title": "IndexingStatusRequest" }, "IndexedSourcesResponse": { "properties": { "sources": { "items": { "$ref": "#/components/schemas/DocumentSource" }, "type": "array", "title": "Sources" } }, "type": "object", "required": [ "sources" ], "title": "IndexedSourcesResponse" }, "ProjectInstructionsResponse": { "properties": { "instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Instructions" } }, "type": "object", "required": [ "instructions" ], "title": "ProjectInstructionsResponse" }, "ChatSeedRequest": { "properties": { "persona_id": { "type": "integer", "title": "Persona Id" }, "llm_override": { "anyOf": [ { "$ref": "#/components/schemas/LLMOverride" }, { "type": "null" } ] }, "prompt_override": { "anyOf": [ { "$ref": "#/components/schemas/PromptOverride" }, { "type": "null" } ] }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message" } }, "type": "object", "required": [ "persona_id" ], "title": "ChatSeedRequest" }, "UserFileDeleteResult": { "properties": { "has_associations": { "type": "boolean", "title": "Has Associations" }, "project_names": { "items": { "type": "string" }, "type": "array", "title": "Project Names", "default": [] }, "assistant_names": { "items": { "type": "string" }, "type": "array", "title": "Assistant Names", "default": [] } }, "type": "object", "required": [ "has_associations" ], "title": "UserFileDeleteResult" }, "IntermediateReportStart": { "properties": { "type": { "type": "string", "const": "intermediate_report_start", "title": "Type", "default": "intermediate_report_start" } }, "type": "object", "title": "IntermediateReportStart" }, "FileDescriptor": { "properties": { "id": { "type": "string", "title": "Id" }, "type": { "$ref": "#/components/schemas/ChatFileType" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "user_file_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "User File Id" } }, "type": "object", "required": [ "id", "type" ], "title": "FileDescriptor", "description": "NOTE: is a `TypedDict` so it can be used as a type hint for a JSONB column\nin Postgres" }, "Packet": { "properties": { "placement": { "$ref": "#/components/schemas/Placement" }, "obj": { "oneOf": [ { "$ref": "#/components/schemas/OverallStop" }, { "$ref": "#/components/schemas/SectionEnd" }, { "$ref": "#/components/schemas/TopLevelBranching" }, { "$ref": "#/components/schemas/AgentResponseStart" }, { "$ref": "#/components/schemas/AgentResponseDelta" }, { "$ref": "#/components/schemas/SearchToolStart" }, { "$ref": "#/components/schemas/SearchToolQueriesDelta" }, { "$ref": "#/components/schemas/SearchToolDocumentsDelta" }, { "$ref": "#/components/schemas/ImageGenerationToolStart" }, { "$ref": "#/components/schemas/ImageGenerationToolHeartbeat" }, { "$ref": "#/components/schemas/ImageGenerationFinal" }, { "$ref": "#/components/schemas/OpenUrlStart" }, { "$ref": "#/components/schemas/OpenUrlUrls" }, { "$ref": "#/components/schemas/OpenUrlDocuments" }, { "$ref": "#/components/schemas/PythonToolStart" }, { "$ref": "#/components/schemas/PythonToolDelta" }, { "$ref": "#/components/schemas/CustomToolStart" }, { "$ref": "#/components/schemas/CustomToolDelta" }, { "$ref": "#/components/schemas/ReasoningStart" }, { "$ref": "#/components/schemas/ReasoningDelta" }, { "$ref": "#/components/schemas/ReasoningDone" }, { "$ref": "#/components/schemas/CitationInfo" }, { "$ref": "#/components/schemas/DeepResearchPlanStart" }, { "$ref": "#/components/schemas/DeepResearchPlanDelta" }, { "$ref": "#/components/schemas/ResearchAgentStart" }, { "$ref": "#/components/schemas/IntermediateReportStart" }, { "$ref": "#/components/schemas/IntermediateReportDelta" }, { "$ref": "#/components/schemas/IntermediateReportCitedDocs" } ], "title": "Obj", "discriminator": { "propertyName": "type", "mapping": { "citation_info": "#/components/schemas/CitationInfo", "custom_tool_delta": "#/components/schemas/CustomToolDelta", "custom_tool_start": "#/components/schemas/CustomToolStart", "deep_research_plan_delta": "#/components/schemas/DeepResearchPlanDelta", "deep_research_plan_start": "#/components/schemas/DeepResearchPlanStart", "image_generation_final": "#/components/schemas/ImageGenerationFinal", "image_generation_heartbeat": "#/components/schemas/ImageGenerationToolHeartbeat", "image_generation_start": "#/components/schemas/ImageGenerationToolStart", "intermediate_report_cited_docs": "#/components/schemas/IntermediateReportCitedDocs", "intermediate_report_delta": "#/components/schemas/IntermediateReportDelta", "intermediate_report_start": "#/components/schemas/IntermediateReportStart", "message_delta": "#/components/schemas/AgentResponseDelta", "message_start": "#/components/schemas/AgentResponseStart", "open_url_documents": "#/components/schemas/OpenUrlDocuments", "open_url_start": "#/components/schemas/OpenUrlStart", "open_url_urls": "#/components/schemas/OpenUrlUrls", "python_tool_delta": "#/components/schemas/PythonToolDelta", "python_tool_start": "#/components/schemas/PythonToolStart", "reasoning_delta": "#/components/schemas/ReasoningDelta", "reasoning_done": "#/components/schemas/ReasoningDone", "reasoning_start": "#/components/schemas/ReasoningStart", "research_agent_start": "#/components/schemas/ResearchAgentStart", "search_tool_documents_delta": "#/components/schemas/SearchToolDocumentsDelta", "search_tool_queries_delta": "#/components/schemas/SearchToolQueriesDelta", "search_tool_start": "#/components/schemas/SearchToolStart", "section_end": "#/components/schemas/SectionEnd", "stop": "#/components/schemas/OverallStop", "top_level_branching": "#/components/schemas/TopLevelBranching" } } } }, "type": "object", "required": [ "placement", "obj" ], "title": "Packet" }, "ObjectCreationIdResponse": { "properties": { "id": { "type": "integer", "title": "Id" }, "credential": { "anyOf": [ { "$ref": "#/components/schemas/CredentialSnapshot" }, { "type": "null" } ] } }, "type": "object", "required": [ "id" ], "title": "ObjectCreationIdResponse" }, "SectionEnd": { "properties": { "type": { "type": "string", "const": "section_end", "title": "Type", "default": "section_end" } }, "type": "object", "title": "SectionEnd" }, "OpenUrlDocuments": { "properties": { "type": { "type": "string", "const": "open_url_documents", "title": "Type", "default": "open_url_documents" }, "documents": { "items": { "$ref": "#/components/schemas/SearchDoc" }, "type": "array", "title": "Documents" } }, "type": "object", "required": [ "documents" ], "title": "OpenUrlDocuments", "description": "Final documents after crawling completes." }, "FederatedConnectorStatus": { "properties": { "id": { "type": "integer", "title": "Id" }, "source": { "$ref": "#/components/schemas/FederatedConnectorSource" }, "name": { "type": "string", "title": "Name" } }, "type": "object", "required": [ "id", "source", "name" ], "title": "FederatedConnectorStatus" }, "ValidateToolRequest": { "properties": { "definition": { "additionalProperties": true, "type": "object", "title": "Definition" } }, "type": "object", "required": [ "definition" ], "title": "ValidateToolRequest" }, "MinimalPersonaSnapshot": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "type": "string", "title": "Name" }, "description": { "type": "string", "title": "Description" }, "tools": { "items": { "$ref": "#/components/schemas/ToolSnapshot" }, "type": "array", "title": "Tools" }, "starter_messages": { "anyOf": [ { "items": { "$ref": "#/components/schemas/StarterMessage" }, "type": "array" }, { "type": "null" } ], "title": "Starter Messages" }, "llm_relevance_filter": { "type": "boolean", "title": "Llm Relevance Filter" }, "llm_filter_extraction": { "type": "boolean", "title": "Llm Filter Extraction" }, "document_sets": { "items": { "$ref": "#/components/schemas/DocumentSetSummary" }, "type": "array", "title": "Document Sets" }, "llm_model_version_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Llm Model Version Override" }, "llm_model_provider_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Llm Model Provider Override" }, "uploaded_image_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Uploaded Image Id" }, "icon_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Icon Name" }, "is_public": { "type": "boolean", "title": "Is Public" }, "is_visible": { "type": "boolean", "title": "Is Visible" }, "display_priority": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Display Priority" }, "is_default_persona": { "type": "boolean", "title": "Is Default Persona" }, "builtin_persona": { "type": "boolean", "title": "Builtin Persona" }, "labels": { "items": { "$ref": "#/components/schemas/PersonaLabelSnapshot" }, "type": "array", "title": "Labels" }, "owner": { "anyOf": [ { "$ref": "#/components/schemas/MinimalUserSnapshot" }, { "type": "null" } ] } }, "type": "object", "required": [ "id", "name", "description", "tools", "starter_messages", "llm_relevance_filter", "llm_filter_extraction", "document_sets", "llm_model_version_override", "llm_model_provider_override", "uploaded_image_id", "icon_name", "is_public", "is_visible", "display_priority", "is_default_persona", "builtin_persona", "labels", "owner" ], "title": "MinimalPersonaSnapshot", "description": "Minimal persona model optimized for ChatPage.tsx - only includes fields actually used" }, "ChatSeedResponse": { "properties": { "redirect_url": { "type": "string", "title": "Redirect Url" } }, "type": "object", "required": [ "redirect_url" ], "title": "ChatSeedResponse" }, "ContainerVersions": { "properties": { "onyx": { "type": "string", "title": "Onyx" }, "relational_db": { "type": "string", "title": "Relational Db" }, "index": { "type": "string", "title": "Index" }, "nginx": { "type": "string", "title": "Nginx" } }, "type": "object", "required": [ "onyx", "relational_db", "index", "nginx" ], "title": "ContainerVersions" }, "UserRoleResponse": { "properties": { "role": { "type": "string", "title": "Role" } }, "type": "object", "required": [ "role" ], "title": "UserRoleResponse" }, "IndexingStatus": { "type": "string", "enum": [ "not_started", "in_progress", "success", "canceled", "failed", "completed_with_errors" ], "title": "IndexingStatus" }, "ChatSessionCreationRequest": { "properties": { "persona_id": { "type": "integer", "title": "Persona Id", "default": 0 }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "project_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Project Id" } }, "type": "object", "title": "ChatSessionCreationRequest" }, "MinimalUserSnapshot": { "properties": { "id": { "type": "string", "format": "uuid", "title": "Id" }, "email": { "type": "string", "title": "Email" } }, "type": "object", "required": [ "id", "email" ], "title": "MinimalUserSnapshot" }, "DeletionAttemptSnapshot": { "properties": { "connector_id": { "type": "integer", "title": "Connector Id" }, "credential_id": { "type": "integer", "title": "Credential Id" }, "status": { "$ref": "#/components/schemas/TaskStatus" } }, "type": "object", "required": [ "connector_id", "credential_id", "status" ], "title": "DeletionAttemptSnapshot" }, "OptionalSearchSetting": { "type": "string", "enum": [ "always", "never", "auto" ], "title": "OptionalSearchSetting" }, "CreateChatSessionID": { "properties": { "chat_session_id": { "type": "string", "format": "uuid", "title": "Chat Session Id" } }, "type": "object", "required": [ "chat_session_id" ], "title": "CreateChatSessionID" }, "ChatSessionSummary": { "properties": { "id": { "type": "string", "format": "uuid", "title": "Id" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "persona_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Persona Id" }, "time_created": { "type": "string", "format": "date-time", "title": "Time Created" }, "shared_status": { "$ref": "#/components/schemas/ChatSessionSharedStatus" }, "current_alternate_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Current Alternate Model" }, "current_temperature_override": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Current Temperature Override" } }, "type": "object", "required": [ "id", "time_created", "shared_status" ], "title": "ChatSessionSummary" }, "FederatedConnectorSource": { "type": "string", "enum": [ "federated_slack" ], "title": "FederatedConnectorSource" }, "AgentResponseDelta": { "properties": { "type": { "type": "string", "const": "message_delta", "title": "Type", "default": "message_delta" }, "content": { "type": "string", "title": "Content" } }, "type": "object", "required": [ "content" ], "title": "AgentResponseDelta" }, "ChatMessageDetail": { "properties": { "chat_session_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Chat Session Id" }, "message_id": { "type": "integer", "title": "Message Id" }, "parent_message": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Parent Message" }, "latest_child_message": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Latest Child Message" }, "message": { "type": "string", "title": "Message" }, "reasoning_tokens": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reasoning Tokens" }, "message_type": { "$ref": "#/components/schemas/MessageType" }, "context_docs": { "anyOf": [ { "items": { "$ref": "#/components/schemas/SavedSearchDoc" }, "type": "array" }, { "type": "null" } ], "title": "Context Docs" }, "citations": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "title": "Citations" }, "time_sent": { "type": "string", "format": "date-time", "title": "Time Sent" }, "files": { "items": { "$ref": "#/components/schemas/FileDescriptor" }, "type": "array", "title": "Files" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" }, "current_feedback": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Current Feedback" } }, "type": "object", "required": [ "message_id", "message", "message_type", "time_sent", "files" ], "title": "ChatMessageDetail" }, "TopLevelBranching": { "properties": { "type": { "type": "string", "const": "top_level_branching", "title": "Type", "default": "top_level_branching" }, "num_parallel_branches": { "type": "integer", "title": "Num Parallel Branches" } }, "type": "object", "required": [ "num_parallel_branches" ], "title": "TopLevelBranching" }, "RerankerProvider": { "type": "string", "enum": [ "cohere", "litellm", "bedrock" ], "title": "RerankerProvider" }, "SearchToolQueriesDelta": { "properties": { "type": { "type": "string", "const": "search_tool_queries_delta", "title": "Type", "default": "search_tool_queries_delta" }, "queries": { "items": { "type": "string" }, "type": "array", "title": "Queries" } }, "type": "object", "required": [ "queries" ], "title": "SearchToolQueriesDelta" }, "UserInfo": { "properties": { "id": { "type": "string", "title": "Id" }, "email": { "type": "string", "title": "Email" }, "is_active": { "type": "boolean", "title": "Is Active" }, "is_superuser": { "type": "boolean", "title": "Is Superuser" }, "is_verified": { "type": "boolean", "title": "Is Verified" }, "role": { "$ref": "#/components/schemas/UserRole" }, "preferences": { "$ref": "#/components/schemas/UserPreferences" }, "personalization": { "$ref": "#/components/schemas/UserPersonalization" }, "oidc_expiry": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Oidc Expiry" }, "current_token_created_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Current Token Created At" }, "current_token_expiry_length": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Current Token Expiry Length" }, "is_cloud_superuser": { "type": "boolean", "title": "Is Cloud Superuser", "default": false }, "team_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Team Name" }, "is_anonymous_user": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Anonymous User" }, "password_configured": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Password Configured" }, "tenant_info": { "anyOf": [ { "$ref": "#/components/schemas/TenantInfo" }, { "type": "null" } ] } }, "type": "object", "required": [ "id", "email", "is_active", "is_superuser", "is_verified", "role", "preferences" ], "title": "UserInfo" }, "UserPersonalization": { "properties": { "name": { "type": "string", "title": "Name", "default": "" }, "role": { "type": "string", "title": "Role", "default": "" }, "use_memories": { "type": "boolean", "title": "Use Memories", "default": true }, "memories": { "items": { "type": "string" }, "type": "array", "title": "Memories" } }, "type": "object", "title": "UserPersonalization" }, "MessageType": { "type": "string", "enum": [ "system", "user", "assistant", "tool_call", "tool_call_response" ], "title": "MessageType" }, "PersonaSnapshot": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "type": "string", "title": "Name" }, "description": { "type": "string", "title": "Description" }, "is_public": { "type": "boolean", "title": "Is Public" }, "is_visible": { "type": "boolean", "title": "Is Visible" }, "uploaded_image_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Uploaded Image Id" }, "icon_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Icon Name" }, "user_file_ids": { "items": { "type": "string" }, "type": "array", "title": "User File Ids" }, "display_priority": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Display Priority" }, "is_default_persona": { "type": "boolean", "title": "Is Default Persona" }, "builtin_persona": { "type": "boolean", "title": "Builtin Persona" }, "starter_messages": { "anyOf": [ { "items": { "$ref": "#/components/schemas/StarterMessage" }, "type": "array" }, { "type": "null" } ], "title": "Starter Messages" }, "llm_relevance_filter": { "type": "boolean", "title": "Llm Relevance Filter" }, "llm_filter_extraction": { "type": "boolean", "title": "Llm Filter Extraction" }, "tools": { "items": { "$ref": "#/components/schemas/ToolSnapshot" }, "type": "array", "title": "Tools" }, "labels": { "items": { "$ref": "#/components/schemas/PersonaLabelSnapshot" }, "type": "array", "title": "Labels" }, "owner": { "anyOf": [ { "$ref": "#/components/schemas/MinimalUserSnapshot" }, { "type": "null" } ] }, "users": { "items": { "$ref": "#/components/schemas/MinimalUserSnapshot" }, "type": "array", "title": "Users" }, "groups": { "items": { "type": "integer" }, "type": "array", "title": "Groups" }, "document_sets": { "items": { "$ref": "#/components/schemas/DocumentSetSummary" }, "type": "array", "title": "Document Sets" }, "llm_model_provider_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Llm Model Provider Override" }, "llm_model_version_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Llm Model Version Override" }, "num_chunks": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Num Chunks" }, "system_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "System Prompt" }, "replace_base_system_prompt": { "type": "boolean", "title": "Replace Base System Prompt", "default": false }, "task_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Task Prompt" }, "datetime_aware": { "type": "boolean", "title": "Datetime Aware", "default": true } }, "type": "object", "required": [ "id", "name", "description", "is_public", "is_visible", "uploaded_image_id", "icon_name", "user_file_ids", "display_priority", "is_default_persona", "builtin_persona", "starter_messages", "llm_relevance_filter", "llm_filter_extraction", "tools", "labels", "owner", "users", "groups", "document_sets", "llm_model_provider_override", "llm_model_version_override", "num_chunks" ], "title": "PersonaSnapshot" }, "BaseFilters": { "properties": { "source_type": { "anyOf": [ { "items": { "$ref": "#/components/schemas/DocumentSource" }, "type": "array" }, { "type": "null" } ], "title": "Source Type" }, "document_set": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Document Set" }, "time_cutoff": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Time Cutoff" }, "tags": { "anyOf": [ { "items": { "$ref": "#/components/schemas/Tag" }, "type": "array" }, { "type": "null" } ], "title": "Tags" } }, "type": "object", "title": "BaseFilters" }, "ChatSearchResponse": { "properties": { "groups": { "items": { "$ref": "#/components/schemas/ChatSessionGroup" }, "type": "array", "title": "Groups" }, "has_more": { "type": "boolean", "title": "Has More" }, "next_page": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Next Page" } }, "type": "object", "required": [ "groups", "has_more" ], "title": "ChatSearchResponse" }, "IndexAttemptErrorPydantic": { "properties": { "id": { "type": "integer", "title": "Id" }, "connector_credential_pair_id": { "type": "integer", "title": "Connector Credential Pair Id" }, "document_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Document Id" }, "document_link": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Document Link" }, "entity_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entity Id" }, "failed_time_range_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Failed Time Range Start" }, "failed_time_range_end": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Failed Time Range End" }, "failure_message": { "type": "string", "title": "Failure Message" }, "is_resolved": { "type": "boolean", "title": "Is Resolved", "default": false }, "time_created": { "type": "string", "format": "date-time", "title": "Time Created" }, "index_attempt_id": { "type": "integer", "title": "Index Attempt Id" } }, "type": "object", "required": [ "id", "connector_credential_pair_id", "document_id", "document_link", "entity_id", "failed_time_range_start", "failed_time_range_end", "failure_message", "time_created", "index_attempt_id" ], "title": "IndexAttemptErrorPydantic" }, "CCStatusUpdateRequest": { "properties": { "status": { "$ref": "#/components/schemas/ConnectorCredentialPairStatus" } }, "type": "object", "required": [ "status" ], "title": "CCStatusUpdateRequest" }, "DeepResearchPlanStart": { "properties": { "type": { "type": "string", "const": "deep_research_plan_start", "title": "Type", "default": "deep_research_plan_start" } }, "type": "object", "title": "DeepResearchPlanStart" }, "BasicCCPairInfo": { "properties": { "has_successful_run": { "type": "boolean", "title": "Has Successful Run" }, "source": { "$ref": "#/components/schemas/DocumentSource" } }, "type": "object", "required": [ "has_successful_run", "source" ], "title": "BasicCCPairInfo" }, "IndexAttemptSnapshot": { "properties": { "id": { "type": "integer", "title": "Id" }, "status": { "anyOf": [ { "$ref": "#/components/schemas/IndexingStatus" }, { "type": "null" } ] }, "from_beginning": { "type": "boolean", "title": "From Beginning" }, "new_docs_indexed": { "type": "integer", "title": "New Docs Indexed" }, "total_docs_indexed": { "type": "integer", "title": "Total Docs Indexed" }, "docs_removed_from_index": { "type": "integer", "title": "Docs Removed From Index" }, "error_msg": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error Msg" }, "error_count": { "type": "integer", "title": "Error Count" }, "full_exception_trace": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Full Exception Trace" }, "time_started": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Time Started" }, "time_updated": { "type": "string", "title": "Time Updated" }, "poll_range_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Poll Range Start" }, "poll_range_end": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Poll Range End" } }, "type": "object", "required": [ "id", "status", "from_beginning", "new_docs_indexed", "total_docs_indexed", "docs_removed_from_index", "error_msg", "error_count", "full_exception_trace", "time_started", "time_updated" ], "title": "IndexAttemptSnapshot" }, "UserPreferences": { "properties": { "chosen_assistants": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "title": "Chosen Assistants" }, "hidden_assistants": { "items": { "type": "integer" }, "type": "array", "title": "Hidden Assistants", "default": [] }, "visible_assistants": { "items": { "type": "integer" }, "type": "array", "title": "Visible Assistants", "default": [] }, "default_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Default Model" }, "pinned_assistants": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "title": "Pinned Assistants" }, "shortcut_enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Shortcut Enabled" }, "auto_scroll": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Auto Scroll" }, "temperature_override_enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Temperature Override Enabled" }, "theme_preference": { "anyOf": [ { "$ref": "#/components/schemas/ThemePreference" }, { "type": "null" } ] }, "assistant_specific_configs": { "anyOf": [ { "additionalProperties": { "$ref": "#/components/schemas/UserSpecificAssistantPreference" }, "type": "object" }, { "type": "null" } ], "title": "Assistant Specific Configs" } }, "type": "object", "title": "UserPreferences" }, "ConnectorUpdateRequest": { "properties": { "name": { "type": "string", "title": "Name" }, "source": { "$ref": "#/components/schemas/DocumentSource" }, "input_type": { "$ref": "#/components/schemas/InputType" }, "connector_specific_config": { "additionalProperties": true, "type": "object", "title": "Connector Specific Config" }, "refresh_freq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Refresh Freq" }, "prune_freq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Prune Freq" }, "indexing_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Indexing Start" }, "access_type": { "$ref": "#/components/schemas/AccessType" }, "groups": { "items": { "type": "integer" }, "type": "array", "title": "Groups" } }, "type": "object", "required": [ "name", "source", "input_type", "connector_specific_config", "access_type" ], "title": "ConnectorUpdateRequest" }, "PythonToolStart": { "properties": { "type": { "type": "string", "const": "python_tool_start", "title": "Type", "default": "python_tool_start" }, "code": { "type": "string", "title": "Code" } }, "type": "object", "required": [ "code" ], "title": "PythonToolStart" }, "RunConnectorRequest": { "properties": { "connector_id": { "type": "integer", "title": "Connector Id" }, "credential_ids": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "title": "Credential Ids" }, "from_beginning": { "type": "boolean", "title": "From Beginning", "default": false } }, "type": "object", "required": [ "connector_id" ], "title": "RunConnectorRequest" }, "Tag": { "properties": { "tag_key": { "type": "string", "title": "Tag Key" }, "tag_value": { "type": "string", "title": "Tag Value" } }, "type": "object", "required": [ "tag_key", "tag_value" ], "title": "Tag" }, "UserRole": { "type": "string", "enum": [ "limited", "basic", "admin", "curator", "global_curator", "slack_user", "ext_perm_user" ], "title": "UserRole", "description": "User roles\n- Basic can't perform any admin actions\n- Admin can perform all admin actions\n- Curator can perform admin actions for\n groups they are curators of\n- Global Curator can perform admin actions\n for all groups they are a member of\n- Limited can access a limited set of basic api endpoints\n- Slack are users that have used onyx via slack but dont have a web login\n- External permissioned users that have been picked up during the external permissions sync process but don't have a web login" }, "ConnectorStatus": { "properties": { "cc_pair_id": { "type": "integer", "title": "Cc Pair Id" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "connector": { "$ref": "#/components/schemas/ConnectorSnapshot" }, "credential": { "$ref": "#/components/schemas/CredentialSnapshot" }, "access_type": { "$ref": "#/components/schemas/AccessType" }, "groups": { "items": { "type": "integer" }, "type": "array", "title": "Groups" } }, "type": "object", "required": [ "cc_pair_id", "name", "connector", "credential", "access_type", "groups" ], "title": "ConnectorStatus", "description": "Represents the status of a connector,\nincluding indexing status elated information" }, "ConnectorCredentialPairStatus": { "type": "string", "enum": [ "SCHEDULED", "INITIAL_INDEXING", "ACTIVE", "PAUSED", "DELETING", "INVALID" ], "title": "ConnectorCredentialPairStatus" }, "ConnectorIndexingStatusLite": { "properties": { "cc_pair_id": { "type": "integer", "title": "Cc Pair Id" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "source": { "$ref": "#/components/schemas/DocumentSource" }, "access_type": { "$ref": "#/components/schemas/AccessType" }, "cc_pair_status": { "$ref": "#/components/schemas/ConnectorCredentialPairStatus" }, "in_progress": { "type": "boolean", "title": "In Progress" }, "in_repeated_error_state": { "type": "boolean", "title": "In Repeated Error State" }, "last_finished_status": { "anyOf": [ { "$ref": "#/components/schemas/IndexingStatus" }, { "type": "null" } ] }, "last_status": { "anyOf": [ { "$ref": "#/components/schemas/IndexingStatus" }, { "type": "null" } ] }, "last_success": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Success" }, "is_editable": { "type": "boolean", "title": "Is Editable" }, "docs_indexed": { "type": "integer", "title": "Docs Indexed" }, "latest_index_attempt_docs_indexed": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Latest Index Attempt Docs Indexed" } }, "type": "object", "required": [ "cc_pair_id", "name", "source", "access_type", "cc_pair_status", "in_progress", "in_repeated_error_state", "last_finished_status", "last_status", "last_success", "is_editable", "docs_indexed", "latest_index_attempt_docs_indexed" ], "title": "ConnectorIndexingStatusLite" }, "CredentialSwapRequest": { "properties": { "new_credential_id": { "type": "integer", "title": "New Credential Id" }, "connector_id": { "type": "integer", "title": "Connector Id" }, "access_type": { "$ref": "#/components/schemas/AccessType" } }, "type": "object", "required": [ "new_credential_id", "connector_id", "access_type" ], "title": "CredentialSwapRequest" }, "StatusResponse": { "properties": { "success": { "type": "boolean", "title": "Success" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message" }, "data": { "anyOf": [ {}, { "type": "null" } ], "title": "Data" } }, "type": "object", "required": [ "success" ], "title": "StatusResponse" }, "OpenUrlUrls": { "properties": { "type": { "type": "string", "const": "open_url_urls", "title": "Type", "default": "open_url_urls" }, "urls": { "items": { "type": "string" }, "type": "array", "title": "Urls" } }, "type": "object", "required": [ "urls" ], "title": "OpenUrlUrls", "description": "URLs to be fetched (sent before crawling begins)." }, "Body_upload_files_api_manage_admin_connector_file_upload_post": { "properties": { "files": { "items": { "type": "string", "format": "binary" }, "type": "array", "title": "Files" } }, "type": "object", "required": [ "files" ], "title": "Body_upload_files_api_manage_admin_connector_file_upload_post" }, "SavedSearchDocWithContent": { "properties": { "document_id": { "type": "string", "title": "Document Id" }, "chunk_ind": { "type": "integer", "title": "Chunk Ind" }, "semantic_identifier": { "type": "string", "title": "Semantic Identifier" }, "link": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Link" }, "blurb": { "type": "string", "title": "Blurb" }, "source_type": { "$ref": "#/components/schemas/DocumentSource" }, "boost": { "type": "integer", "title": "Boost" }, "hidden": { "type": "boolean", "title": "Hidden" }, "metadata": { "additionalProperties": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ] }, "type": "object", "title": "Metadata" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Score", "default": 0.0 }, "is_relevant": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Relevant" }, "relevance_explanation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Relevance Explanation" }, "match_highlights": { "items": { "type": "string" }, "type": "array", "title": "Match Highlights" }, "updated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Updated At" }, "primary_owners": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Primary Owners" }, "secondary_owners": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Secondary Owners" }, "is_internet": { "type": "boolean", "title": "Is Internet", "default": false }, "db_doc_id": { "type": "integer", "title": "Db Doc Id" }, "content": { "type": "string", "title": "Content" } }, "type": "object", "required": [ "document_id", "chunk_ind", "semantic_identifier", "blurb", "source_type", "boost", "hidden", "metadata", "match_highlights", "db_doc_id", "content" ], "title": "SavedSearchDocWithContent", "description": "Used for endpoints that need to return the actual contents of the retrieved\nsection in addition to the match_highlights." }, "DocumentSetSummary": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "type": "string", "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "cc_pair_summaries": { "items": { "$ref": "#/components/schemas/CCPairSummary" }, "type": "array", "title": "Cc Pair Summaries" }, "is_up_to_date": { "type": "boolean", "title": "Is Up To Date" }, "is_public": { "type": "boolean", "title": "Is Public" }, "users": { "items": { "type": "string", "format": "uuid" }, "type": "array", "title": "Users" }, "groups": { "items": { "type": "integer" }, "type": "array", "title": "Groups" }, "federated_connector_summaries": { "items": { "$ref": "#/components/schemas/FederatedConnectorSummary" }, "type": "array", "title": "Federated Connector Summaries" } }, "type": "object", "required": [ "id", "name", "description", "cc_pair_summaries", "is_up_to_date", "is_public", "users", "groups" ], "title": "DocumentSetSummary", "description": "Simplified document set model with minimal data for list views" }, "UserFileSnapshot": { "properties": { "id": { "type": "string", "format": "uuid", "title": "Id" }, "temp_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Temp Id" }, "name": { "type": "string", "title": "Name" }, "project_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Project Id" }, "user_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "User Id" }, "file_id": { "type": "string", "title": "File Id" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "status": { "$ref": "#/components/schemas/UserFileStatus" }, "last_accessed_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Accessed At" }, "file_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "File Type" }, "chat_file_type": { "$ref": "#/components/schemas/ChatFileType" }, "token_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Token Count" }, "chunk_count": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Chunk Count" } }, "type": "object", "required": [ "id", "name", "user_id", "file_id", "created_at", "status", "last_accessed_at", "file_type", "chat_file_type", "token_count", "chunk_count" ], "title": "UserFileSnapshot" }, "ImageGenerationToolStart": { "properties": { "type": { "type": "string", "const": "image_generation_start", "title": "Type", "default": "image_generation_start" } }, "type": "object", "title": "ImageGenerationToolStart" }, "RetrievalDetails": { "properties": { "chunks_above": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Chunks Above" }, "chunks_below": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Chunks Below" }, "full_doc": { "type": "boolean", "title": "Full Doc", "default": false }, "run_search": { "$ref": "#/components/schemas/OptionalSearchSetting", "default": "auto" }, "real_time": { "type": "boolean", "title": "Real Time", "default": true }, "filters": { "anyOf": [ { "$ref": "#/components/schemas/BaseFilters" }, { "type": "null" } ] }, "enable_auto_detect_filters": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enable Auto Detect Filters" }, "offset": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Offset" }, "limit": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Limit" }, "dedupe_docs": { "type": "boolean", "title": "Dedupe Docs", "default": false } }, "type": "object", "title": "RetrievalDetails" }, "OverallStop": { "properties": { "type": { "type": "string", "const": "stop", "title": "Type", "default": "stop" }, "stop_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Stop Reason" } }, "type": "object", "title": "OverallStop" }, "ValidateToolResponse": { "properties": { "methods": { "items": { "$ref": "#/components/schemas/MethodSpec" }, "type": "array", "title": "Methods" } }, "type": "object", "required": [ "methods" ], "title": "ValidateToolResponse" }, "Body_upload_user_files_user_projects_file_upload_post": { "properties": { "files": { "items": { "type": "string", "format": "binary" }, "type": "array", "title": "Files" }, "project_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Project Id" }, "temp_id_map": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Temp Id Map" } }, "type": "object", "required": [ "files" ], "title": "Body_upload_user_files_user_projects_file_upload_post" }, "DeepResearchPlanDelta": { "properties": { "type": { "type": "string", "const": "deep_research_plan_delta", "title": "Type", "default": "deep_research_plan_delta" }, "content": { "type": "string", "title": "Content" } }, "type": "object", "required": [ "content" ], "title": "DeepResearchPlanDelta" }, "ImageGenerationFinal": { "properties": { "type": { "type": "string", "const": "image_generation_final", "title": "Type", "default": "image_generation_final" }, "images": { "items": { "$ref": "#/components/schemas/GeneratedImage" }, "type": "array", "title": "Images" } }, "type": "object", "required": [ "images" ], "title": "ImageGenerationFinal" }, "MethodSpec": { "properties": { "name": { "type": "string", "title": "Name" }, "summary": { "type": "string", "title": "Summary" }, "path": { "type": "string", "title": "Path" }, "method": { "type": "string", "title": "Method" }, "spec": { "additionalProperties": true, "type": "object", "title": "Spec" } }, "type": "object", "required": [ "name", "summary", "path", "method", "spec" ], "title": "MethodSpec" }, "GeneratedImage": { "properties": { "file_id": { "type": "string", "title": "File Id" }, "url": { "type": "string", "title": "Url" }, "revised_prompt": { "type": "string", "title": "Revised Prompt" }, "shape": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Shape" } }, "type": "object", "required": [ "file_id", "url", "revised_prompt" ], "title": "GeneratedImage", "description": "Represents an image generated by an image generation tool." }, "PaginatedReturn_FullUserSnapshot_": { "properties": { "items": { "items": { "$ref": "#/components/schemas/FullUserSnapshot" }, "type": "array", "title": "Items" }, "total_items": { "type": "integer", "title": "Total Items" } }, "type": "object", "required": [ "items", "total_items" ], "title": "PaginatedReturn[FullUserSnapshot]" }, "CCPairSummary": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "source": { "$ref": "#/components/schemas/DocumentSource" }, "access_type": { "$ref": "#/components/schemas/AccessType" } }, "type": "object", "required": [ "id", "name", "source", "access_type" ], "title": "CCPairSummary", "description": "Simplified connector-credential pair information with just essential data" }, "WebSearchToolRequest": { "properties": { "queries": { "items": { "type": "string" }, "type": "array", "minItems": 1, "title": "Queries", "description": "List of search queries to send to the configured provider." }, "max_results": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Results", "description": "Optional cap on number of results to return per query. Defaults to 10.", "default": 10 } }, "type": "object", "required": [ "queries" ], "title": "WebSearchToolRequest" }, "Body_update_credential_private_key_manage_admin_credential_private_key__credential_id__put": { "properties": { "name": { "type": "string", "title": "Name" }, "credential_json": { "type": "string", "title": "Credential Json" }, "uploaded_file": { "type": "string", "format": "binary", "title": "Uploaded File" }, "field_key": { "type": "string", "title": "Field Key" }, "type_definition_key": { "type": "string", "title": "Type Definition Key" } }, "type": "object", "required": [ "name", "credential_json", "uploaded_file", "field_key", "type_definition_key" ], "title": "Body_update_credential_private_key_manage_admin_credential_private_key__credential_id__put" }, "CredentialSnapshot": { "properties": { "credential_json": { "additionalProperties": true, "type": "object", "title": "Credential Json" }, "admin_public": { "type": "boolean", "title": "Admin Public" }, "source": { "$ref": "#/components/schemas/DocumentSource" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "curator_public": { "type": "boolean", "title": "Curator Public", "default": false }, "groups": { "items": { "type": "integer" }, "type": "array", "title": "Groups" }, "is_user_file": { "type": "boolean", "title": "Is User File", "default": false }, "id": { "type": "integer", "title": "Id" }, "user_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "User Id" }, "user_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "User Email" }, "time_created": { "type": "string", "format": "date-time", "title": "Time Created" }, "time_updated": { "type": "string", "format": "date-time", "title": "Time Updated" } }, "type": "object", "required": [ "credential_json", "admin_public", "source", "id", "user_id", "time_created", "time_updated" ], "title": "CredentialSnapshot" }, "TokenRateLimitArgs": { "properties": { "enabled": { "type": "boolean", "title": "Enabled" }, "token_budget": { "type": "integer", "title": "Token Budget" }, "period_hours": { "type": "integer", "title": "Period Hours" } }, "type": "object", "required": [ "enabled", "token_budget", "period_hours" ], "title": "TokenRateLimitArgs" }, "DocsCountOperator": { "type": "string", "enum": [ ">", "<", "=" ], "title": "DocsCountOperator" }, "Body_update_connector_files_manage_admin_connector__connector_id__files_update_post": { "properties": { "files": { "anyOf": [ { "items": { "type": "string", "format": "binary" }, "type": "array" }, { "type": "null" } ], "title": "Files" }, "file_ids_to_remove": { "type": "string", "title": "File Ids To Remove", "default": "[]" } }, "type": "object", "title": "Body_update_connector_files_manage_admin_connector__connector_id__files_update_post" }, "ChatSessionGroup": { "properties": { "title": { "type": "string", "title": "Title" }, "chats": { "items": { "$ref": "#/components/schemas/ChatSessionSummary" }, "type": "array", "title": "Chats" } }, "type": "object", "required": [ "title", "chats" ], "title": "ChatSessionGroup" }, "OpenUrlsToolRequest": { "properties": { "urls": { "items": { "type": "string" }, "type": "array", "minItems": 1, "title": "Urls", "description": "URLs to fetch using the configured content provider." } }, "type": "object", "required": [ "urls" ], "title": "OpenUrlsToolRequest" }, "TokenRateLimitDisplay": { "properties": { "token_id": { "type": "integer", "title": "Token Id" }, "enabled": { "type": "boolean", "title": "Enabled" }, "token_budget": { "type": "integer", "title": "Token Budget" }, "period_hours": { "type": "integer", "title": "Period Hours" } }, "type": "object", "required": [ "token_id", "enabled", "token_budget", "period_hours" ], "title": "TokenRateLimitDisplay" }, "ChatSessionDetails": { "properties": { "id": { "type": "string", "format": "uuid", "title": "Id" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "persona_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Persona Id" }, "time_created": { "type": "string", "title": "Time Created" }, "time_updated": { "type": "string", "title": "Time Updated" }, "shared_status": { "$ref": "#/components/schemas/ChatSessionSharedStatus" }, "current_alternate_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Current Alternate Model" }, "current_temperature_override": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Current Temperature Override" } }, "type": "object", "required": [ "id", "name", "time_created", "time_updated", "shared_status" ], "title": "ChatSessionDetails" }, "ConnectorCredentialPairIdentifier": { "properties": { "connector_id": { "type": "integer", "title": "Connector Id" }, "credential_id": { "type": "integer", "title": "Credential Id" } }, "type": "object", "required": [ "connector_id", "credential_id" ], "title": "ConnectorCredentialPairIdentifier" }, "PromptOverrideConfig": { "properties": { "name": { "type": "string", "title": "Name" }, "description": { "type": "string", "title": "Description", "default": "" }, "system_prompt": { "type": "string", "title": "System Prompt" }, "task_prompt": { "type": "string", "title": "Task Prompt", "default": "" }, "datetime_aware": { "type": "boolean", "title": "Datetime Aware", "default": true }, "include_citations": { "type": "boolean", "title": "Include Citations", "default": true } }, "type": "object", "required": [ "name", "system_prompt" ], "title": "PromptOverrideConfig" }, "IntermediateReportCitedDocs": { "properties": { "type": { "type": "string", "const": "intermediate_report_cited_docs", "title": "Type", "default": "intermediate_report_cited_docs" }, "cited_docs": { "anyOf": [ { "items": { "$ref": "#/components/schemas/SearchDoc" }, "type": "array" }, { "type": "null" } ], "title": "Cited Docs" } }, "type": "object", "title": "IntermediateReportCitedDocs" }, "CreateChatMessageRequest": { "properties": { "chunks_above": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Chunks Above" }, "chunks_below": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Chunks Below" }, "full_doc": { "type": "boolean", "title": "Full Doc", "default": false }, "chat_session_id": { "type": "string", "format": "uuid", "title": "Chat Session Id" }, "parent_message_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Parent Message Id" }, "message": { "type": "string", "title": "Message" }, "file_descriptors": { "items": { "$ref": "#/components/schemas/FileDescriptor" }, "type": "array", "title": "File Descriptors", "default": [] }, "search_doc_ids": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "title": "Search Doc Ids" }, "retrieval_options": { "anyOf": [ { "$ref": "#/components/schemas/RetrievalDetails" }, { "type": "null" } ] }, "rerank_settings": { "anyOf": [ { "$ref": "#/components/schemas/RerankingDetails" }, { "type": "null" } ] }, "query_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Query Override" }, "regenerate": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Regenerate" }, "llm_override": { "anyOf": [ { "$ref": "#/components/schemas/LLMOverride" }, { "type": "null" } ] }, "prompt_override": { "anyOf": [ { "$ref": "#/components/schemas/PromptOverride" }, { "type": "null" } ] }, "temperature_override": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Temperature Override" }, "alternate_assistant_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Alternate Assistant Id" }, "persona_override_config": { "anyOf": [ { "$ref": "#/components/schemas/PersonaOverrideConfig" }, { "type": "null" } ] }, "use_existing_user_message": { "type": "boolean", "title": "Use Existing User Message", "default": false }, "existing_assistant_message_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Existing Assistant Message Id" }, "structured_response_format": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Structured Response Format" }, "skip_gen_ai_answer_generation": { "type": "boolean", "title": "Skip Gen Ai Answer Generation", "default": false }, "allowed_tool_ids": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "title": "Allowed Tool Ids" }, "forced_tool_ids": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "title": "Forced Tool Ids" }, "deep_research": { "type": "boolean", "title": "Deep Research", "default": false } }, "type": "object", "required": [ "chat_session_id", "parent_message_id", "message", "search_doc_ids", "retrieval_options" ], "title": "CreateChatMessageRequest", "description": "Before creating messages, be sure to create a chat_session and get an id" }, "CredentialBase": { "properties": { "credential_json": { "additionalProperties": true, "type": "object", "title": "Credential Json" }, "admin_public": { "type": "boolean", "title": "Admin Public" }, "source": { "$ref": "#/components/schemas/DocumentSource" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "curator_public": { "type": "boolean", "title": "Curator Public", "default": false }, "groups": { "items": { "type": "integer" }, "type": "array", "title": "Groups" }, "is_user_file": { "type": "boolean", "title": "Is User File", "default": false } }, "type": "object", "required": [ "credential_json", "admin_public", "source" ], "title": "CredentialBase" }, "ReasoningStart": { "properties": { "type": { "type": "string", "const": "reasoning_start", "title": "Type", "default": "reasoning_start" } }, "type": "object", "title": "ReasoningStart" }, "FileUploadResponse": { "properties": { "file_paths": { "items": { "type": "string" }, "type": "array", "title": "File Paths" }, "file_names": { "items": { "type": "string" }, "type": "array", "title": "File Names" }, "zip_metadata": { "additionalProperties": true, "type": "object", "title": "Zip Metadata" } }, "type": "object", "required": [ "file_paths", "file_names", "zip_metadata" ], "title": "FileUploadResponse" }, "CCPairFullInfo": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "type": "string", "title": "Name" }, "status": { "$ref": "#/components/schemas/ConnectorCredentialPairStatus" }, "in_repeated_error_state": { "type": "boolean", "title": "In Repeated Error State" }, "num_docs_indexed": { "type": "integer", "title": "Num Docs Indexed" }, "connector": { "$ref": "#/components/schemas/ConnectorSnapshot" }, "credential": { "$ref": "#/components/schemas/CredentialSnapshot" }, "number_of_index_attempts": { "type": "integer", "title": "Number Of Index Attempts" }, "last_index_attempt_status": { "anyOf": [ { "$ref": "#/components/schemas/IndexingStatus" }, { "type": "null" } ] }, "latest_deletion_attempt": { "anyOf": [ { "$ref": "#/components/schemas/DeletionAttemptSnapshot" }, { "type": "null" } ] }, "access_type": { "$ref": "#/components/schemas/AccessType" }, "is_editable_for_current_user": { "type": "boolean", "title": "Is Editable For Current User" }, "deletion_failure_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Deletion Failure Message" }, "indexing": { "type": "boolean", "title": "Indexing" }, "creator": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Creator" }, "creator_email": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Creator Email" }, "last_indexed": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Indexed" }, "last_pruned": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Pruned" }, "last_full_permission_sync": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Full Permission Sync" }, "overall_indexing_speed": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Overall Indexing Speed" }, "latest_checkpoint_description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Latest Checkpoint Description" }, "last_permission_sync_attempt_status": { "anyOf": [ { "$ref": "#/components/schemas/PermissionSyncStatus" }, { "type": "null" } ] }, "permission_syncing": { "type": "boolean", "title": "Permission Syncing" }, "last_permission_sync_attempt_finished": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Last Permission Sync Attempt Finished" }, "last_permission_sync_attempt_error_message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Permission Sync Attempt Error Message" } }, "type": "object", "required": [ "id", "name", "status", "in_repeated_error_state", "num_docs_indexed", "connector", "credential", "number_of_index_attempts", "last_index_attempt_status", "latest_deletion_attempt", "access_type", "is_editable_for_current_user", "deletion_failure_message", "indexing", "creator", "creator_email", "last_indexed", "last_pruned", "last_full_permission_sync", "overall_indexing_speed", "latest_checkpoint_description", "last_permission_sync_attempt_status", "permission_syncing", "last_permission_sync_attempt_finished", "last_permission_sync_attempt_error_message" ], "title": "CCPairFullInfo" }, "CategorizedFilesSnapshot": { "properties": { "user_files": { "items": { "$ref": "#/components/schemas/UserFileSnapshot" }, "type": "array", "title": "User Files" }, "non_accepted_files": { "items": { "type": "string" }, "type": "array", "title": "Non Accepted Files" }, "unsupported_files": { "items": { "type": "string" }, "type": "array", "title": "Unsupported Files" } }, "type": "object", "required": [ "user_files", "non_accepted_files", "unsupported_files" ], "title": "CategorizedFilesSnapshot" }, "StatusResponse_int_": { "properties": { "success": { "type": "boolean", "title": "Success" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message" }, "data": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Data" } }, "type": "object", "required": [ "success" ], "title": "StatusResponse[int]" }, "FederatedConnectorSummary": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "type": "string", "title": "Name" }, "source": { "$ref": "#/components/schemas/FederatedConnectorSource" }, "entities": { "additionalProperties": true, "type": "object", "title": "Entities" } }, "type": "object", "required": [ "id", "name", "source", "entities" ], "title": "FederatedConnectorSummary", "description": "Simplified federated connector information with just essential data" }, "ConnectorCredentialPairMetadata": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "access_type": { "$ref": "#/components/schemas/AccessType" }, "auto_sync_options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Auto Sync Options" }, "groups": { "items": { "type": "integer" }, "type": "array", "title": "Groups" } }, "type": "object", "required": [ "access_type" ], "title": "ConnectorCredentialPairMetadata" }, "SearchToolStart": { "properties": { "type": { "type": "string", "const": "search_tool_start", "title": "Type", "default": "search_tool_start" }, "is_internet_search": { "type": "boolean", "title": "Is Internet Search", "default": false } }, "type": "object", "title": "SearchToolStart" }, "LlmWebSearchResult": { "properties": { "document_citation_number": { "type": "integer", "title": "Document Citation Number" }, "unique_identifier_to_strip_away": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Unique Identifier To Strip Away" }, "type": { "type": "string", "const": "web_search", "title": "Type", "default": "web_search" }, "url": { "type": "string", "title": "Url" }, "title": { "type": "string", "title": "Title" }, "snippet": { "type": "string", "title": "Snippet" } }, "type": "object", "required": [ "document_citation_number", "url", "title", "snippet" ], "title": "LlmWebSearchResult", "description": "Result from a web search query" }, "UserFileIdsRequest": { "properties": { "file_ids": { "items": { "type": "string", "format": "uuid" }, "type": "array", "title": "File Ids" } }, "type": "object", "required": [ "file_ids" ], "title": "UserFileIdsRequest" }, "DocumentSearchPagination": { "properties": { "offset": { "type": "integer", "title": "Offset" }, "limit": { "type": "integer", "title": "Limit" }, "returned_count": { "type": "integer", "title": "Returned Count" }, "has_more": { "type": "boolean", "title": "Has More" }, "next_offset": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Next Offset" } }, "type": "object", "required": [ "offset", "limit", "returned_count", "has_more" ], "title": "DocumentSearchPagination" }, "DocumentSearchRequest": { "properties": { "chunks_above": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Chunks Above" }, "chunks_below": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Chunks Below" }, "full_doc": { "type": "boolean", "title": "Full Doc", "default": false }, "message": { "type": "string", "title": "Message" }, "search_type": { "$ref": "#/components/schemas/SearchType" }, "retrieval_options": { "$ref": "#/components/schemas/RetrievalDetails" }, "recency_bias_multiplier": { "type": "number", "title": "Recency Bias Multiplier", "default": 1.0 }, "evaluation_type": { "$ref": "#/components/schemas/LLMEvaluationType" }, "rerank_settings": { "anyOf": [ { "$ref": "#/components/schemas/RerankingDetails" }, { "type": "null" } ] } }, "type": "object", "required": [ "message", "search_type", "retrieval_options", "evaluation_type" ], "title": "DocumentSearchRequest" }, "PythonToolDelta": { "properties": { "type": { "type": "string", "const": "python_tool_delta", "title": "Type", "default": "python_tool_delta" }, "stdout": { "type": "string", "title": "Stdout", "default": "" }, "stderr": { "type": "string", "title": "Stderr", "default": "" }, "file_ids": { "items": { "type": "string" }, "type": "array", "title": "File Ids", "default": [] } }, "type": "object", "title": "PythonToolDelta" }, "TenantSnapshot": { "properties": { "number_of_users": { "type": "integer", "title": "Number Of Users" } }, "type": "object", "required": [ "number_of_users" ], "title": "TenantSnapshot" }, "CustomToolDelta": { "properties": { "type": { "type": "string", "const": "custom_tool_delta", "title": "Type", "default": "custom_tool_delta" }, "tool_name": { "type": "string", "title": "Tool Name" }, "response_type": { "type": "string", "title": "Response Type" }, "data": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "items": {}, "type": "array" }, { "type": "string" }, { "type": "integer" }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ], "title": "Data" }, "file_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "File Ids" } }, "type": "object", "required": [ "tool_name", "response_type" ], "title": "CustomToolDelta" }, "SourceSummary": { "properties": { "total_connectors": { "type": "integer", "title": "Total Connectors" }, "active_connectors": { "type": "integer", "title": "Active Connectors" }, "public_connectors": { "type": "integer", "title": "Public Connectors" }, "total_docs_indexed": { "type": "integer", "title": "Total Docs Indexed" } }, "type": "object", "required": [ "total_connectors", "active_connectors", "public_connectors", "total_docs_indexed" ], "title": "SourceSummary" }, "OpenUrlStart": { "properties": { "type": { "type": "string", "const": "open_url_start", "title": "Type", "default": "open_url_start" } }, "type": "object", "title": "OpenUrlStart", "description": "Signal that OpenURL tool has started." }, "StarterMessage": { "properties": { "name": { "type": "string", "title": "Name" }, "message": { "type": "string", "title": "Message" } }, "type": "object", "required": [ "name", "message" ], "title": "StarterMessage", "description": "Starter message for a persona." }, "IntermediateReportDelta": { "properties": { "type": { "type": "string", "const": "intermediate_report_delta", "title": "Type", "default": "intermediate_report_delta" }, "content": { "type": "string", "title": "Content" } }, "type": "object", "required": [ "content" ], "title": "IntermediateReportDelta" }, "Placement": { "properties": { "turn_index": { "type": "integer", "title": "Turn Index" }, "tab_index": { "type": "integer", "title": "Tab Index", "default": 0 }, "sub_turn_index": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Sub Turn Index" } }, "type": "object", "required": [ "turn_index" ], "title": "Placement" }, "AuthType": { "type": "string", "enum": [ "disabled", "basic", "google_oauth", "oidc", "saml", "cloud" ], "title": "AuthType" }, "InvitedUserSnapshot": { "properties": { "email": { "type": "string", "title": "Email" } }, "type": "object", "required": [ "email" ], "title": "InvitedUserSnapshot" }, "SavedSearchDoc": { "properties": { "document_id": { "type": "string", "title": "Document Id" }, "chunk_ind": { "type": "integer", "title": "Chunk Ind" }, "semantic_identifier": { "type": "string", "title": "Semantic Identifier" }, "link": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Link" }, "blurb": { "type": "string", "title": "Blurb" }, "source_type": { "$ref": "#/components/schemas/DocumentSource" }, "boost": { "type": "integer", "title": "Boost" }, "hidden": { "type": "boolean", "title": "Hidden" }, "metadata": { "additionalProperties": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ] }, "type": "object", "title": "Metadata" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Score", "default": 0.0 }, "is_relevant": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Relevant" }, "relevance_explanation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Relevance Explanation" }, "match_highlights": { "items": { "type": "string" }, "type": "array", "title": "Match Highlights" }, "updated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Updated At" }, "primary_owners": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Primary Owners" }, "secondary_owners": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Secondary Owners" }, "is_internet": { "type": "boolean", "title": "Is Internet", "default": false }, "db_doc_id": { "type": "integer", "title": "Db Doc Id" } }, "type": "object", "required": [ "document_id", "chunk_ind", "semantic_identifier", "blurb", "source_type", "boost", "hidden", "metadata", "match_highlights", "db_doc_id" ], "title": "SavedSearchDoc" }, "ProjectPayload": { "properties": { "project": { "$ref": "#/components/schemas/UserProjectSnapshot" }, "files": { "anyOf": [ { "items": { "$ref": "#/components/schemas/UserFileSnapshot" }, "type": "array" }, { "type": "null" } ], "title": "Files" }, "persona_id_to_is_default": { "anyOf": [ { "additionalProperties": { "type": "boolean" }, "type": "object" }, { "type": "null" } ], "title": "Persona Id To Is Default" } }, "type": "object", "required": [ "project" ], "title": "ProjectPayload" }, "ChatFileType": { "type": "string", "enum": [ "image", "document", "plain_text", "csv" ], "title": "ChatFileType" }, "SearchType": { "type": "string", "enum": [ "keyword", "semantic", "internet" ], "title": "SearchType" }, "FullPersonaSnapshot": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "type": "string", "title": "Name" }, "description": { "type": "string", "title": "Description" }, "is_public": { "type": "boolean", "title": "Is Public" }, "is_visible": { "type": "boolean", "title": "Is Visible" }, "uploaded_image_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Uploaded Image Id" }, "icon_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Icon Name" }, "user_file_ids": { "items": { "type": "string" }, "type": "array", "title": "User File Ids" }, "display_priority": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Display Priority" }, "is_default_persona": { "type": "boolean", "title": "Is Default Persona" }, "builtin_persona": { "type": "boolean", "title": "Builtin Persona" }, "starter_messages": { "anyOf": [ { "items": { "$ref": "#/components/schemas/StarterMessage" }, "type": "array" }, { "type": "null" } ], "title": "Starter Messages" }, "llm_relevance_filter": { "type": "boolean", "title": "Llm Relevance Filter", "default": false }, "llm_filter_extraction": { "type": "boolean", "title": "Llm Filter Extraction", "default": false }, "tools": { "items": { "$ref": "#/components/schemas/ToolSnapshot" }, "type": "array", "title": "Tools" }, "labels": { "items": { "$ref": "#/components/schemas/PersonaLabelSnapshot" }, "type": "array", "title": "Labels" }, "owner": { "anyOf": [ { "$ref": "#/components/schemas/MinimalUserSnapshot" }, { "type": "null" } ] }, "users": { "items": { "$ref": "#/components/schemas/MinimalUserSnapshot" }, "type": "array", "title": "Users" }, "groups": { "items": { "type": "integer" }, "type": "array", "title": "Groups" }, "document_sets": { "items": { "$ref": "#/components/schemas/DocumentSetSummary" }, "type": "array", "title": "Document Sets" }, "llm_model_provider_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Llm Model Provider Override" }, "llm_model_version_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Llm Model Version Override" }, "num_chunks": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Num Chunks" }, "system_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "System Prompt" }, "replace_base_system_prompt": { "type": "boolean", "title": "Replace Base System Prompt", "default": false }, "task_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Task Prompt" }, "datetime_aware": { "type": "boolean", "title": "Datetime Aware", "default": true }, "search_start_date": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Search Start Date" } }, "type": "object", "required": [ "id", "name", "description", "is_public", "is_visible", "uploaded_image_id", "icon_name", "user_file_ids", "display_priority", "is_default_persona", "builtin_persona", "starter_messages", "tools", "labels", "owner", "users", "groups", "document_sets", "llm_model_provider_override", "llm_model_version_override", "num_chunks" ], "title": "FullPersonaSnapshot" }, "FullUserSnapshot": { "properties": { "id": { "type": "string", "format": "uuid", "title": "Id" }, "email": { "type": "string", "title": "Email" }, "role": { "$ref": "#/components/schemas/UserRole" }, "is_active": { "type": "boolean", "title": "Is Active" }, "password_configured": { "type": "boolean", "title": "Password Configured" } }, "type": "object", "required": [ "id", "email", "role", "is_active", "password_configured" ], "title": "FullUserSnapshot" }, "SearchToolDocumentsDelta": { "properties": { "type": { "type": "string", "const": "search_tool_documents_delta", "title": "Type", "default": "search_tool_documents_delta" }, "documents": { "items": { "$ref": "#/components/schemas/SearchDoc" }, "type": "array", "title": "Documents" } }, "type": "object", "required": [ "documents" ], "title": "SearchToolDocumentsDelta" }, "InputType": { "type": "string", "enum": [ "load_state", "poll", "event", "slim_retrieval" ], "title": "InputType" }, "ReasoningDone": { "properties": { "type": { "type": "string", "const": "reasoning_done", "title": "Type", "default": "reasoning_done" } }, "type": "object", "title": "ReasoningDone" }, "WebSearchToolResponse": { "properties": { "results": { "items": { "$ref": "#/components/schemas/LlmWebSearchResult" }, "type": "array", "title": "Results" }, "provider_type": { "$ref": "#/components/schemas/WebSearchProviderType" } }, "type": "object", "required": [ "results", "provider_type" ], "title": "WebSearchToolResponse" }, "ConnectorIndexingStatusLiteResponse": { "properties": { "source": { "$ref": "#/components/schemas/DocumentSource" }, "summary": { "$ref": "#/components/schemas/SourceSummary" }, "current_page": { "type": "integer", "title": "Current Page" }, "total_pages": { "type": "integer", "title": "Total Pages" }, "indexing_statuses": { "items": { "anyOf": [ { "$ref": "#/components/schemas/ConnectorIndexingStatusLite" }, { "$ref": "#/components/schemas/FederatedConnectorStatus" } ] }, "type": "array", "title": "Indexing Statuses" } }, "type": "object", "required": [ "source", "summary", "current_page", "total_pages", "indexing_statuses" ], "title": "ConnectorIndexingStatusLiteResponse" }, "UserRoleUpdateRequest": { "properties": { "user_email": { "type": "string", "title": "User Email" }, "new_role": { "$ref": "#/components/schemas/UserRole" }, "explicit_override": { "type": "boolean", "title": "Explicit Override", "default": false } }, "type": "object", "required": [ "user_email", "new_role" ], "title": "UserRoleUpdateRequest" }, "WebSearchProviderType": { "type": "string", "enum": [ "google_pse", "serper", "exa", "searxng" ], "title": "WebSearchProviderType" }, "PersonaOverrideConfig": { "properties": { "name": { "type": "string", "title": "Name" }, "description": { "type": "string", "title": "Description" }, "search_type": { "$ref": "#/components/schemas/SearchType", "default": "semantic" }, "num_chunks": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Num Chunks" }, "llm_relevance_filter": { "type": "boolean", "title": "Llm Relevance Filter", "default": false }, "llm_filter_extraction": { "type": "boolean", "title": "Llm Filter Extraction", "default": false }, "recency_bias": { "$ref": "#/components/schemas/RecencyBiasSetting", "default": "auto" }, "llm_model_provider_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Llm Model Provider Override" }, "llm_model_version_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Llm Model Version Override" }, "prompts": { "items": { "$ref": "#/components/schemas/PromptOverrideConfig" }, "type": "array", "title": "Prompts" }, "document_set_ids": { "items": { "type": "integer" }, "type": "array", "title": "Document Set Ids" }, "tools": { "items": { "$ref": "#/components/schemas/ToolConfig" }, "type": "array", "title": "Tools" }, "tool_ids": { "items": { "type": "integer" }, "type": "array", "title": "Tool Ids" }, "custom_tools_openapi": { "items": { "additionalProperties": true, "type": "object" }, "type": "array", "title": "Custom Tools Openapi" } }, "type": "object", "required": [ "name", "description" ], "title": "PersonaOverrideConfig" }, "UserSpecificAssistantPreference": { "properties": { "disabled_tool_ids": { "items": { "type": "integer" }, "type": "array", "title": "Disabled Tool Ids" } }, "type": "object", "required": [ "disabled_tool_ids" ], "title": "UserSpecificAssistantPreference" }, "UserByEmail": { "properties": { "user_email": { "type": "string", "title": "User Email" } }, "type": "object", "required": [ "user_email" ], "title": "UserByEmail" }, "ImageGenerationToolHeartbeat": { "properties": { "type": { "type": "string", "const": "image_generation_heartbeat", "title": "Type", "default": "image_generation_heartbeat" } }, "type": "object", "title": "ImageGenerationToolHeartbeat" }, "LlmOpenUrlResult": { "properties": { "document_citation_number": { "type": "integer", "title": "Document Citation Number" }, "unique_identifier_to_strip_away": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Unique Identifier To Strip Away" }, "type": { "type": "string", "const": "open_url", "title": "Type", "default": "open_url" }, "content": { "type": "string", "title": "Content" } }, "type": "object", "required": [ "document_citation_number", "content" ], "title": "LlmOpenUrlResult", "description": "Result from opening/fetching a URL" }, "ConnectorFileInfo": { "properties": { "file_id": { "type": "string", "title": "File Id" }, "file_name": { "type": "string", "title": "File Name" }, "file_size": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "File Size" }, "upload_date": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Upload Date" } }, "type": "object", "required": [ "file_id", "file_name" ], "title": "ConnectorFileInfo" }, "RerankingDetails": { "properties": { "rerank_model_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rerank Model Name" }, "rerank_api_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rerank Api Url" }, "rerank_provider_type": { "anyOf": [ { "$ref": "#/components/schemas/RerankerProvider" }, { "type": "null" } ] }, "rerank_api_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rerank Api Key" }, "num_rerank": { "type": "integer", "title": "Num Rerank" }, "disable_rerank_for_streaming": { "type": "boolean", "title": "Disable Rerank For Streaming", "default": false } }, "type": "object", "required": [ "rerank_model_name", "rerank_api_url", "rerank_provider_type", "num_rerank" ], "title": "RerankingDetails" }, "CustomToolUpdate": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "definition": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Definition" }, "custom_headers": { "anyOf": [ { "items": { "$ref": "#/components/schemas/Header" }, "type": "array" }, { "type": "null" } ], "title": "Custom Headers" }, "passthrough_auth": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Passthrough Auth" }, "oauth_config_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Oauth Config Id" } }, "type": "object", "title": "CustomToolUpdate" }, "WebContentProviderType": { "type": "string", "enum": [ "onyx_web_crawler", "firecrawl" ], "title": "WebContentProviderType" }, "UpsertProjectInstructionsRequest": { "properties": { "instructions": { "type": "string", "title": "Instructions" } }, "type": "object", "required": [ "instructions" ], "title": "UpsertProjectInstructionsRequest" }, "ConnectorFilesResponse": { "properties": { "files": { "items": { "$ref": "#/components/schemas/ConnectorFileInfo" }, "type": "array", "title": "Files" } }, "type": "object", "required": [ "files" ], "title": "ConnectorFilesResponse" }, "WebSearchWithContentResponse": { "properties": { "search_provider_type": { "$ref": "#/components/schemas/WebSearchProviderType" }, "content_provider_type": { "anyOf": [ { "$ref": "#/components/schemas/WebContentProviderType" }, { "type": "null" } ] }, "search_results": { "items": { "$ref": "#/components/schemas/LlmWebSearchResult" }, "type": "array", "title": "Search Results" }, "full_content_results": { "items": { "$ref": "#/components/schemas/LlmOpenUrlResult" }, "type": "array", "title": "Full Content Results" } }, "type": "object", "required": [ "search_provider_type", "search_results", "full_content_results" ], "title": "WebSearchWithContentResponse" }, "UpdateProjectRequest": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" } }, "type": "object", "title": "UpdateProjectRequest" }, "PromptOverride": { "properties": { "system_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "System Prompt" }, "task_prompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Task Prompt" } }, "type": "object", "title": "PromptOverride" }, "UserFileStatus": { "type": "string", "enum": [ "PROCESSING", "COMPLETED", "FAILED", "CANCELED", "DELETING" ], "title": "UserFileStatus" }, "TaskStatus": { "type": "string", "enum": [ "PENDING", "STARTED", "SUCCESS", "FAILURE" ], "title": "TaskStatus" }, "ResearchAgentStart": { "properties": { "type": { "type": "string", "const": "research_agent_start", "title": "Type", "default": "research_agent_start" }, "research_task": { "type": "string", "title": "Research Task" } }, "type": "object", "required": [ "research_task" ], "title": "ResearchAgentStart" }, "SearchDoc": { "properties": { "document_id": { "type": "string", "title": "Document Id" }, "chunk_ind": { "type": "integer", "title": "Chunk Ind" }, "semantic_identifier": { "type": "string", "title": "Semantic Identifier" }, "link": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Link" }, "blurb": { "type": "string", "title": "Blurb" }, "source_type": { "$ref": "#/components/schemas/DocumentSource" }, "boost": { "type": "integer", "title": "Boost" }, "hidden": { "type": "boolean", "title": "Hidden" }, "metadata": { "additionalProperties": { "anyOf": [ { "type": "string" }, { "items": { "type": "string" }, "type": "array" } ] }, "type": "object", "title": "Metadata" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Score" }, "is_relevant": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Is Relevant" }, "relevance_explanation": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Relevance Explanation" }, "match_highlights": { "items": { "type": "string" }, "type": "array", "title": "Match Highlights" }, "updated_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Updated At" }, "primary_owners": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Primary Owners" }, "secondary_owners": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Secondary Owners" }, "is_internet": { "type": "boolean", "title": "Is Internet", "default": false } }, "type": "object", "required": [ "document_id", "chunk_ind", "semantic_identifier", "blurb", "source_type", "boost", "hidden", "metadata", "match_highlights" ], "title": "SearchDoc" }, "SendMessageRequest": { "properties": { "message": { "type": "string", "title": "Message" }, "llm_override": { "anyOf": [ { "$ref": "#/components/schemas/LLMOverride" }, { "type": "null" } ] }, "allowed_tool_ids": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "title": "Allowed Tool Ids" }, "forced_tool_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Forced Tool Id" }, "file_descriptors": { "items": { "$ref": "#/components/schemas/FileDescriptor" }, "type": "array", "title": "File Descriptors", "default": [] }, "internal_search_filters": { "anyOf": [ { "$ref": "#/components/schemas/BaseFilters" }, { "type": "null" } ] }, "deep_research": { "type": "boolean", "title": "Deep Research", "default": false }, "parent_message_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Parent Message Id", "default": -1 }, "chat_session_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ], "title": "Chat Session Id" }, "chat_session_info": { "anyOf": [ { "$ref": "#/components/schemas/ChatSessionCreationRequest" }, { "type": "null" } ] }, "stream": { "type": "boolean", "title": "Stream", "default": true } }, "type": "object", "required": [ "message" ], "title": "SendMessageRequest" }, "ConnectorSnapshot": { "properties": { "name": { "type": "string", "title": "Name" }, "source": { "$ref": "#/components/schemas/DocumentSource" }, "input_type": { "$ref": "#/components/schemas/InputType" }, "connector_specific_config": { "additionalProperties": true, "type": "object", "title": "Connector Specific Config" }, "refresh_freq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Refresh Freq" }, "prune_freq": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Prune Freq" }, "indexing_start": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Indexing Start" }, "id": { "type": "integer", "title": "Id" }, "credential_ids": { "items": { "type": "integer" }, "type": "array", "title": "Credential Ids" }, "time_created": { "type": "string", "format": "date-time", "title": "Time Created" }, "time_updated": { "type": "string", "format": "date-time", "title": "Time Updated" } }, "type": "object", "required": [ "name", "source", "input_type", "connector_specific_config", "id", "credential_ids", "time_created", "time_updated" ], "title": "ConnectorSnapshot" }, "VersionResponse": { "properties": { "backend_version": { "type": "string", "title": "Backend Version" } }, "type": "object", "required": [ "backend_version" ], "title": "VersionResponse" }, "AgentResponseStart": { "properties": { "type": { "type": "string", "const": "message_start", "title": "Type", "default": "message_start" }, "final_documents": { "anyOf": [ { "items": { "$ref": "#/components/schemas/SearchDoc" }, "type": "array" }, { "type": "null" } ], "title": "Final Documents" } }, "type": "object", "title": "AgentResponseStart" }, "CustomToolCreate": { "properties": { "name": { "type": "string", "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "definition": { "additionalProperties": true, "type": "object", "title": "Definition" }, "custom_headers": { "anyOf": [ { "items": { "$ref": "#/components/schemas/Header" }, "type": "array" }, { "type": "null" } ], "title": "Custom Headers" }, "passthrough_auth": { "type": "boolean", "title": "Passthrough Auth" }, "oauth_config_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Oauth Config Id" } }, "type": "object", "required": [ "name", "definition", "passthrough_auth" ], "title": "CustomToolCreate" }, "LLMEvaluationType": { "type": "string", "enum": [ "agentic", "basic", "skip", "unspecified" ], "title": "LLMEvaluationType" }, "CredentialDataUpdateRequest": { "properties": { "name": { "type": "string", "title": "Name" }, "credential_json": { "additionalProperties": true, "type": "object", "title": "Credential Json" } }, "type": "object", "required": [ "name", "credential_json" ], "title": "CredentialDataUpdateRequest" }, "AllUsersResponse": { "properties": { "accepted": { "items": { "$ref": "#/components/schemas/FullUserSnapshot" }, "type": "array", "title": "Accepted" }, "invited": { "items": { "$ref": "#/components/schemas/InvitedUserSnapshot" }, "type": "array", "title": "Invited" }, "slack_users": { "items": { "$ref": "#/components/schemas/FullUserSnapshot" }, "type": "array", "title": "Slack Users" }, "accepted_pages": { "type": "integer", "title": "Accepted Pages" }, "invited_pages": { "type": "integer", "title": "Invited Pages" }, "slack_users_pages": { "type": "integer", "title": "Slack Users Pages" } }, "type": "object", "required": [ "accepted", "invited", "slack_users", "accepted_pages", "invited_pages", "slack_users_pages" ], "title": "AllUsersResponse" }, "ChatSessionDetailResponse": { "properties": { "chat_session_id": { "type": "string", "format": "uuid", "title": "Chat Session Id" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "persona_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Persona Id" }, "persona_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Persona Name" }, "personal_icon_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Personal Icon Name" }, "messages": { "items": { "$ref": "#/components/schemas/ChatMessageDetail" }, "type": "array", "title": "Messages" }, "time_created": { "type": "string", "format": "date-time", "title": "Time Created" }, "shared_status": { "$ref": "#/components/schemas/ChatSessionSharedStatus" }, "current_alternate_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Current Alternate Model" }, "current_temperature_override": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Current Temperature Override" }, "deleted": { "type": "boolean", "title": "Deleted", "default": false }, "packets": { "items": { "items": { "$ref": "#/components/schemas/Packet" }, "type": "array" }, "type": "array", "title": "Packets" } }, "type": "object", "required": [ "chat_session_id", "description", "persona_name", "personal_icon_name", "messages", "time_created", "shared_status", "current_alternate_model", "current_temperature_override", "packets" ], "title": "ChatSessionDetailResponse" }, "DocumentSource": { "type": "string", "enum": [ "ingestion_api", "slack", "web", "google_drive", "gmail", "requesttracker", "github", "gitbook", "gitlab", "guru", "bookstack", "outline", "confluence", "jira", "slab", "productboard", "file", "coda", "notion", "zulip", "linear", "hubspot", "document360", "gong", "google_sites", "zendesk", "loopio", "dropbox", "sharepoint", "teams", "salesforce", "discourse", "axero", "clickup", "mediawiki", "wikipedia", "asana", "s3", "r2", "google_cloud_storage", "oci_storage", "xenforo", "not_applicable", "discord", "freshdesk", "fireflies", "egnyte", "airtable", "highspot", "drupal_wiki", "imap", "bitbucket", "testrail", "mock_connector", "user_file" ], "title": "DocumentSource" }, "PaginatedReturn_MinimalPersonaSnapshot_": { "properties": { "items": { "items": { "$ref": "#/components/schemas/MinimalPersonaSnapshot" }, "type": "array", "title": "Items" }, "total_items": { "type": "integer", "title": "Total Items" } }, "type": "object", "required": [ "items", "total_items" ], "title": "PaginatedReturn[MinimalPersonaSnapshot]" }, "PaginatedReturn_PersonaSnapshot_": { "properties": { "items": { "items": { "$ref": "#/components/schemas/PersonaSnapshot" }, "type": "array", "title": "Items" }, "total_items": { "type": "integer", "title": "Total Items" } }, "type": "object", "required": [ "items", "total_items" ], "title": "PaginatedReturn[PersonaSnapshot]" }, "ChatSessionSharedStatus": { "type": "string", "enum": [ "public", "private" ], "title": "ChatSessionSharedStatus" }, "ReasoningDelta": { "properties": { "type": { "type": "string", "const": "reasoning_delta", "title": "Type", "default": "reasoning_delta" }, "reasoning": { "type": "string", "title": "Reasoning" } }, "type": "object", "required": [ "reasoning" ], "title": "ReasoningDelta" }, "Body_bulk_invite_users_manage_admin_users_put": { "properties": { "emails": { "items": { "type": "string" }, "type": "array", "title": "Emails" } }, "type": "object", "required": [ "emails" ], "title": "Body_bulk_invite_users_manage_admin_users_put" }, "Body_create_credential_with_private_key_manage_credential_private_key_post": { "properties": { "credential_json": { "type": "string", "title": "Credential Json" }, "admin_public": { "type": "boolean", "title": "Admin Public", "default": false }, "curator_public": { "type": "boolean", "title": "Curator Public", "default": false }, "groups": { "items": { "type": "integer" }, "type": "array", "title": "Groups", "default": [] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "source": { "type": "string", "title": "Source" }, "uploaded_file": { "type": "string", "format": "binary", "title": "Uploaded File" }, "field_key": { "type": "string", "title": "Field Key" }, "type_definition_key": { "type": "string", "title": "Type Definition Key" } }, "type": "object", "required": [ "credential_json", "source", "uploaded_file", "field_key", "type_definition_key" ], "title": "Body_create_credential_with_private_key_manage_credential_private_key_post" }, "PersonaUpsertRequest": { "properties": { "name": { "type": "string", "title": "Name" }, "description": { "type": "string", "title": "Description" }, "document_set_ids": { "items": { "type": "integer" }, "type": "array", "title": "Document Set Ids" }, "num_chunks": { "type": "number", "title": "Num Chunks" }, "is_public": { "type": "boolean", "title": "Is Public" }, "recency_bias": { "$ref": "#/components/schemas/RecencyBiasSetting" }, "llm_filter_extraction": { "type": "boolean", "title": "Llm Filter Extraction" }, "llm_relevance_filter": { "type": "boolean", "title": "Llm Relevance Filter" }, "llm_model_provider_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Llm Model Provider Override" }, "llm_model_version_override": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Llm Model Version Override" }, "starter_messages": { "anyOf": [ { "items": { "$ref": "#/components/schemas/StarterMessage" }, "type": "array" }, { "type": "null" } ], "title": "Starter Messages" }, "users": { "items": { "type": "string", "format": "uuid" }, "type": "array", "title": "Users" }, "groups": { "items": { "type": "integer" }, "type": "array", "title": "Groups" }, "tool_ids": { "items": { "type": "integer" }, "type": "array", "title": "Tool Ids" }, "remove_image": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Remove Image" }, "uploaded_image_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Uploaded Image Id" }, "icon_name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Icon Name" }, "search_start_date": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Search Start Date" }, "label_ids": { "anyOf": [ { "items": { "type": "integer" }, "type": "array" }, { "type": "null" } ], "title": "Label Ids" }, "is_default_persona": { "type": "boolean", "title": "Is Default Persona", "default": false }, "display_priority": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Display Priority" }, "user_file_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "User File Ids" }, "system_prompt": { "type": "string", "title": "System Prompt" }, "replace_base_system_prompt": { "type": "boolean", "title": "Replace Base System Prompt", "default": false }, "task_prompt": { "type": "string", "title": "Task Prompt" }, "datetime_aware": { "type": "boolean", "title": "Datetime Aware" } }, "type": "object", "required": [ "name", "description", "document_set_ids", "num_chunks", "is_public", "recency_bias", "llm_filter_extraction", "llm_relevance_filter", "tool_ids", "system_prompt", "task_prompt", "datetime_aware" ], "title": "PersonaUpsertRequest" } }, "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Authorization header with Bearer token" } } } }