{ "components": { "schemas": { "Assistant": { "properties": { "id": { "type": "string" }, "kind": { "enum": [ "template", "alias" ], "type": "string" }, "revision_id": { "format": "uuid", "type": "string" }, "template_id": { "type": "string" } }, "required": [ "id", "template_id", "revision_id", "kind" ], "type": "object" }, "CreateAssistantRequest": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "template_id": { "type": "string" } }, "required": [ "id", "template_id" ], "type": "object" }, "CreateRunRequest": { "additionalProperties": false, "properties": { "assistant_id": { "type": "string" }, "priority": { "type": "integer" }, "session_id": { "format": "uuid", "type": "string" }, "state": { "type": "object" } }, "required": [ "assistant_id", "session_id" ], "type": "object" }, "CreateSessionRunRequest": { "additionalProperties": false, "properties": { "assistant_id": { "type": "string" }, "priority": { "type": "integer" }, "state": { "type": "object" } }, "required": [ "assistant_id" ], "type": "object" }, "ErrorResponse": { "properties": { "error": { "properties": { "code": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "Feedback": { "additionalProperties": true, "type": "object" }, "FeedbackRequest": { "additionalProperties": false, "properties": { "key": { "type": "string" }, "run_id": { "format": "uuid", "type": "string" }, "score": { "maximum": 1, "minimum": -1, "type": [ "number", "null" ] }, "value": { "type": [ "string", "null" ] } }, "required": [ "run_id", "key" ], "type": "object" }, "Health": { "properties": { "status": { "type": "string" } }, "required": [ "status" ], "type": "object" }, "Info": { "additionalProperties": true, "type": "object" }, "InterruptDecisionRequest": { "additionalProperties": false, "properties": { "kind": { "enum": [ "approve", "edit", "reject" ], "type": "string" }, "payload": { "type": "object" }, "reason": { "type": "string" } }, "required": [ "kind", "reason" ], "type": "object" }, "ItemPage": { "properties": { "items": { "items": {}, "type": "array" }, "next": { "type": [ "string", "null" ] } }, "required": [ "items", "next" ], "type": "object" }, "MemoryRequest": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "payload": { "type": "object" }, "session_id": { "type": "string" }, "tenant_id": { "type": "string" }, "user_id": { "type": "string" } }, "type": "object" }, "ResumeRunRequest": { "additionalProperties": false, "properties": { "confirm": { "const": true } }, "required": [ "confirm" ], "type": "object" }, "Run": { "properties": { "id": { "format": "uuid", "type": "string" }, "next_nodes": { "items": { "type": "string" }, "type": "array" }, "plan_id": { "format": "uuid", "type": "string" }, "revision_id": { "format": "uuid", "type": "string" }, "session_id": { "format": "uuid", "type": "string" }, "state": { "type": "object" }, "status": { "enum": [ "queued", "running", "waiting", "succeeded", "failed", "cancelled", "timed_out", "needs_review" ], "type": "string" }, "version": { "minimum": 0, "type": "integer" } }, "required": [ "id", "plan_id", "revision_id", "session_id", "status", "version" ], "type": "object" }, "Session": { "properties": { "created_at": { "format": "date-time", "type": "string" }, "id": { "format": "uuid", "type": "string" }, "runs": { "items": { "$ref": "#/components/schemas/Run" }, "type": "array" }, "tenant_id": { "type": "string" } }, "required": [ "id", "tenant_id", "created_at" ], "type": "object" } }, "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } }, "info": { "description": "Beta v2 durable Agent Server API.", "title": "OpenRath Agent Server", "version": "2.0.0" }, "openapi": "3.1.0", "paths": { "/health/live": { "get": { "operationId": "live", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Health" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [], "summary": "Process liveness", "x-openrath-action": null, "x-openrath-stability": "beta" } }, "/health/ready": { "get": { "operationId": "ready", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Health" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [], "summary": "Dependency readiness", "x-openrath-action": null, "x-openrath-stability": "beta" } }, "/info": { "get": { "operationId": "info", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Info" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [], "summary": "Server capabilities", "x-openrath-action": null, "x-openrath-stability": "beta" } }, "/metrics": { "get": { "operationId": "metrics", "responses": { "200": { "content": { "text/plain": { "schema": { "type": "object" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Prometheus metrics", "x-openrath-action": "metrics.read", "x-openrath-stability": "beta" } }, "/v1/assistants": { "get": { "operationId": "listAssistants", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ItemPage" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "List deployment templates and tenant aliases", "x-openrath-action": "assistant.read", "x-openrath-stability": "beta" }, "post": { "operationId": "createAssistantAlias", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAssistantRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Assistant" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Create a tenant assistant alias", "x-openrath-action": "assistant.create", "x-openrath-stability": "beta" } }, "/v1/assistants/{assistant_id}": { "get": { "operationId": "getAssistant", "parameters": [ { "in": "path", "name": "assistant_id", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Assistant" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Get an assistant template or alias", "x-openrath-action": "assistant.read", "x-openrath-stability": "beta" } }, "/v1/feedback": { "post": { "operationId": "createFeedback", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedbackRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Feedback" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Create run feedback", "x-openrath-action": "feedback.create", "x-openrath-stability": "beta" } }, "/v1/interrupts": { "get": { "operationId": "listInterrupts", "parameters": [ { "in": "query", "name": "after", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 200, "minimum": 1, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ItemPage" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "List pending durable interrupts", "x-openrath-action": "interrupt.read", "x-openrath-stability": "beta" } }, "/v1/interrupts/{interrupt_id}/decision": { "post": { "operationId": "decideInterrupt", "parameters": [ { "in": "path", "name": "interrupt_id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InterruptDecisionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Run" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Submit a durable interrupt decision", "x-openrath-action": "interrupt.decide", "x-openrath-stability": "beta" } }, "/v1/runs": { "get": { "operationId": "listRuns", "parameters": [ { "in": "query", "name": "after", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 200, "minimum": 1, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ItemPage" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "List runs by cursor", "x-openrath-action": "run.read", "x-openrath-stability": "beta" }, "post": { "operationId": "createRun", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateRunRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Run" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Create a durable run", "x-openrath-action": "run.create", "x-openrath-stability": "beta" } }, "/v1/runs/{run_id}": { "get": { "operationId": "getRun", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Run" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Get a durable run", "x-openrath-action": "run.read", "x-openrath-stability": "beta" } }, "/v1/runs/{run_id}/cancel": { "post": { "operationId": "cancelRun", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Run" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Cancel a run", "x-openrath-action": "run.cancel", "x-openrath-stability": "beta" } }, "/v1/runs/{run_id}/events": { "get": { "operationId": "listRunEvents", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "query", "name": "after", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 200, "minimum": 1, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ItemPage" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Replay ordered durable run events", "x-openrath-action": "run.read", "x-openrath-stability": "beta" } }, "/v1/runs/{run_id}/resume": { "post": { "operationId": "resumeRun", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeRunRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Run" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Resume a run requiring operator review", "x-openrath-action": "run.resume", "x-openrath-stability": "beta" } }, "/v1/runs/{run_id}/stream": { "get": { "operationId": "streamRunEvents", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "format": "uuid", "type": "string" } }, { "in": "query", "name": "after", "required": false, "schema": { "type": "string" } }, { "in": "query", "name": "limit", "required": false, "schema": { "maximum": 200, "minimum": 1, "type": "integer" } } ], "responses": { "200": { "content": { "text/event-stream": { "schema": { "type": "object" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Stream ordered run events with cursor resume", "x-openrath-action": "run.read", "x-openrath-stability": "beta" } }, "/v1/sessions": { "post": { "operationId": "createSession", "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Session" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Create a durable session", "x-openrath-action": "session.create", "x-openrath-stability": "beta" } }, "/v1/sessions/{session_id}": { "get": { "operationId": "getSession", "parameters": [ { "in": "path", "name": "session_id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Session" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Get a durable session", "x-openrath-action": "session.read", "x-openrath-stability": "beta" } }, "/v1/sessions/{session_id}/runs": { "post": { "operationId": "createSessionRun", "parameters": [ { "in": "path", "name": "session_id", "required": true, "schema": { "format": "uuid", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSessionRunRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Run" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Create a run in an existing session", "x-openrath-action": "run.create", "x-openrath-stability": "beta" } }, "/v1/store/items": { "delete": { "operationId": "deleteStoreItem", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemoryRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Delete a governed memory item", "x-openrath-action": "memory.delete", "x-openrath-stability": "beta" }, "post": { "operationId": "putStoreItem", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemoryRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Write a governed memory item", "x-openrath-action": "memory.put", "x-openrath-stability": "beta" } }, "/v1/store/search": { "post": { "operationId": "searchStore", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemoryRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "type": "object" } } }, "description": "Success" }, "400": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Invalid request" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Unauthenticated" }, "403": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Forbidden" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Not found" }, "409": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Conflict" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } }, "description": "Resource exhausted" } }, "security": [ { "bearerAuth": [] } ], "summary": "Search governed memory", "x-openrath-action": "memory.search", "x-openrath-stability": "beta" } } } }