{ "openapi": "3.1.0", "info": { "title": "Onyx API", "description": "Onyx API for AI-powered enterprise search and chat", "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-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": { "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" }, "IndexedSourcesResponse": { "properties": { "sources": { "items": { "$ref": "#/components/schemas/DocumentSource" }, "type": "array", "title": "Sources" } }, "type": "object", "required": [ "sources" ], "title": "IndexedSourcesResponse" }, "RerankerProvider": { "type": "string", "enum": [ "cohere", "litellm", "bedrock" ], "title": "RerankerProvider" }, "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." }, "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" }, "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." }, "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" }, "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" }, "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" }, "ValidateToolRequest": { "properties": { "definition": { "additionalProperties": true, "type": "object", "title": "Definition" } }, "type": "object", "required": [ "definition" ], "title": "ValidateToolRequest" }, "ObjectCreationIdResponse": { "properties": { "id": { "type": "integer", "title": "Id" }, "credential": { "anyOf": [ { "$ref": "#/components/schemas/CredentialSnapshot" }, { "type": "null" } ] } }, "type": "object", "required": [ "id" ], "title": "ObjectCreationIdResponse" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "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" }, "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" }, "ChatSessionSharedStatus": { "type": "string", "enum": [ "public", "private" ], "title": "ChatSessionSharedStatus" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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]" }, "CreateChatSessionID": { "properties": { "chat_session_id": { "type": "string", "format": "uuid", "title": "Chat Session Id" } }, "type": "object", "required": [ "chat_session_id" ], "title": "CreateChatSessionID" }, "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" }, "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" }, "ProjectInstructionsResponse": { "properties": { "instructions": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Instructions" } }, "type": "object", "required": [ "instructions" ], "title": "ProjectInstructionsResponse" }, "RecencyBiasSetting": { "type": "string", "enum": [ "favor_recent", "base_decay", "no_decay", "auto" ], "title": "RecencyBiasSetting" }, "WebSearchProviderType": { "type": "string", "enum": [ "google_pse", "serper", "exa", "searxng" ], "title": "WebSearchProviderType" }, "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" }, "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]" }, "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" }, "TaskStatus": { "type": "string", "enum": [ "PENDING", "STARTED", "SUCCESS", "FAILURE" ], "title": "TaskStatus" }, "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]" }, "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" }, "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" }, "UserFileStatus": { "type": "string", "enum": [ "PROCESSING", "COMPLETED", "FAILED", "CANCELED", "DELETING" ], "title": "UserFileStatus" }, "WebContentProviderType": { "type": "string", "enum": [ "onyx_web_crawler", "firecrawl" ], "title": "WebContentProviderType" }, "ConnectorFilesResponse": { "properties": { "files": { "items": { "$ref": "#/components/schemas/ConnectorFileInfo" }, "type": "array", "title": "Files" } }, "type": "object", "required": [ "files" ], "title": "ConnectorFilesResponse" }, "ConnectorCredentialPairStatus": { "type": "string", "enum": [ "SCHEDULED", "INITIAL_INDEXING", "ACTIVE", "PAUSED", "DELETING", "INVALID" ], "title": "ConnectorCredentialPairStatus" }, "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" }, "InputType": { "type": "string", "enum": [ "load_state", "poll", "event", "slim_retrieval" ], "title": "InputType" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "ChatSessionsResponse": { "properties": { "sessions": { "items": { "$ref": "#/components/schemas/ChatSessionDetails" }, "type": "array", "title": "Sessions" } }, "type": "object", "required": [ "sessions" ], "title": "ChatSessionsResponse" }, "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" }, "ValidateToolResponse": { "properties": { "methods": { "items": { "$ref": "#/components/schemas/MethodSpec" }, "type": "array", "title": "Methods" } }, "type": "object", "required": [ "methods" ], "title": "ValidateToolResponse" }, "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" }, "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" }, "TenantSnapshot": { "properties": { "number_of_users": { "type": "integer", "title": "Number Of Users" } }, "type": "object", "required": [ "number_of_users" ], "title": "TenantSnapshot" }, "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" }, "UserSpecificAssistantPreference": { "properties": { "disabled_tool_ids": { "items": { "type": "integer" }, "type": "array", "title": "Disabled Tool Ids" } }, "type": "object", "required": [ "disabled_tool_ids" ], "title": "UserSpecificAssistantPreference" }, "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" }, "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" }, "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" }, "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" }, "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" }, "Header": { "properties": { "key": { "type": "string", "title": "Key" }, "value": { "type": "string", "title": "Value" } }, "type": "object", "required": [ "key", "value" ], "title": "Header" }, "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]" }, "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." }, "LLMEvaluationType": { "type": "string", "enum": [ "agentic", "basic", "skip", "unspecified" ], "title": "LLMEvaluationType" }, "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" }, "AgentResponseDelta": { "properties": { "type": { "type": "string", "const": "message_delta", "title": "Type", "default": "message_delta" }, "content": { "type": "string", "title": "Content" } }, "type": "object", "required": [ "content" ], "title": "AgentResponseDelta" }, "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" }, "SearchType": { "type": "string", "enum": [ "keyword", "semantic", "internet" ], "title": "SearchType" }, "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" }, "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" }, "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" }, "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" }, "ReasoningDelta": { "properties": { "type": { "type": "string", "const": "reasoning_delta", "title": "Type", "default": "reasoning_delta" }, "reasoning": { "type": "string", "title": "Reasoning" } }, "type": "object", "required": [ "reasoning" ], "title": "ReasoningDelta" }, "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]" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "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" }, "AccessType": { "type": "string", "enum": [ "public", "private", "sync" ], "title": "AccessType" }, "AuthType": { "type": "string", "enum": [ "disabled", "basic", "google_oauth", "oidc", "saml", "cloud" ], "title": "AuthType" }, "ChatFileType": { "type": "string", "enum": [ "image", "document", "plain_text", "csv" ], "title": "ChatFileType" }, "FederatedConnectorSource": { "type": "string", "enum": [ "federated_slack" ], "title": "FederatedConnectorSource" }, "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" }, "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" }, "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" }, "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]]" }, "IntermediateReportStart": { "properties": { "type": { "type": "string", "const": "intermediate_report_start", "title": "Type", "default": "intermediate_report_start" } }, "type": "object", "title": "IntermediateReportStart" }, "UpsertProjectInstructionsRequest": { "properties": { "instructions": { "type": "string", "title": "Instructions" } }, "type": "object", "required": [ "instructions" ], "title": "UpsertProjectInstructionsRequest" }, "InvitedUserSnapshot": { "properties": { "email": { "type": "string", "title": "Email" } }, "type": "object", "required": [ "email" ], "title": "InvitedUserSnapshot" }, "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" }, "ReasoningDone": { "properties": { "type": { "type": "string", "const": "reasoning_done", "title": "Type", "default": "reasoning_done" } }, "type": "object", "title": "ReasoningDone" }, "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" }, "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" }, "TenantInfo": { "properties": { "invitation": { "anyOf": [ { "$ref": "#/components/schemas/TenantSnapshot" }, { "type": "null" } ] }, "new_tenant": { "anyOf": [ { "$ref": "#/components/schemas/TenantSnapshot" }, { "type": "null" } ] } }, "type": "object", "title": "TenantInfo" }, "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" }, "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" }, "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" }, "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" }, "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" }, "IndexingStatus": { "type": "string", "enum": [ "not_started", "in_progress", "success", "canceled", "failed", "completed_with_errors" ], "title": "IndexingStatus" }, "ReasoningStart": { "properties": { "type": { "type": "string", "const": "reasoning_start", "title": "Type", "default": "reasoning_start" } }, "type": "object", "title": "ReasoningStart" }, "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" }, "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" }, "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" }, "CredentialDataUpdateRequest": { "properties": { "name": { "type": "string", "title": "Name" }, "credential_json": { "additionalProperties": true, "type": "object", "title": "Credential Json" } }, "type": "object", "required": [ "name", "credential_json" ], "title": "CredentialDataUpdateRequest" }, "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" }, "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" }, "DeepResearchPlanStart": { "properties": { "type": { "type": "string", "const": "deep_research_plan_start", "title": "Type", "default": "deep_research_plan_start" } }, "type": "object", "title": "DeepResearchPlanStart" }, "ThemePreference": { "type": "string", "enum": [ "light", "dark", "system" ], "title": "ThemePreference" }, "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" }, "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" }, "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" }, "DocsCountOperator": { "type": "string", "enum": [ ">", "<", "=" ], "title": "DocsCountOperator" }, "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)." }, "ImageGenerationToolHeartbeat": { "properties": { "type": { "type": "string", "const": "image_generation_heartbeat", "title": "Type", "default": "image_generation_heartbeat" } }, "type": "object", "title": "ImageGenerationToolHeartbeat" }, "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" }, "UserFileIdsRequest": { "properties": { "file_ids": { "items": { "type": "string", "format": "uuid" }, "type": "array", "title": "File Ids" } }, "type": "object", "required": [ "file_ids" ], "title": "UserFileIdsRequest" }, "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" }, "VersionResponse": { "properties": { "backend_version": { "type": "string", "title": "Backend Version" } }, "type": "object", "required": [ "backend_version" ], "title": "VersionResponse" }, "MessageType": { "type": "string", "enum": [ "system", "user", "assistant", "tool_call", "tool_call_response" ], "title": "MessageType" }, "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" }, "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" }, "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" }, "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" }, "UpdateProjectRequest": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" } }, "type": "object", "title": "UpdateProjectRequest" }, "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" }, "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" }, "SectionEnd": { "properties": { "type": { "type": "string", "const": "section_end", "title": "Type", "default": "section_end" } }, "type": "object", "title": "SectionEnd" }, "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" }, "ImageGenerationToolStart": { "properties": { "type": { "type": "string", "const": "image_generation_start", "title": "Type", "default": "image_generation_start" } }, "type": "object", "title": "ImageGenerationToolStart" }, "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." }, "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" }, "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" }, "ChatSeedResponse": { "properties": { "redirect_url": { "type": "string", "title": "Redirect Url" } }, "type": "object", "required": [ "redirect_url" ], "title": "ChatSeedResponse" }, "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]" }, "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" }, "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" }, "CCStatusUpdateRequest": { "properties": { "status": { "$ref": "#/components/schemas/ConnectorCredentialPairStatus" } }, "type": "object", "required": [ "status" ], "title": "CCStatusUpdateRequest" }, "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" }, "OptionalSearchSetting": { "type": "string", "enum": [ "always", "never", "auto" ], "title": "OptionalSearchSetting" }, "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" }, "ChatSessionGroup": { "properties": { "title": { "type": "string", "title": "Title" }, "chats": { "items": { "$ref": "#/components/schemas/ChatSessionSummary" }, "type": "array", "title": "Chats" } }, "type": "object", "required": [ "title", "chats" ], "title": "ChatSessionGroup" }, "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." }, "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" }, "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" }, "UserByEmail": { "properties": { "user_email": { "type": "string", "title": "User Email" } }, "type": "object", "required": [ "user_email" ], "title": "UserByEmail" }, "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" }, "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" }, "MinimalUserSnapshot": { "properties": { "id": { "type": "string", "format": "uuid", "title": "Id" }, "email": { "type": "string", "title": "Email" } }, "type": "object", "required": [ "id", "email" ], "title": "MinimalUserSnapshot" }, "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" }, "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" }, "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" }, "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" }, "PersonaLabelSnapshot": { "properties": { "id": { "type": "integer", "title": "Id" }, "name": { "type": "string", "title": "Name" } }, "type": "object", "required": [ "id", "name" ], "title": "PersonaLabelSnapshot" }, "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" }, "PermissionSyncStatus": { "type": "string", "enum": [ "not_started", "in_progress", "success", "canceled", "failed", "completed_with_errors" ], "title": "PermissionSyncStatus", "description": "Status enum for permission sync attempts" }, "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" }, "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" }, "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" }, "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" }, "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" } }, "securitySchemes": { "BearerAuth": { "type": "http", "scheme": "bearer", "description": "Authorization header with Bearer token" } } } }