conduit/openapi.json at main · JonKach/conduit · GitHub

1
{"openapi": "3.1.0", "info": {"title": "Conduit", "version": "0.1.0"}, "paths": {"/api/v1/login/access-token": {"post": {"tags": ["login"], "summary": "Login Access Token", "description": "OAuth2 compatible token login, get an access token for future requests", "operationId": "login-login_access_token", "requestBody": {"content": {"application/x-www-form-urlencoded": {"schema": {"$ref": "#/components/schemas/Body_login-login_access_token"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Token"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/login/test-token": {"post": {"tags": ["login"], "summary": "Test Token", "description": "Test access token", "operationId": "login-test_token", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserPublic"}}}}}, "security": [{"OAuth2PasswordBearer": []}]}}, "/api/v1/password-recovery/{email}": {"post": {"tags": ["login"], "summary": "Recover Password", "description": "Password Recovery", "operationId": "login-recover_password", "parameters": [{"name": "email", "in": "path", "required": true, "schema": {"type": "string", "title": "Email"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/reset-password/": {"post": {"tags": ["login"], "summary": "Reset Password", "description": "Reset password", "operationId": "login-reset_password", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/NewPassword"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/password-recovery-html-content/{email}": {"post": {"tags": ["login"], "summary": "Recover Password Html Content", "description": "HTML Content for Password Recovery", "operationId": "login-recover_password_html_content", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "email", "in": "path", "required": true, "schema": {"type": "string", "title": "Email"}}], "responses": {"200": {"description": "Successful Response", "content": {"text/html": {"schema": {"type": "string"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/users/": {"get": {"tags": ["users"], "summary": "Read Users", "description": "Retrieve users.", "operationId": "users-read_users", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "skip", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Skip"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 100, "title": "Limit"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UsersPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "post": {"tags": ["users"], "summary": "Create User", "description": "Create new user.", "operationId": "users-create_user", "security": [{"OAuth2PasswordBearer": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserCreate"}}}}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/users/me": {"get": {"tags": ["users"], "summary": "Read User Me", "description": "Get current user.", "operationId": "users-read_user_me", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserPublic"}}}}}, "security": [{"OAuth2PasswordBearer": []}]}, "delete": {"tags": ["users"], "summary": "Delete User Me", "description": "Delete own user.", "operationId": "users-delete_user_me", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}}, "security": [{"OAuth2PasswordBearer": []}]}, "patch": {"tags": ["users"], "summary": "Update User Me", "description": "Update own user.", "operationId": "users-update_user_me", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserUpdateMe"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"OAuth2PasswordBearer": []}]}}, "/api/v1/users/me/password": {"patch": {"tags": ["users"], "summary": "Update Password Me", "description": "Update own password.", "operationId": "users-update_password_me", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/UpdatePassword"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"OAuth2PasswordBearer": []}]}}, "/api/v1/users/signup": {"post": {"tags": ["users"], "summary": "Register User", "description": "Create new user without the need to be logged in.", "operationId": "users-register_user", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserRegister"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/users/{user_id}": {"get": {"tags": ["users"], "summary": "Read User By Id", "description": "Get a specific user by id.", "operationId": "users-read_user_by_id", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "user_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "User Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "patch": {"tags": ["users"], "summary": "Update User", "description": "Update a user.", "operationId": "users-update_user", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "user_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "User Id"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserUpdate"}}}}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "delete": {"tags": ["users"], "summary": "Delete User", "description": "Delete a user.", "operationId": "users-delete_user", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "user_id", "in": "path", "required": true, "schema": {"type": "string", "format": "uuid", "title": "User Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/utils/get-tools/": {"get": {"tags": ["utils"], "summary": "Get Tools", "description": "Get available tools.", "operationId": "utils-get_tools", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"items": {"type": "string"}, "type": "array", "title": "Response Utils-Get Tools"}}}}}}}, "/api/v1/utils/test-email/": {"post": {"tags": ["utils"], "summary": "Test Email", "description": "Test emails.", "operationId": "utils-test_email", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "email_to", "in": "query", "required": true, "schema": {"type": "string", "format": "email", "title": "Email To"}}], "responses": {"201": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/utils/health-check/": {"get": {"tags": ["utils"], "summary": "Health Check", "operationId": "utils-health_check", "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"type": "boolean", "title": "Response Utils-Health Check"}}}}}}}, "/api/v1/agents/me": {"get": {"tags": ["agents"], "summary": "Read Agents", "description": "Retrieve all agents associated with the current user's account.", "operationId": "agents-read_agents", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "skip", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Skip"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 100, "title": "Limit"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AgentsPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/public": {"get": {"tags": ["agents"], "summary": "Read Public Agents", "description": "Retrieve all public agents (marketplace). `sort=popular` orders by how\nmany users have added the agent to their own list.", "operationId": "agents-read_public_agents", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "skip", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Skip"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 100, "title": "Limit"}}, {"name": "sort", "in": "query", "required": false, "schema": {"enum": ["recent", "popular"], "type": "string", "default": "recent", "title": "Sort"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AgentsPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/added-public": {"get": {"tags": ["agents"], "summary": "Read Added Public Agents", "description": "Retrieve all public agents added by the current user.", "operationId": "agents-read_added_public_agents", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "skip", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Skip"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 100, "title": "Limit"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AgentsPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "post": {"tags": ["agents"], "summary": "Add Public Agent", "description": "Add a public agent to the current user's list of added public agents.", "operationId": "agents-add_public_agent", "security": [{"OAuth2PasswordBearer": []}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Body_agents-add_public_agent"}}}}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/{agent_id}": {"get": {"tags": ["agents"], "summary": "Read Agent", "description": "Get agent by ID.", "operationId": "agents-read_agent", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AgentPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "put": {"tags": ["agents"], "summary": "Update Agent", "description": "Update an agent.", "operationId": "agents-update_agent", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AgentUpdate"}}}}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AgentPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "delete": {"tags": ["agents"], "summary": "Delete Agent", "description": "Delete an agent.", "operationId": "agents-delete_agent", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/{agent_id}/profile-picture": {"get": {"tags": ["agents"], "summary": "Get Profile Picture", "description": "Get the profile picture of an agent.", "operationId": "agents-get_profile_picture", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"title": "Response Agents-Get Profile Picture"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "post": {"tags": ["agents"], "summary": "Upload Profile Picture", "operationId": "agents-upload_profile_picture", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}, {"name": "content-length", "in": "header", "required": true, "schema": {"type": "integer", "title": "Content-Length"}}], "requestBody": {"required": true, "content": {"multipart/form-data": {"schema": {"$ref": "#/components/schemas/Body_agents-upload_profile_picture"}}}}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "delete": {"tags": ["agents"], "summary": "Delete Profile Picture", "description": "Delete the profile picture of an agent.", "operationId": "agents-delete_profile_picture", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/": {"post": {"tags": ["agents"], "summary": "Create Agent", "description": "Create new agent.", "operationId": "agents-create_agent", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/AgentCreate"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/AgentPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}, "security": [{"OAuth2PasswordBearer": []}]}}, "/api/v1/agents/{agent_id}/skills": {"post": {"tags": ["agents"], "summary": "Upload Skill", "operationId": "agents-upload_skill", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}, {"name": "content-length", "in": "header", "required": true, "schema": {"type": "integer", "title": "Content-Length"}}], "requestBody": {"required": true, "content": {"multipart/form-data": {"schema": {"$ref": "#/components/schemas/Body_agents-upload_skill"}}}}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "get": {"tags": ["agents"], "summary": "Get Skill Names", "description": "Get all skill names for an agent.", "operationId": "agents-get_skill_names", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"title": "Response Agents-Get Skill Names"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/{agent_id}/skills/{skill_name}": {"get": {"tags": ["agents"], "summary": "Get Skill Content", "description": "Get the content of a specific skill for an agent.", "operationId": "agents-get_skill_content", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "skill_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Skill Name"}}, {"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"title": "Response Agents-Get Skill Content"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "delete": {"tags": ["agents"], "summary": "Delete Skill", "description": "Delete a skill from an agent.", "operationId": "agents-delete_skill", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "skill_name", "in": "path", "required": true, "schema": {"type": "string", "title": "Skill Name"}}, {"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/added-public/{agent_id}": {"delete": {"tags": ["agents"], "summary": "Remove Public Agent", "description": "Remove a public agent from the current user's list of added public agents.", "operationId": "agents-remove_public_agent", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/{agent_id}/threads/": {"post": {"tags": ["threads"], "summary": "Create Thread", "description": "Create a new thread.", "operationId": "threads-create_thread", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ThreadCreate"}}}}, "responses": {"201": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ThreadPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "get": {"tags": ["threads"], "summary": "Read Threads", "description": "Retrieve threads for an agent.", "operationId": "threads-read_threads", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}, {"name": "skip", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Skip"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 100, "title": "Limit"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ThreadsPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/{agent_id}/threads/{thread_id}/stop_stream": {"post": {"tags": ["threads"], "summary": "Stop Stream Thread Conversation", "description": "Stop streaming a conversation for a given thread.", "operationId": "threads-stop_stream_thread_conversation", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "thread_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Thread Id"}}, {"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"title": "Response Threads-Stop Stream Thread Conversation"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/{agent_id}/threads/{thread_id}/files": {"post": {"tags": ["threads"], "summary": "Upload", "description": "Stage a user file for a thread. Returns the path the client should send\nback with its next chat message as a newly-attached file.", "operationId": "threads-upload", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "thread_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Thread Id"}}, {"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}, {"name": "content-length", "in": "header", "required": true, "schema": {"type": "integer", "title": "Content-Length"}}], "requestBody": {"required": true, "content": {"multipart/form-data": {"schema": {"$ref": "#/components/schemas/Body_threads-upload"}}}}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"title": "Response Threads-Upload"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "get": {"tags": ["threads"], "summary": "List Files", "description": "List all files staged for a thread.", "operationId": "threads-list_files", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "thread_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Thread Id"}}, {"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"title": "Response Threads-List Files"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/{agent_id}/threads/{thread_id}": {"get": {"tags": ["threads"], "summary": "Read Thread", "description": "Retrieve a thread by ID.", "operationId": "threads-read_thread", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "thread_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Thread Id"}}, {"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ThreadContentPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "patch": {"tags": ["threads"], "summary": "Update Thread", "description": "Update a thread by ID.", "operationId": "threads-update_thread", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "thread_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Thread Id"}}, {"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ThreadUpdate"}}}}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ThreadPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}, "delete": {"tags": ["threads"], "summary": "Delete Thread", "description": "Delete a thread by ID.", "operationId": "threads-delete_thread", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "thread_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Thread Id"}}, {"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/{agent_id}/threads/{thread_id}/files/{file_path}": {"delete": {"tags": ["threads"], "summary": "Delete File", "description": "Delete a file from a thread's media store.", "operationId": "threads-delete_file", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "file_path", "in": "path", "required": true, "schema": {"type": "string", "title": "File Path"}}, {"name": "thread_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Thread Id"}}, {"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/Message"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/agents/{agent_id}/threads/{thread_id}/stream": {"post": {"tags": ["threads"], "summary": "Stream Thread Conversation", "description": "Send a message and stream the resulting conversation for a given thread.", "operationId": "threads-stream_thread_conversation", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "agent_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Agent Id"}}, {"name": "thread_id", "in": "path", "required": true, "schema": {"type": "string", "title": "Thread Id"}}], "requestBody": {"required": true, "content": {"application/json": {"schema": {"$ref": "#/components/schemas/ChatRequest"}}}}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"title": "Response Threads-Stream Thread Conversation"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/threads/recent": {"get": {"tags": ["threads"], "summary": "Read Recent Threads", "description": "Retrieve the current user's most recently active threads across all agents.", "operationId": "threads-read_recent_threads", "security": [{"OAuth2PasswordBearer": []}], "parameters": [{"name": "skip", "in": "query", "required": false, "schema": {"type": "integer", "default": 0, "title": "Skip"}}, {"name": "limit", "in": "query", "required": false, "schema": {"type": "integer", "default": 10, "title": "Limit"}}], "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/RecentThreadsPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}, "/api/v1/private/users/": {"post": {"tags": ["private"], "summary": "Create User", "description": "Create a new user.", "operationId": "private-create_user", "requestBody": {"content": {"application/json": {"schema": {"$ref": "#/components/schemas/PrivateUserCreate"}}}, "required": true}, "responses": {"200": {"description": "Successful Response", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/UserPublic"}}}}, "422": {"description": "Validation Error", "content": {"application/json": {"schema": {"$ref": "#/components/schemas/HTTPValidationError"}}}}}}}}, "components": {"schemas": {"AgentCreate": {"properties": {"name": {"type": "string", "maxLength": 255, "minLength": 1, "title": "Name"}, "description": {"anyOf": [{"type": "string", "maxLength": 255}, {"type": "null"}], "title": "Description"}, "system_prompt": {"type": "string", "title": "System Prompt"}, "tools_config": {"items": {"type": "string"}, "type": "array", "title": "Tools Config", "default": []}, "is_public": {"type": "boolean", "title": "Is Public", "default": false}}, "type": "object", "required": ["name", "system_prompt"], "title": "AgentCreate"}, "AgentPublic": {"properties": {"name": {"type": "string", "title": "Name"}, "description": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Description"}, "system_prompt": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "System Prompt"}, "tools_config": {"anyOf": [{"items": {"type": "string"}, "type": "array"}, {"type": "null"}], "title": "Tools Config"}, "is_public": {"type": "boolean", "title": "Is Public", "default": false}, "id": {"type": "string", "title": "Id"}, "created_at": {"anyOf": [{"type": "string", "format": "date-time"}, {"type": "null"}], "title": "Created At"}, "owner_name": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Owner Name"}, "can_edit": {"type": "boolean", "title": "Can Edit", "default": false}, "added_count": {"anyOf": [{"type": "integer"}, {"type": "null"}], "title": "Added Count"}, "is_added": {"type": "boolean", "title": "Is Added", "default": false}, "is_owner": {"type": "boolean", "title": "Is Owner", "default": false}}, "type": "object", "required": ["name", "id"], "title": "AgentPublic"}, "AgentUpdate": {"properties": {"name": {"anyOf": [{"type": "string", "maxLength": 255, "minLength": 1}, {"type": "null"}], "title": "Name", "default": "Default Agent"}, "description": {"anyOf": [{"type": "string", "maxLength": 255}, {"type": "null"}], "title": "Description"}, "system_prompt": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "System Prompt", "default": "You are a helpful assistant."}, "tools_config": {"items": {"type": "string"}, "type": "array", "title": "Tools Config", "default": []}, "is_public": {"anyOf": [{"type": "boolean"}, {"type": "null"}], "title": "Is Public", "default": false}}, "type": "object", "title": "AgentUpdate"}, "AgentsPublic": {"properties": {"data": {"items": {"$ref": "#/components/schemas/AgentPublic"}, "type": "array", "title": "Data"}, "count": {"type": "integer", "title": "Count"}}, "type": "object", "required": ["data", "count"], "title": "AgentsPublic"}, "Body_agents-add_public_agent": {"properties": {"agent_id": {"type": "string", "title": "Agent Id"}}, "type": "object", "required": ["agent_id"], "title": "Body_agents-add_public_agent"}, "Body_agents-upload_profile_picture": {"properties": {"file": {"type": "string", "format": "binary", "title": "File"}}, "type": "object", "required": ["file"], "title": "Body_agents-upload_profile_picture"}, "Body_agents-upload_skill": {"properties": {"file": {"type": "string", "format": "binary", "title": "File"}, "skill_name": {"type": "string", "title": "Skill Name"}}, "type": "object", "required": ["file", "skill_name"], "title": "Body_agents-upload_skill"}, "Body_login-login_access_token": {"properties": {"grant_type": {"anyOf": [{"type": "string", "pattern": "^password$"}, {"type": "null"}], "title": "Grant Type"}, "username": {"type": "string", "title": "Username"}, "password": {"type": "string", "format": "password", "title": "Password"}, "scope": {"type": "string", "title": "Scope", "default": ""}, "client_id": {"anyOf": [{"type": "string"}, {"type": "null"}], "title": "Client Id"}, "client_secret": {"anyOf": [{"type": "string"}, {"type": "null"}], "format": "password", "title": "Client Secret"}}, "type": "object", "required": ["username", "password"], "title": "Body_login-login_access_token"}, "Body_threads-upload": {"properties": {"file": {"type": "string", "format": "binary", "title": "File"}}, "type": "object", "required": ["file"], "title": "Body_threads-upload"}, "ChatRequest": {"properties": {"message": {"type": "string", "title": "Message"}, "model": {"type": "string", "title": "Model"}, "attached_files": {"items": {"type": "string"}, "type": "array", "title": "Attached Files", "default": []}, "file_read_mode": {"type": "string", "enum": ["base64", "reference"], "title": "File Read Mode", "default": "reference"}}, "type": "object", "required": ["message", "model"], "title": "ChatRequest"}, "HTTPValidationError": {"properties": {"detail": {"items": {"$ref": "#/components/schemas/ValidationError"}, "type": "array", "title": "Detail"}}, "type": "object", "title": "HTTPValidationError"}, "Message": {"properties": {"message": {"type": "string", "title": "Message"}}, "type": "object", "required": ["message"], "title": "Message"}, "NewPassword": {"properties": {"token": {"type": "string", "title": "Token"}, "new_password": {"type": "string", "maxLength": 128, "minLength": 8, "title": "New Password"}}, "type": "object", "required": ["token", "new_password"], "title": "NewPassword"}, "PrivateUserCreate": {"properties": {"email": {"type": "string", "title": "Email"}, "password": {"type": "string", "title": "Password"}, "full_name": {"type": "string", "title": "Full Name"}, "is_verified": {"type": "boolean", "title": "Is Verified", "default": false}}, "type": "object", "required": ["email", "password", "full_name"], "title": "PrivateUserCreate"}, "RecentThreadsPublic": {"properties": {"data": {"items": {"$ref": "#/components/schemas/ThreadWithAgentPublic"}, "type": "array", "title": "Data"}, "count": {"type": "integer", "title": "Count"}}, "type": "object", "required": ["data", "count"], "title": "RecentThreadsPublic"}, "ThreadContentPublic": {"properties": {"id": {"type": "string", "title": "Id"}, "name": {"type": "string", "title": "Name"}, "agent_id": {"type": "string", "title": "Agent Id"}, "user_id": {"type": "string", "format": "uuid", "title": "User Id"}, "last_modified": {"anyOf": [{"type": "string", "format": "date-time"}, {"type": "null"}], "title": "Last Modified"}, "messages": {"items": {"additionalProperties": true, "type": "object"}, "type": "array", "title": "Messages"}}, "type": "object", "required": ["id", "name", "agent_id", "user_id", "messages"], "title": "ThreadContentPublic"}, "ThreadCreate": {"properties": {"name": {"anyOf": [{"type": "string", "maxLength": 255, "minLength": 1}, {"type": "null"}], "title": "Name", "default": "New Conversation"}}, "type": "object", "title": "ThreadCreate"}, "ThreadPublic": {"properties": {"id": {"type": "string", "title": "Id"}, "name": {"type": "string", "title": "Name"}, "agent_id": {"type": "string", "title": "Agent Id"}, "user_id": {"type": "string", "format": "uuid", "title": "User Id"}, "last_modified": {"anyOf": [{"type": "string", "format": "date-time"}, {"type": "null"}], "title": "Last Modified"}}, "type": "object", "required": ["id", "name", "agent_id", "user_id"], "title": "ThreadPublic"}, "ThreadUpdate": {"properties": {"name": {"anyOf": [{"type": "string", "maxLength": 255, "minLength": 1}, {"type": "null"}], "title": "Name", "default": "New Conversation"}}, "type": "object", "title": "ThreadUpdate"}, "ThreadWithAgentPublic": {"properties": {"id": {"type": "string", "title": "Id"}, "name": {"type": "string", "title": "Name"}, "agent_id": {"type": "string", "title": "Agent Id"}, "user_id": {"type": "string", "format": "uuid", "title": "User Id"}, "last_modified": {"anyOf": [{"type": "string", "format": "date-time"}, {"type": "null"}], "title": "Last Modified"}, "agent_name": {"type": "string", "title": "Agent Name"}}, "type": "object", "required": ["id", "name", "agent_id", "user_id", "agent_name"], "title": "ThreadWithAgentPublic"}, "ThreadsPublic": {"properties": {"data": {"items": {"$ref": "#/components/schemas/ThreadPublic"}, "type": "array", "title": "Data"}, "count": {"type": "integer", "title": "Count"}}, "type": "object", "required": ["data", "count"], "title": "ThreadsPublic"}, "Token": {"properties": {"access_token": {"type": "string", "title": "Access Token"}, "token_type": {"type": "string", "title": "Token Type", "default": "bearer"}}, "type": "object", "required": ["access_token"], "title": "Token"}, "UpdatePassword": {"properties": {"current_password": {"type": "string", "maxLength": 128, "minLength": 8, "title": "Current Password"}, "new_password": {"type": "string", "maxLength": 128, "minLength": 8, "title": "New Password"}}, "type": "object", "required": ["current_password", "new_password"], "title": "UpdatePassword"}, "UserCreate": {"properties": {"email": {"type": "string", "maxLength": 255, "format": "email", "title": "Email"}, "is_active": {"type": "boolean", "title": "Is Active", "default": true}, "is_superuser": {"type": "boolean", "title": "Is Superuser", "default": false}, "full_name": {"anyOf": [{"type": "string", "maxLength": 255}, {"type": "null"}], "title": "Full Name"}, "password": {"type": "string", "maxLength": 128, "minLength": 8, "title": "Password"}}, "type": "object", "required": ["email", "password"], "title": "UserCreate"}, "UserPublic": {"properties": {"email": {"type": "string", "maxLength": 255, "format": "email", "title": "Email"}, "is_active": {"type": "boolean", "title": "Is Active", "default": true}, "is_superuser": {"type": "boolean", "title": "Is Superuser", "default": false}, "full_name": {"anyOf": [{"type": "string", "maxLength": 255}, {"type": "null"}], "title": "Full Name"}, "id": {"type": "string", "format": "uuid", "title": "Id"}, "created_at": {"anyOf": [{"type": "string", "format": "date-time"}, {"type": "null"}], "title": "Created At"}}, "type": "object", "required": ["email", "id"], "title": "UserPublic"}, "UserRegister": {"properties": {"email": {"type": "string", "maxLength": 255, "format": "email", "title": "Email"}, "password": {"type": "string", "maxLength": 128, "minLength": 8, "title": "Password"}, "full_name": {"anyOf": [{"type": "string", "maxLength": 255}, {"type": "null"}], "title": "Full Name"}}, "type": "object", "required": ["email", "password"], "title": "UserRegister"}, "UserUpdate": {"properties": {"email": {"anyOf": [{"type": "string", "maxLength": 255, "format": "email"}, {"type": "null"}], "title": "Email"}, "is_active": {"type": "boolean", "title": "Is Active", "default": true}, "is_superuser": {"type": "boolean", "title": "Is Superuser", "default": false}, "full_name": {"anyOf": [{"type": "string", "maxLength": 255}, {"type": "null"}], "title": "Full Name"}, "password": {"anyOf": [{"type": "string", "maxLength": 128, "minLength": 8}, {"type": "null"}], "title": "Password"}}, "type": "object", "title": "UserUpdate"}, "UserUpdateMe": {"properties": {"full_name": {"anyOf": [{"type": "string", "maxLength": 255}, {"type": "null"}], "title": "Full Name"}, "email": {"anyOf": [{"type": "string", "maxLength": 255, "format": "email"}, {"type": "null"}], "title": "Email"}}, "type": "object", "title": "UserUpdateMe"}, "UsersPublic": {"properties": {"data": {"items": {"$ref": "#/components/schemas/UserPublic"}, "type": "array", "title": "Data"}, "count": {"type": "integer", "title": "Count"}}, "type": "object", "required": ["data", "count"], "title": "UsersPublic"}, "ValidationError": {"properties": {"loc": {"items": {"anyOf": [{"type": "string"}, {"type": "integer"}]}, "type": "array", "title": "Location"}, "msg": {"type": "string", "title": "Message"}, "type": {"type": "string", "title": "Error Type"}, "input": {"title": "Input"}, "ctx": {"type": "object", "title": "Context"}}, "type": "object", "required": ["loc", "msg", "type"], "title": "ValidationError"}}, "securitySchemes": {"OAuth2PasswordBearer": {"type": "oauth2", "flows": {"password": {"scopes": {}, "tokenUrl": "/api/v1/login/access-token"}}}}}}