{ "openapi": "3.1.0", "info": { "title": "Agentic API", "description": "API for interacting with Agentic agents", "version": "latest" }, "paths": { "/_discovery": { "get": { "summary": "List Endpoints", "description": "Discovery endpoint that lists all available agents", "operationId": "list_endpoints__discovery_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/login": { "post": { "summary": "Login", "description": "Just generates a random token to represent the current user", "operationId": "login_login_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/{agent_name}/oauth/callback/{tool_name}": { "get": { "summary": "Handle Oauth Static Callback", "description": "Static OAuth callback endpoint that extracts thread_id from state parameter", "operationId": "handle_oauth_static_callback__agent_name__oauth_callback__tool_name__get", "parameters": [ { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } }, { "name": "tool_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Tool Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Handle Oauth Static Callback Agent Name Oauth Callback Tool Name Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/{agent_name}/oauth/{thread_id}/{tool_name}": { "get": { "summary": "Handle Oauth Callback", "description": "Core OAuth callback handler implementation", "operationId": "handle_oauth_callback__agent_name__oauth__thread_id___tool_name__get", "parameters": [ { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } }, { "name": "tool_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Tool Name" } }, { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Handle Oauth Callback Agent Name Oauth Run Id Tool Name Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/{agent_name}/process": { "post": { "summary": "Process Request", "description": "Process a new request", "operationId": "process_request__agent_name__process_post", "parameters": [ { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/{agent_name}/resume": { "post": { "summary": "Resume Request", "description": "Resume an existing request", "operationId": "resume_request__agent_name__resume_post", "parameters": [ { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeWithInputRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/{agent_name}/reset": { "post": { "summary": "Reset Agent", "description": "Reset the agent", "operationId": "reset_agent__agent_name__reset_post", "parameters": [ { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/{agent_name}/getevents": { "get": { "summary": "Get Events", "description": "Get events for a request", "operationId": "get_events__agent_name__getevents_get", "parameters": [ { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } }, { "name": "request_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Request Id" } }, { "name": "stream", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Stream" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/{agent_name}/stream_request": { "post": { "summary": "Stream Request", "description": "Stream a request response", "operationId": "stream_request__agent_name__stream_request_post", "parameters": [ { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProcessRequest" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/{agent_name}/runs": { "get": { "summary": "Get Runs", "description": "Get all runs for this agent", "operationId": "get_runs__agent_name__runs_get", "parameters": [ { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/{agent_name}/runs/{thread_id}/logs": { "get": { "summary": "Get Run Logs", "description": "Get logs for a specific run", "operationId": "get_run_logs__agent_name__runs__thread_id__logs_get", "parameters": [ { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } }, { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/{agent_name}/webhook/{thread_id}/{callback_name}": { "post": { "summary": "Handle Webhook", "description": "Handle webhook callbacks", "operationId": "handle_webhook__agent_name__webhook__thread_id___callback_name__post", "parameters": [ { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } }, { "name": "callback_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Callback Name" } }, { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/{agent_name}/describe": { "get": { "summary": "Describe", "description": "Get agent description", "operationId": "describe__agent_name__describe_get", "parameters": [ { "name": "agent_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Agent Name" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "ProcessRequest": { "properties": { "prompt": { "type": "string", "title": "Prompt" }, "debug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Debug" }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, "type": "object", "required": [ "prompt" ], "title": "ProcessRequest" }, "ResumeWithInputRequest": { "properties": { "continue_result": { "additionalProperties": { "type": "string" }, "type": "object", "title": "Continue Result" }, "debug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Debug" }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, "type": "object", "required": [ "continue_result" ], "title": "ResumeWithInputRequest" }, "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" } } } }