{ "openapi": "3.1.0", "info": { "title": "Neens", "summary": "Neens turns your agent's failures into regression tests, so the ones you fix can't come back.", "description": "The Neens HTTP API covers the whole loop: **ingest** traces (OTLP / OpenInference), **observe** sessions and agent topology, **diagnose** with failure clustering and issues, **evaluate** with judges/scores/enrichments and golden datasets, and **fix** with typed remediations and pre-prod eval gates.", "version": "0.16.6" }, "paths": { "/ingest/otlp": { "post": { "tags": [ "ingest" ], "summary": "Ingest Otlp", "operationId": "ingest_otlp_ingest_otlp_post", "parameters": [ { "name": "sync", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Sync" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/ingest/openinference": { "post": { "tags": [ "ingest" ], "summary": "Ingest Openinference", "operationId": "ingest_openinference_ingest_openinference_post", "parameters": [ { "name": "sync", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Sync" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/ingest/raw": { "post": { "tags": [ "ingest" ], "summary": "Ingest Raw", "operationId": "ingest_raw_ingest_raw_post", "parameters": [ { "name": "sync", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Sync" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/ingest/batch": { "post": { "tags": [ "ingest" ], "summary": "Ingest Batch", "description": "High-volume batch ingest: many raw sessions in one request.", "operationId": "ingest_batch_ingest_batch_post", "parameters": [ { "name": "sync", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Sync" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/v1/traces": { "post": { "tags": [ "ingest" ], "summary": "Otlp Traces", "description": "OTLP/HTTP trace receiver. Accepts protobuf or JSON; enqueues and returns an OTLP response.", "operationId": "otlp_traces_v1_traces_post", "parameters": [ { "name": "sync", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Sync" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/sessions": { "get": { "tags": [ "traces" ], "summary": "List Sessions", "operationId": "list_sessions_sessions_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Status" } }, { "name": "agent_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Name" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" } }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Page Size" } }, { "name": "min_turns", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Turns" } }, { "name": "max_turns", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Turns" } }, { "name": "min_duration_ms", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Duration Ms" } }, { "name": "max_duration_ms", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Duration Ms" } }, { "name": "min_spans", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Spans" } }, { "name": "max_spans", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Spans" } }, { "name": "min_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Tokens" } }, { "name": "max_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Tokens" } }, { "name": "min_input_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Input Tokens" } }, { "name": "max_input_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Input Tokens" } }, { "name": "min_output_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Output Tokens" } }, { "name": "max_output_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Output Tokens" } }, { "name": "model", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Model" } }, { "name": "tool_name", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Tool Name" } }, { "name": "span_kind", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Span Kind" } }, { "name": "span_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Span Status" } }, { "name": "tags", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Tags" } }, { "name": "cluster_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cluster Id" } }, { "name": "failure_set", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Failure Set" } }, { "name": "bucket", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Bucket" } }, { "name": "conversation_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Conversation Id" } }, { "name": "session_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" } }, { "name": "score_metric", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Score Metric" } }, { "name": "score_status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Score Status" } }, { "name": "score_label", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Score Label" } }, { "name": "issue_mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Issue Mode" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Version" } }, { "name": "hour", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hour" } }, { "name": "started_after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started After" } }, { "name": "started_before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started Before" } }, { "name": "enrichment", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Enrichment" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/sessions/filter-options": { "get": { "tags": [ "traces" ], "summary": "Filter Options", "operationId": "filter_options_sessions_filter_options_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/sessions/trend": { "get": { "tags": [ "traces" ], "summary": "Sessions Trend", "description": "Volume trend for the Traces page: per-day (or per-hour) trace counts, token\nusage (input and output), p50 latency and estimated spend over the selected time\nwindow, plus a period-over-period summary. Counts individual traces.", "operationId": "sessions_trend_sessions_trend_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "started_after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started After" } }, { "name": "started_before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started Before" } }, { "name": "grain", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grain" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "model", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model" } }, { "name": "agent_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Name" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Version" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } }, { "name": "group_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Group By" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/sessions/{session_id}": { "get": { "tags": [ "traces" ], "summary": "Get Session", "operationId": "get_session_sessions__session_id__get", "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/sessions/{session_id}/feedback": { "post": { "tags": [ "traces" ], "summary": "Submit Feedback", "description": "Record end-user feedback on a conversation \u2014 a CSAT rating or a thumbs up/down \u2014 without a\nhelpdesk integration.", "operationId": "submit_feedback_sessions__session_id__feedback_post", "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedbackIn" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/sessions/{session_id}/similar": { "get": { "tags": [ "traces" ], "summary": "Similar Sessions", "description": "Sessions most similar to ``session_id`` (\"more like this\"), up to ``limit``. Returns ``[]``\nwhen similarity search is unavailable.", "operationId": "similar_sessions_sessions__session_id__similar_get", "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 100, "minimum": 1, "default": 10, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/sessions/{session_id}/agent-graph": { "get": { "tags": [ "traces" ], "summary": "Agent Graph", "description": "Aggregate agent/tool topology for one run.", "operationId": "agent_graph_sessions__session_id__agent_graph_get", "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/agent-graph": { "get": { "tags": [ "traces" ], "summary": "Cohort Agent Graph", "description": "Cross-cohort aggregate agent/tool topology.", "operationId": "cohort_agent_graph_agent_graph_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Status" } }, { "name": "agent_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Name" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "min_turns", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Turns" } }, { "name": "max_turns", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Turns" } }, { "name": "min_duration_ms", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Duration Ms" } }, { "name": "max_duration_ms", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Duration Ms" } }, { "name": "min_spans", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Spans" } }, { "name": "max_spans", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Spans" } }, { "name": "min_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Tokens" } }, { "name": "max_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Tokens" } }, { "name": "min_input_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Input Tokens" } }, { "name": "max_input_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Input Tokens" } }, { "name": "min_output_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Output Tokens" } }, { "name": "max_output_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Output Tokens" } }, { "name": "model", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Model" } }, { "name": "tool_name", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Tool Name" } }, { "name": "span_kind", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Span Kind" } }, { "name": "span_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Span Status" } }, { "name": "tags", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Tags" } }, { "name": "cluster_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cluster Id" } }, { "name": "failure_set", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Failure Set" } }, { "name": "bucket", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Bucket" } }, { "name": "conversation_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Conversation Id" } }, { "name": "session_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" } }, { "name": "score_metric", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Score Metric" } }, { "name": "score_status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Score Status" } }, { "name": "score_label", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Score Label" } }, { "name": "issue_mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Issue Mode" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Version" } }, { "name": "hour", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hour" } }, { "name": "started_after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started After" } }, { "name": "started_before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started Before" } }, { "name": "enrichment", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Enrichment" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/conversations": { "get": { "tags": [ "conversations" ], "summary": "List Conversations", "operationId": "list_conversations_conversations_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Status" } }, { "name": "agent_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Name" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "conversation_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Conversation Id" } }, { "name": "session_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" } }, { "name": "page_size", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Page Size" } }, { "name": "min_turns", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Turns" } }, { "name": "max_turns", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Turns" } }, { "name": "min_duration_ms", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Duration Ms" } }, { "name": "max_duration_ms", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Duration Ms" } }, { "name": "min_spans", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Spans" } }, { "name": "max_spans", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Spans" } }, { "name": "min_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Tokens" } }, { "name": "max_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Tokens" } }, { "name": "min_input_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Input Tokens" } }, { "name": "max_input_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Input Tokens" } }, { "name": "min_output_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Min Output Tokens" } }, { "name": "max_output_tokens", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ], "title": "Max Output Tokens" } }, { "name": "model", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Model" } }, { "name": "tool_name", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Tool Name" } }, { "name": "span_kind", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Span Kind" } }, { "name": "span_status", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Span Status" } }, { "name": "tags", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Tags" } }, { "name": "cluster_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cluster Id" } }, { "name": "score_metric", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Score Metric" } }, { "name": "score_status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Score Status" } }, { "name": "score_label", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Score Label" } }, { "name": "issue_mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Issue Mode" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Version" } }, { "name": "hour", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Hour" } }, { "name": "started_after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started After" } }, { "name": "started_before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started Before" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/conversations/trend": { "get": { "tags": [ "conversations" ], "summary": "Conversations Trend", "description": "Volume trend for the Sessions page: per-day (or per-hour) session counts, token\nusage (input and output), p50 latency and estimated spend over the selected time\nwindow, plus a period-over-period summary. Counts distinct sessions.", "operationId": "conversations_trend_conversations_trend_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "started_after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started After" } }, { "name": "started_before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started Before" } }, { "name": "grain", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grain" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "model", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model" } }, { "name": "agent_name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Name" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Version" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } }, { "name": "group_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Group By" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/conversations/{conversation_id}": { "get": { "tags": [ "conversations" ], "summary": "Get Conversation", "operationId": "get_conversation_conversations__conversation_id__get", "parameters": [ { "name": "conversation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Conversation Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/conversations/{conversation_id}/agent-graph": { "get": { "tags": [ "conversations" ], "summary": "Conversation Agent Graph", "description": "Aggregate agent/tool topology for a whole conversation.", "operationId": "conversation_agent_graph_conversations__conversation_id__agent_graph_get", "parameters": [ { "name": "conversation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Conversation Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/conversations/{conversation_id}/labels": { "post": { "tags": [ "conversations" ], "summary": "Add Conversation Label", "description": "Apply a tag to EVERY member trace of the conversation (idempotent, mirroring the\nsingle-trace ``POST /sessions/{id}/labels`` path). The written ``session_labels`` rows make\nthe tag show up in the Sessions/Traces \"Tags\" filter. Returns the applied count.", "operationId": "add_conversation_label_conversations__conversation_id__labels_post", "parameters": [ { "name": "conversation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Conversation Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConversationLabel" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/conversations/{conversation_id}/annotations": { "post": { "tags": [ "conversations" ], "summary": "Add Conversation Annotation", "description": "Create one annotation (targetType 'session', targetId = member trace id) per member trace\nof the conversation, mirroring api/annotations.py's contract + reviewer attribution. Returns\nthe created count.", "operationId": "add_conversation_annotation_conversations__conversation_id__annotations_post", "parameters": [ { "name": "conversation_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Conversation Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConversationAnnotation" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/labels": { "get": { "tags": [ "labels" ], "summary": "List Labels", "operationId": "list_labels_labels_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/sessions/{session_id}/labels": { "post": { "tags": [ "labels" ], "summary": "Add Label", "operationId": "add_label_sessions__session_id__labels_post", "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LabelCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/sessions/{session_id}/labels/{label}": { "delete": { "tags": [ "labels" ], "summary": "Remove Label", "operationId": "remove_label_sessions__session_id__labels__label__delete", "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } }, { "name": "label", "in": "path", "required": true, "schema": { "type": "string", "title": "Label" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/run": { "post": { "tags": [ "clusters" ], "summary": "Run Clustering", "description": "Manually trigger a clustering run. Project-scoped.", "operationId": "run_clustering_clusters_run_post", "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ClusterRunBody" }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/assign": { "post": { "tags": [ "clusters" ], "summary": "Assign Sessions", "description": "Classify sessions against the project's existing failure clusters without re-clustering.\nEach result is ``assigned`` / ``novel`` / ``unassigned`` / ``no_model`` / ``unavailable`` /\n``not_found``; a ``novel`` session raises a new-failure-mode insight.", "operationId": "assign_sessions_clusters_assign_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AssignBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters": { "get": { "tags": [ "clusters" ], "summary": "List Clusters", "operationId": "list_clusters_clusters_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/clusters/scatter": { "get": { "tags": [ "clusters" ], "summary": "Scatter Points", "description": "Cluster-member scatter. Each point carries its cluster's L1 ``bucket`` key and the\nresponse carries a finite ``buckets`` legend ``[{key, label, count}]`` (count = points,\nsorted desc) so the UI can colour by ~10 buckets instead of an unbounded label set.", "operationId": "scatter_points_clusters_scatter_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/clusters/settings": { "get": { "tags": [ "clusters" ], "summary": "Get Settings Endpoint", "operationId": "get_settings_endpoint_clusters_settings_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "patch": { "tags": [ "clusters" ], "summary": "Patch Settings Endpoint", "operationId": "patch_settings_endpoint_clusters_settings_patch", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClusterSettingsPatch" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/readiness": { "get": { "tags": [ "clusters" ], "summary": "Readiness", "description": "Backs the Failure Modes zero-state (plan B1): the windowed failure-set count vs the\nfirst-run threshold, plus whether the first run has landed. Project-scoped.", "operationId": "readiness_clusters_readiness_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/clusters/failure-modes": { "get": { "tags": [ "clusters" ], "summary": "Failure Modes Hero", "description": "The Failure Modes hero page (plan B1) in one call: readiness (zero-state), the ranked\nactive failure-mode clusters enriched with root-cause hypothesis / typed-remediation chip /\ndaily-volume trend / NEW flag, plus honest freshness (\"Last analyzed\") and sample-based\nestimate reporting. Project-scoped. Purely additive \u2014 no storage change (the Cluster model\nalready carries root_cause/remediation/first_seen_at/status).", "operationId": "failure_modes_hero_clusters_failure_modes_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "today|24h|7d|30d|all|custom", "title": "Range" }, "description": "today|24h|7d|30d|all|custom" }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/configs": { "get": { "tags": [ "clusters" ], "summary": "List Configs", "description": "List the project's clustering configs. ``lifecycle`` filters by stage\n(``finalized`` default | ``experimental`` | ``all``) \u2014 but the ACTIVE config is ALWAYS\nincluded (never hide what runs). Sort: active first, then updated_at desc.", "operationId": "list_configs_clusters_configs_get", "parameters": [ { "name": "lifecycle", "in": "query", "required": false, "schema": { "type": "string", "default": "finalized", "title": "Lifecycle" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "clusters" ], "summary": "Create Config", "description": "Create a new config (stamped ``experimental``, ``is_active=0``, knobs defaulting from\n``CLUSTER_SETTINGS_DEFAULTS`` and clamped like the settings patch). 422 when name is blank.", "operationId": "create_config_clusters_configs_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClusterConfigCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/configs/estimate": { "post": { "tags": [ "clusters" ], "summary": "Estimate Config", "description": "Cheap eligible-failure-set count for an UNSAVED knob set \u2014 powers the fine-tune preview\n(a count only, no ML dry-run). Degrades to ``{eligible: 0,...}`` on any error.", "operationId": "estimate_config_clusters_configs_estimate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClusterConfigEstimate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/configs/{config_id}": { "get": { "tags": [ "clusters" ], "summary": "Get Config", "description": "A single config. 404 when it belongs to another project.", "operationId": "get_config_clusters_configs__config_id__get", "parameters": [ { "name": "config_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Config Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "clusters" ], "summary": "Patch Config", "description": "Edit a config's name/description/knobs (same clamps + nullable-meaningful scoreMetricKey\nas the settings patch). 404 out-of-scope; 422 on a blanked name.", "operationId": "patch_config_clusters_configs__config_id__patch", "parameters": [ { "name": "config_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Config Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClusterConfigPatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "clusters" ], "summary": "Delete Config", "description": "Delete a config. Refused (409) when it is the ACTIVE one (activate another first) or the\nproject's ONLY config. 404 out-of-scope.", "operationId": "delete_config_clusters_configs__config_id__delete", "parameters": [ { "name": "config_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Config Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/configs/{config_id}/activate": { "post": { "tags": [ "clusters" ], "summary": "Activate Config", "description": "Make this config the project's active one \u2014 atomically deactivating every other config in\nthe project (enforces the exactly-one-active invariant). 404 out-of-scope.", "operationId": "activate_config_clusters_configs__config_id__activate_post", "parameters": [ { "name": "config_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Config Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/configs/{config_id}/lifecycle": { "patch": { "tags": [ "clusters" ], "summary": "Patch Config Lifecycle", "description": "Move a config through its curation lifecycle: experimental \u2192 finalized \u2192 archived. A LABEL ONLY \u2014 never changes what runs, only the default list\nvisibility. 404 out-of-scope; 422 on an unknown stage.", "operationId": "patch_config_lifecycle_clusters_configs__config_id__lifecycle_patch", "parameters": [ { "name": "config_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Config Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigLifecyclePatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/{cluster_id}": { "get": { "tags": [ "clusters" ], "summary": "Get Cluster", "operationId": "get_cluster_clusters__cluster_id__get", "parameters": [ { "name": "cluster_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cluster Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "clusters" ], "summary": "Rename Cluster Endpoint", "description": "Rename a cluster and PIN the name: a pinned label survives future\nclustering relabels. Requires write access, object-level scope 404, 422 on a blank label.\nDeclared after ``/settings`` + ``/configs`` so PATCH ``/{cluster_id}`` never shadows them.", "operationId": "rename_cluster_endpoint_clusters__cluster_id__patch", "parameters": [ { "name": "cluster_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cluster Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClusterRenameBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/{cluster_id}/merge": { "post": { "tags": [ "clusters" ], "summary": "Merge Clusters Endpoint", "description": "Manually merge one or more source clusters INTO ``cluster_id``. Mirrors the taxonomy\nfailure-mode merge: MANAGE_TAXONOMY-gated, object-level scope (target + each source must be in\nthe caller's project \u2014 else 404), a cross-project guard (a source in a different project 404s),\nand 422 on an empty source set or a self-merge. Members are reassigned + deduped by\n``storage.merge_clusters``; sources are soft-resolved. Returns the merged target cluster.", "operationId": "merge_clusters_endpoint_clusters__cluster_id__merge_post", "parameters": [ { "name": "cluster_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cluster Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ClusterMergeBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/clusters/{cluster_id}/exemplars": { "get": { "tags": [ "clusters" ], "summary": "Cluster Exemplars", "description": "Representative sessions of a cluster, most typical first, capped at ``limit``. A cluster in\nanother project returns 404.", "operationId": "cluster_exemplars_clusters__cluster_id__exemplars_get", "parameters": [ { "name": "cluster_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cluster Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 50, "minimum": 1, "default": 5, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/analyses/{name}/run": { "post": { "tags": [ "analyses" ], "summary": "Run Analysis", "operationId": "run_analysis_analyses__name__run_post", "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string", "title": "Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/stats": { "get": { "tags": [ "stats" ], "summary": "Get Stats", "operationId": "get_stats_stats_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "all", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/stats/timeseries": { "get": { "tags": [ "stats" ], "summary": "Get Timeseries", "operationId": "get_timeseries_stats_timeseries_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "all", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/failure-modes": { "get": { "tags": [ "failure-modes" ], "summary": "Get Failure Modes", "operationId": "get_failure_modes_failure_modes_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/remediations": { "get": { "tags": [ "remediations" ], "summary": "Get Remediations", "operationId": "get_remediations_remediations_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/remediations/items": { "get": { "tags": [ "remediations" ], "summary": "List Remediations", "operationId": "list_remediations_remediations_items_get", "parameters": [ { "name": "clusterId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Clusterid" } }, { "name": "failureModeId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failuremodeid" } }, { "name": "failure_mode_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failure Mode Id" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "workState", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workstate" } }, { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, { "name": "label", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } }, { "name": "sort", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort" } }, { "name": "includeArchived", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Includearchived" } }, { "name": "include_ungrounded", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Include Ungrounded" } }, { "name": "include_advisories", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Include Advisories" } }, { "name": "actionability", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actionability" } }, { "name": "failureLocus", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failurelocus" } }, { "name": "failure_locus", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failure Locus" } }, { "name": "view", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "View" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/trend": { "get": { "tags": [ "remediations" ], "summary": "Remediations Trend", "description": "Throughput trend for the Remediations page: per-day (or per-hour) count of fix tasks created\nover the selected window, plus a period-over-period total. Scoped to the current project.\nCreation volume is counted regardless of later archive state, so a historical trend doesn't\ndrift as tasks are archived.", "operationId": "remediations_trend_remediations_trend_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "grain", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/stats": { "get": { "tags": [ "remediations" ], "summary": "Remediation Stats", "operationId": "remediation_stats_remediations_stats_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/remediations/agent-context": { "get": { "tags": [ "remediations" ], "summary": "Get Agent Context", "description": "Return the project's optional agent context (nulls when unset).", "operationId": "get_agent_context_remediations_agent_context_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "put": { "tags": [ "remediations" ], "summary": "Put Agent Context", "description": "Upsert the project's agent context (improves future grounded generations).", "operationId": "put_agent_context_remediations_agent_context_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentContextBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/generate": { "post": { "tags": [ "remediations" ], "summary": "Generate Remediation", "operationId": "generate_remediation_remediations_generate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GenerateBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/items/{rid}/regenerate": { "post": { "tags": [ "remediations" ], "summary": "Regenerate Remediation Item", "description": "Re-run the CURRENT grounded engine for this remediation's source (cluster or failure mode),\nproducing a FRESH remediation and archiving this one as a superseded predecessor. Force-capable on ANY status \u2014 the old proposal (and its PR/verification state) is\npreserved, never mutated in place and never deleted. Runs synchronously (one generation). 404 if\n``rid`` is not in the caller's project scope; 409 if it is already superseded. Returns the NEW\nremediation dict with ``regeneratedFromId`` set and an embedded compact ``predecessor``.", "operationId": "regenerate_remediation_item_remediations_items__rid__regenerate_post", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string", "title": "Rid" } } ], "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/RegenerateBody" }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/regenerate-bulk": { "post": { "tags": [ "remediations" ], "summary": "Regenerate Remediations Bulk", "description": "Regenerate a SET of remediations with the current engine. Resolves the\ntarget id list under project scope from exactly one selector (``remediation_ids`` |\n``failure_mode_id`` | ``all_open``), caps it at a server-side maximum, then:", "operationId": "regenerate_remediations_bulk_remediations_regenerate_bulk_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegenerateBulkBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/items/{rid}": { "get": { "tags": [ "remediations" ], "summary": "Get Remediation", "operationId": "get_remediation_remediations_items__rid__get", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string", "title": "Rid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "remediations" ], "summary": "Patch Remediation", "operationId": "patch_remediation_remediations_items__rid__patch", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string", "title": "Rid" } }, { "name": "force", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Force" } }, { "name": "reason", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RemediationPatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "remediations" ], "summary": "Delete Remediation", "operationId": "delete_remediation_remediations_items__rid__delete", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string", "title": "Rid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/items/{rid}/fix-bundle": { "get": { "tags": [ "remediations" ], "summary": "Get Fix Bundle", "description": "Assemble a remediation's root cause + typed fix spec + proof evals + anonymized failing\nexemplars into ONE coding-agent-ready pack (markdown + structured JSON + a pre-generated\n``neens eval run`` CI command). Pure assembly of data Neens already computes \u2014 no LLM, no\negress, no repo access. Read-only; mirrors the sibling GET-detail routes.", "operationId": "get_fix_bundle_remediations_items__rid__fix_bundle_get", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string", "title": "Rid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/items/{rid}/simulation-plan": { "get": { "tags": [ "remediations" ], "summary": "Simulation Plan", "description": "Describe what a simulate run WOULD do WITHOUT running any replay. Shares the exact\ntarget-selection + judge/model resolution used by ``POST.../simulate``. The optional\noverride query params mirror ``SimulateRequest`` (minus the explicit cohort \u2014 the UI holds\nthe selected ids client-side) so the Configure panel gets a live preview of a tuned run.", "operationId": "simulation_plan_remediations_items__rid__simulation_plan_get", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string", "title": "Rid" } }, { "name": "judgeId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Judgeid" } }, { "name": "threshold", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Threshold" } }, { "name": "maxTargets", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxtargets" } }, { "name": "sampling", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sampling" } }, { "name": "connectionId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Connectionid" } }, { "name": "strategy", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Strategy" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/items/{rid}/simulate": { "post": { "tags": [ "remediations" ], "summary": "Simulate", "operationId": "simulate_remediations_items__rid__simulate_post", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string", "title": "Rid" } } ], "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SimulateRequest" }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/items/{rid}/efficacy": { "get": { "tags": [ "remediations" ], "summary": "Efficacy", "operationId": "efficacy_remediations_items__rid__efficacy_get", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string", "title": "Rid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/items/{rid}/record-merge": { "post": { "tags": [ "remediations" ], "summary": "Record Merge Route", "description": "Record that a Neens-opened fix PR for this remediation was MERGED (the manual + MCP path):\nstamp a deploy event + a pending close-out watch. The webhook (``POST /webhooks/github``) is the\nautomated sibling. Returns the close-out dict.", "operationId": "record_merge_route_remediations_items__rid__record_merge_post", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string", "title": "Rid" } } ], "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/RecordMergeBody" }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/remediations/efficacy-report": { "get": { "tags": [ "remediations" ], "summary": "Efficacy Report", "description": "Per-project post-merge efficacy + MTTR report from LIVE close-out data: failure\nvolume before/after, fixes shipped/verified/regressed/pending, median MTTR, and a monthly trend.", "operationId": "efficacy_report_remediations_efficacy_report_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/remediations/items/{rid}/closeout": { "get": { "tags": [ "remediations" ], "summary": "Get Closeout", "description": "The single most-recent close-out for this remediation, or 404.", "operationId": "get_closeout_remediations_items__rid__closeout_get", "parameters": [ { "name": "rid", "in": "path", "required": true, "schema": { "type": "string", "title": "Rid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/agents": { "get": { "tags": [ "agents" ], "summary": "List Agents", "operationId": "list_agents_agents_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/scores/prefs": { "put": { "tags": [ "scores" ], "summary": "Upsert Pref", "operationId": "upsert_pref_scores_prefs_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScorePref" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scores/display-settings": { "get": { "tags": [ "scores" ], "summary": "Get Display Settings", "description": "Resolved score-display config for the current project (scale + green/yellow/red bands +\nper-metric overrides). Readable by anyone who can read the project \u2014 the UI needs it to\nrender every score. Falls back to platform defaults when nothing is persisted.", "operationId": "get_display_settings_scores_display_settings_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "patch": { "tags": [ "scores" ], "summary": "Patch Display Settings", "description": "Update the project's score-display config. Admin-only (``MANAGE_SCORE_DISPLAY``) \u2014 it\nchanges what every viewer sees. Presentation only: it never alters stored scores or grading.\nValues are clamped to safe ranges and bands kept non-inverted (``warn <= pass``).", "operationId": "patch_display_settings_scores_display_settings_patch", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ScoreDisplaySettingsPatch" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scores/metrics": { "get": { "tags": [ "scores" ], "summary": "List Metrics", "operationId": "list_metrics_scores_metrics_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "24h", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "type": "string", "default": "finalized", "title": "Lifecycle" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scores/timeseries": { "get": { "tags": [ "scores" ], "summary": "Timeseries", "operationId": "timeseries_scores_timeseries_get", "parameters": [ { "name": "metric_key", "in": "query", "required": true, "schema": { "type": "string", "title": "Metric Key" } }, { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "24h", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "type": "string", "default": "finalized", "title": "Lifecycle" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scores/distribution": { "get": { "tags": [ "scores" ], "summary": "Distribution", "description": "The label breakdown for one score type \u2014 the drill-down's answer to `/scores/timeseries`.", "operationId": "distribution_scores_distribution_get", "parameters": [ { "name": "metric_key", "in": "query", "required": true, "schema": { "type": "string", "title": "Metric Key" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "targetType", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Targettype" } }, { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "24h", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "type": "string", "default": "finalized", "title": "Lifecycle" } }, { "name": "buckets", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 48, "minimum": 1, "default": 12, "title": "Buckets" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scores": { "get": { "tags": [ "scores" ], "summary": "List Scores", "operationId": "list_scores_scores_get", "parameters": [ { "name": "metric_key", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Metric Key" } }, { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "24h", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "targetId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Targetid" } }, { "name": "targetType", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Targettype" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "min_score", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Score" } }, { "name": "max_score", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Max Score" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "lifecycle", "in": "query", "required": false, "schema": { "type": "string", "default": "finalized", "title": "Lifecycle" } }, { "name": "runId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Runid" } }, { "name": "page", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "default": 1, "title": "Page" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 25, "title": "Limit" } }, { "name": "sort", "in": "query", "required": false, "schema": { "type": "string", "default": "latest", "title": "Sort" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" } }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort Dir" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/annotations": { "get": { "tags": [ "annotations" ], "summary": "List Annotations", "operationId": "list_annotations_annotations_get", "parameters": [ { "name": "targetType", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Targettype" } }, { "name": "value", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Value" } }, { "name": "reviewer", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reviewer" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "annotations" ], "summary": "Create Annotation", "operationId": "create_annotation_annotations_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnnotationCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/annotations/trend": { "get": { "tags": [ "annotations" ], "summary": "Annotations Trend", "description": "Annotation-throughput trend for the Review Queue page: per-day (or per-hour) count of\nannotations created over the selected window, plus a period-over-period total. Scoped to the\ncurrent project \u2014 the review loop's output volume over time.", "operationId": "annotations_trend_annotations_trend_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "grain", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/annotations/reviewers": { "get": { "tags": [ "annotations" ], "summary": "List Reviewers", "operationId": "list_reviewers_annotations_reviewers_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/datasets": { "get": { "tags": [ "datasets" ], "summary": "List Datasets", "operationId": "list_datasets_datasets_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "datasets" ], "summary": "Create Dataset", "operationId": "create_dataset_datasets_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Body" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/preview": { "post": { "tags": [ "datasets" ], "summary": "Preview Dataset", "description": "Mirror ``/eval-targets/estimate`` for dataset sources: count eligible + sampled\nsessions for a source config, without persisting anything. Project-scoped.", "operationId": "preview_dataset_datasets_preview_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Body" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/{id_or_name}": { "patch": { "tags": [ "datasets" ], "summary": "Update Dataset", "operationId": "update_dataset_datasets__id_or_name__patch", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "datasets" ], "summary": "Delete Dataset", "operationId": "delete_dataset_datasets__id_or_name__delete", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/{id_or_name}/sync": { "post": { "tags": [ "datasets" ], "summary": "Sync Dataset", "description": "Re-run a filter/cluster dataset's stored source config, adding newly-matching\nsessions not already present. Respects sampling and (for streaming) the\n``last_synced_at`` high-water mark. Returns ``{added, total}``. 404 unless the dataset\nis a filter/cluster source. Project-scoped.", "operationId": "sync_dataset_datasets__id_or_name__sync_post", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/{id_or_name}/export": { "get": { "tags": [ "datasets" ], "summary": "Export Dataset", "operationId": "export_dataset_datasets__id_or_name__export_get", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } }, { "name": "format", "in": "query", "required": false, "schema": { "type": "string", "default": "json", "title": "Format" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/{id_or_name}/items": { "get": { "tags": [ "datasets" ], "summary": "List Items", "description": "List a dataset's items with optional text search (input/output/expected), kind +\ncaptured-field-presence filters, and whitelisted server-side sort. All params are\nadditive: with none supplied the historical ``ORDER BY created_at ASC`` is preserved.", "operationId": "list_items_datasets__id_or_name__items_get", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } }, { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" } }, { "name": "has", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Has" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" } }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort Dir" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "datasets" ], "summary": "Add Item", "operationId": "add_item_datasets__id_or_name__items_post", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "datasets" ], "summary": "Delete Item", "operationId": "delete_item_datasets__id_or_name__items_delete", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } }, { "name": "trace_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Trace Id" } }, { "name": "session_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Session Id" } }, { "name": "item_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Item Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/{id_or_name}/items/{item_id}": { "patch": { "tags": [ "datasets" ], "summary": "Update Item", "operationId": "update_item_datasets__id_or_name__items__item_id__patch", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } }, { "name": "item_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Item Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/{id_or_name}/items/bulk": { "post": { "tags": [ "datasets" ], "summary": "Bulk Add Items", "description": "Bulk-add sessions/traces to an existing dataset, de-duped against what's already in\nit. Sessions are field-captured (respecting the dataset's ``fields`` unless the body\noverrides ``fields``); traces are added as reference rows. Returns ``{added, skipped}``.\nProject-scoped.", "operationId": "bulk_add_items_datasets__id_or_name__items_bulk_post", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/from-selection": { "post": { "tags": [ "datasets" ], "summary": "Create From Selection", "description": "One-call \"create dataset from selected rows\": create a ``manual`` dataset, bulk-add\nthe selected sessions/traces, and \u2014 when ``golden`` \u2014 snapshot an immutable v1 marked\ngolden. Returns the dataset dict with a ``versions`` summary (newest first).", "operationId": "create_from_selection_datasets_from_selection_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Body" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/{id_or_name}/versions": { "post": { "tags": [ "datasets" ], "summary": "Create Version", "description": "Snapshot the dataset's current items into a new immutable version\n(``version = max+1``). Body ``{name?, notes?, golden?}``. When ``golden`` is set, sibling\nversions are un-goldened (one golden per dataset). Returns the version row.", "operationId": "create_version_datasets__id_or_name__versions_post", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "datasets" ], "summary": "List Versions", "operationId": "list_versions_datasets__id_or_name__versions_get", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/{id_or_name}/versions/{version}/items": { "get": { "tags": [ "datasets" ], "summary": "List Version Items", "description": "List an immutable version's snapshot items \u2014 paged/searchable/sortable exactly like\nthe live ``/items`` endpoint. Read-only.", "operationId": "list_version_items_datasets__id_or_name__versions__version__items_get", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "integer", "title": "Version" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } }, { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" } }, { "name": "has", "in": "query", "required": false, "schema": { "type": "array", "items": { "type": "string" }, "default": [], "title": "Has" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" } }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort Dir" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/{id_or_name}/versions/{version}": { "patch": { "tags": [ "datasets" ], "summary": "Update Version", "description": "Mutate version METADATA only \u2014 ``{name?, notes?, golden?}``. Snapshot items are\nimmutable. Setting ``golden:true`` un-goldens sibling versions (one golden per dataset).", "operationId": "update_version_datasets__id_or_name__versions__version__patch", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "integer", "title": "Version" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/datasets/{id_or_name}/versions/{version}/export": { "get": { "tags": [ "datasets" ], "summary": "Export Version", "description": "Export an immutable version's snapshot (json|csv), same shape as the dataset export\n(plus a ``version`` summary in the JSON body).", "operationId": "export_version_datasets__id_or_name__versions__version__export_get", "parameters": [ { "name": "id_or_name", "in": "path", "required": true, "schema": { "type": "string", "title": "Id Or Name" } }, { "name": "version", "in": "path", "required": true, "schema": { "type": "integer", "title": "Version" } }, { "name": "format", "in": "query", "required": false, "schema": { "type": "string", "default": "json", "title": "Format" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/settings": { "get": { "tags": [ "settings" ], "summary": "Get Settings", "operationId": "get_settings_settings_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/settings/api-keys": { "get": { "tags": [ "settings" ], "summary": "List Api Keys", "operationId": "list_api_keys_settings_api_keys_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "settings" ], "summary": "Create Api Key", "operationId": "create_api_key_settings_api_keys_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateKeyBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/settings/api-keys/revoke": { "post": { "tags": [ "settings" ], "summary": "Revoke Api Key", "operationId": "revoke_api_key_settings_api_keys_revoke_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeKeyBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/llm-connections": { "get": { "tags": [ "settings" ], "summary": "List Llm Connections", "operationId": "list_llm_connections_llm_connections_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "settings" ], "summary": "Create Llm Connection", "operationId": "create_llm_connection_llm_connections_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateConnBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/llm-connections/probe": { "post": { "tags": [ "settings" ], "summary": "Probe Llm Connection", "description": "Live connection probe: makes a real completion through the provider and returns\nreachability. Used by the UI 'Test' action. Never persists anything. A completion\nthat only ran out of token budget (finish_reason=length) still counts as reachable.", "operationId": "probe_llm_connection_llm_connections_probe_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProbeConnBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/llm-connections/list-models": { "post": { "tags": [ "settings" ], "summary": "List Llm Connection Models", "description": "List the model ids a connection's provider advertises, for the model picker.", "operationId": "list_llm_connection_models_llm_connections_list_models_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListModelsBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/llm-connections/{conn_id}": { "patch": { "tags": [ "settings" ], "summary": "Update Llm Connection", "operationId": "update_llm_connection_llm_connections__conn_id__patch", "parameters": [ { "name": "conn_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Conn Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateConnBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "settings" ], "summary": "Delete Llm Connection", "operationId": "delete_llm_connection_llm_connections__conn_id__delete", "parameters": [ { "name": "conn_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Conn Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges": { "get": { "tags": [ "judges" ], "summary": "List Judges", "operationId": "list_judges_judges_get", "parameters": [ { "name": "view", "in": "query", "required": false, "schema": { "type": "string", "default": "library", "title": "View" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } }, { "name": "type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Type" } }, { "name": "target", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Target" } }, { "name": "level", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Level" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Version" } }, { "name": "configured", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Configured" } }, { "name": "trigger", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Trigger" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Status" } }, { "name": "running", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Running" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" } }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort Dir" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "judges" ], "summary": "Create Judge", "operationId": "create_judge_judges_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JudgeCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges/run-status": { "get": { "tags": [ "judges" ], "summary": "List Run Status", "description": "Poll-friendly, status-ONLY projection of every enabled deployment.", "operationId": "list_run_status_judges_run_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/judges/preview": { "post": { "tags": [ "judges" ], "summary": "Preview Judge Prompt", "description": "Render the EXACT prompt a judge would send to the LLM, hydrated on a real sample session.", "operationId": "preview_judge_prompt_judges_preview_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreviewRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges/test-run": { "post": { "tags": [ "judges" ], "summary": "Test Run Judge Prompt", "description": "Execute the in-progress judge prompt against a real sample session ON THE FLY and return\nthe model's verdict \u2014 WITHOUT persisting anything.", "operationId": "test_run_judge_prompt_judges_test_run_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreviewRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges/{judge_id}/versions": { "post": { "tags": [ "judges" ], "summary": "Create Version", "operationId": "create_version_judges__judge_id__versions_post", "parameters": [ { "name": "judge_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Judge Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/api__judges__VersionCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges/{judge_id}": { "patch": { "tags": [ "judges" ], "summary": "Patch Judge", "operationId": "patch_judge_judges__judge_id__patch", "parameters": [ { "name": "judge_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Judge Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JudgePatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "judges" ], "summary": "Delete Judge", "operationId": "delete_judge_judges__judge_id__delete", "parameters": [ { "name": "judge_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Judge Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges/{judge_id}/lifecycle": { "patch": { "tags": [ "judges" ], "summary": "Patch Judge Lifecycle", "description": "Promote/demote a judge through its lifecycle: experimental \u2192 finalized \u2192 archived.", "operationId": "patch_judge_lifecycle_judges__judge_id__lifecycle_patch", "parameters": [ { "name": "judge_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Judge Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LifecyclePatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges/{judge_id}/deployments": { "post": { "tags": [ "judges" ], "summary": "Create Deployment", "operationId": "create_deployment_judges__judge_id__deployments_post", "parameters": [ { "name": "judge_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Judge Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges/{judge_id}/deployments/{deployment_id}": { "patch": { "tags": [ "judges" ], "summary": "Patch Deployment", "operationId": "patch_deployment_judges__judge_id__deployments__deployment_id__patch", "parameters": [ { "name": "judge_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Judge Id" } }, { "name": "deployment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Deployment Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentPatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "judges" ], "summary": "Delete Deployment", "operationId": "delete_deployment_judges__judge_id__deployments__deployment_id__delete", "parameters": [ { "name": "judge_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Judge Id" } }, { "name": "deployment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Deployment Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges/{judge_id}/targets": { "get": { "tags": [ "judges" ], "summary": "List Judge Targets", "description": "Per-binding aggregate for the scorer's \"results by target\" table: one row per enabled\ndeployment with its Run Target summary and the latest scored/avg/passRate over that target's\npopulation. Project-scoped; NULL-not-zero on an empty population. A legacy inline binding\n(no Run Target) still appears, with ``runTarget: null``.", "operationId": "list_judge_targets_judges__judge_id__targets_get", "parameters": [ { "name": "judge_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Judge Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/eval-targets/estimate": { "post": { "tags": [ "judges" ], "summary": "Estimate Targets", "operationId": "estimate_targets_eval_targets_estimate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EstimateRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges/{judge_id}/runs": { "get": { "tags": [ "judges" ], "summary": "List Judge Runs", "description": "All eval runs for a judge (current + historical), in the Activity-run shape\nso the UI can reuse the same row layout. Joins eval_runs \u2192 judge_deployments and\nleft-joins activity_runs (`act_eval_{run_id}`) for name / duration / errors.", "operationId": "list_judge_runs_judges__judge_id__runs_get", "parameters": [ { "name": "judge_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Judge Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/judges/{judge_id}/compare": { "get": { "tags": [ "judges" ], "summary": "Compare Judge Runs", "description": "Compare two eval runs of the SAME judge \u2014 typically two different versions.", "operationId": "compare_judge_runs_judges__judge_id__compare_get", "parameters": [ { "name": "judge_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Judge Id" } }, { "name": "runA", "in": "query", "required": true, "schema": { "type": "string", "title": "Runa" } }, { "name": "runB", "in": "query", "required": true, "schema": { "type": "string", "title": "Runb" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/eval-runs/export": { "get": { "tags": [ "judges" ], "summary": "Export Eval Run Scores", "description": "Export a judge run's (or several runs') scores WITH each target's input + output.", "operationId": "export_eval_run_scores_eval_runs_export_get", "parameters": [ { "name": "runs", "in": "query", "required": true, "schema": { "type": "string", "description": "Comma-separated eval_run ids", "title": "Runs" }, "description": "Comma-separated eval_run ids" }, { "name": "format", "in": "query", "required": false, "schema": { "type": "string", "default": "csv", "title": "Format" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/eval-runs": { "post": { "tags": [ "judges" ], "summary": "Create Eval Run", "operationId": "create_eval_run_eval_runs_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EvalRunCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/eval-runs/{run_id}": { "get": { "tags": [ "judges" ], "summary": "Get Eval Run", "operationId": "get_eval_run_eval_runs__run_id__get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 200, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/eval-runs/{run_id}/cancel": { "post": { "tags": [ "judges" ], "summary": "Cancel Eval Run", "operationId": "cancel_eval_run_eval_runs__run_id__cancel_post", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/run-targets": { "get": { "tags": [ "run-targets" ], "summary": "List Run Targets", "operationId": "list_run_targets_run_targets_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "run-targets" ], "summary": "Create Run Target", "operationId": "create_run_target_run_targets_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunTargetCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/run-targets/{run_target_id}": { "get": { "tags": [ "run-targets" ], "summary": "Get Run Target", "operationId": "get_run_target_run_targets__run_target_id__get", "parameters": [ { "name": "run_target_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Target Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "run-targets" ], "summary": "Patch Run Target", "operationId": "patch_run_target_run_targets__run_target_id__patch", "parameters": [ { "name": "run_target_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Target Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunTargetPatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "run-targets" ], "summary": "Delete Run Target", "operationId": "delete_run_target_run_targets__run_target_id__delete", "parameters": [ { "name": "run_target_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Target Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/cost-optimization/summary": { "get": { "tags": [ "cost-optimization" ], "summary": "Get Summary", "description": "What your agent and your LLM judges cost over a window, and what one trace costs.", "operationId": "get_summary_cost_optimization_summary_get", "parameters": [ { "name": "window", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Window" } }, { "name": "start", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Start" } }, { "name": "end", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "End" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "one agent version label, or `__unversioned__` for traces with no label", "title": "Version" }, "description": "one agent version label, or `__unversioned__` for traces with no label" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Summary Cost Optimization Summary Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/cost-optimization/judges": { "get": { "tags": [ "cost-optimization" ], "summary": "Get Judges", "description": "What each LLM judge cost you over the window, and what it would cost at other coverages.", "operationId": "get_judges_cost_optimization_judges_get", "parameters": [ { "name": "window", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Window" } }, { "name": "start", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Start" } }, { "name": "end", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "End" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "one agent version label, or `__unversioned__` for traces with no label", "title": "Version" }, "description": "one agent version label, or `__unversioned__` for traces with no label" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Judges Cost Optimization Judges Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/cost-optimization/frontier": { "get": { "tags": [ "cost-optimization" ], "summary": "Get Frontier", "description": "Which cheaper model could judge your traces without losing your trust.", "operationId": "get_frontier_cost_optimization_frontier_get", "parameters": [ { "name": "window", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Window" } }, { "name": "start", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Start" } }, { "name": "end", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "End" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "one agent version label, or `__unversioned__` for traces with no label", "title": "Version" }, "description": "one agent version label, or `__unversioned__` for traces with no label" }, { "name": "bar", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "description": "agreement bar in 0\u20131; overrides the default", "title": "Bar" }, "description": "agreement bar in 0\u20131; overrides the default" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Frontier Cost Optimization Frontier Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/cost-optimization/moves": { "get": { "tags": [ "cost-optimization" ], "summary": "Get Moves", "description": "The ranked list of ways to cut LLM cost without losing quality \u2014 at most one per subject.", "operationId": "get_moves_cost_optimization_moves_get", "parameters": [ { "name": "window", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Window" } }, { "name": "start", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Start" } }, { "name": "end", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "End" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "one agent version label, or `__unversioned__` for traces with no label", "title": "Version" }, "description": "one agent version label, or `__unversioned__` for traces with no label" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Moves Cost Optimization Moves Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompts/by-name/{name}": { "get": { "tags": [ "prompts" ], "summary": "Resolve By Name", "description": "SDK/judge-facing resolution: the content of a prompt by NAME at a label/version/newest.", "operationId": "resolve_by_name_prompts_by_name__name__get", "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string", "title": "Name" } }, { "name": "label", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" } }, { "name": "version", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Version" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompts/playground/run": { "post": { "tags": [ "prompts" ], "summary": "Playground Run", "description": "Execute a prompt against the project's default LLM connection and return the output.", "operationId": "playground_run_prompts_playground_run_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlaygroundRun" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompts/playground/fix-simulation": { "post": { "tags": [ "prompts" ], "summary": "Playground Fix Simulation", "description": "Re-score an edited system prompt against a real failing trace's judges by replaying it.\nReturns a queued id to poll.", "operationId": "playground_fix_simulation_prompts_playground_fix_simulation_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FixSimulationRun" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompts/playground/fix-simulation/{fixloop_id}": { "get": { "tags": [ "prompts" ], "summary": "Get Playground Fix Simulation", "description": "Poll a fix-loop's status + (when completed) its before/after result.", "operationId": "get_playground_fix_simulation_prompts_playground_fix_simulation__fixloop_id__get", "parameters": [ { "name": "fixloop_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Fixloop Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompts/from-remediation": { "post": { "tags": [ "prompts" ], "summary": "From Remediation", "description": "Lift a ``prompt_change`` remediation's fixed system prompt into a registry version.", "operationId": "from_remediation_prompts_from_remediation_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FromRemediation" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompts": { "get": { "tags": [ "prompts" ], "summary": "List Prompts", "operationId": "list_prompts_prompts_get", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "prompts" ], "summary": "Create Prompt", "operationId": "create_prompt_prompts_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PromptCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompts/{prompt_id}": { "get": { "tags": [ "prompts" ], "summary": "Get Prompt", "operationId": "get_prompt_prompts__prompt_id__get", "parameters": [ { "name": "prompt_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Prompt Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "prompts" ], "summary": "Patch Prompt", "operationId": "patch_prompt_prompts__prompt_id__patch", "parameters": [ { "name": "prompt_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Prompt Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PromptPatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "prompts" ], "summary": "Delete Prompt", "operationId": "delete_prompt_prompts__prompt_id__delete", "parameters": [ { "name": "prompt_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Prompt Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompts/{prompt_id}/versions": { "get": { "tags": [ "prompts" ], "summary": "List Versions", "operationId": "list_versions_prompts__prompt_id__versions_get", "parameters": [ { "name": "prompt_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Prompt Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "prompts" ], "summary": "Create Version", "operationId": "create_version_prompts__prompt_id__versions_post", "parameters": [ { "name": "prompt_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Prompt Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/api__prompts__VersionCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompts/{prompt_id}/labels/{label}": { "put": { "tags": [ "prompts" ], "summary": "Set Label", "description": "Point a movable deploy tag (``production``/``staging``/\u2026) at a specific version.", "operationId": "set_label_prompts__prompt_id__labels__label__put", "parameters": [ { "name": "prompt_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Prompt Id" } }, { "name": "label", "in": "path", "required": true, "schema": { "type": "string", "title": "Label" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LabelSet" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "prompts" ], "summary": "Delete Label", "operationId": "delete_label_prompts__prompt_id__labels__label__delete", "parameters": [ { "name": "prompt_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Prompt Id" } }, { "name": "label", "in": "path", "required": true, "schema": { "type": "string", "title": "Label" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals": { "get": { "tags": [ "preprod-evals" ], "summary": "List Preprod Evals", "description": "List pre-prod eval runs (project-scoped) with progress counts.", "operationId": "list_preprod_evals_preprod_evals_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "preprod-evals" ], "summary": "Create Preprod Eval", "description": "Create a pre-prod eval run + snapshot the golden version's items into pending item rows.", "operationId": "create_preprod_eval_preprod_evals_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Body" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals/trend": { "get": { "tags": [ "preprod-evals" ], "summary": "Preprod Trend", "description": "Run-cadence and pass-rate trend for the Pre-prod Evals page. Primary series: per-day (or\nper-hour) count of runs created over the window. Secondary: the pass-rate across scored items in\nthe same window. A window with no scored items reports a null pass-rate, never a fabricated 0%.\nScoped to the current project.", "operationId": "preprod_trend_preprod_evals_trend_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "grain", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals/{run_id}": { "get": { "tags": [ "preprod-evals" ], "summary": "Get Preprod Eval", "description": "Run detail: the run header + per-item summary + an aggregate rollup.", "operationId": "get_preprod_eval_preprod_evals__run_id__get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals/{run_id}/items": { "get": { "tags": [ "preprod-evals" ], "summary": "Get Preprod Items", "description": "The frozen prompt list for the harness/runner: ``[{item_id, input, expected_output}]``.", "operationId": "get_preprod_items_preprod_evals__run_id__items_get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals/{run_id}/start": { "post": { "tags": [ "preprod-evals" ], "summary": "Start Preprod Eval", "description": "Transition ``awaiting_traces`` \u2192 ``running`` (idempotent).", "operationId": "start_preprod_eval_preprod_evals__run_id__start_post", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals/{run_id}/run": { "post": { "tags": [ "preprod-evals" ], "summary": "Run Preprod Eval Route", "description": "Trigger a PUSH run: Neens HTTP-calls the run's agent endpoint for every frozen golden\nprompt, captures + links each response, then scores it \u2014 no user harness.", "operationId": "run_preprod_eval_route_preprod_evals__run_id__run_post", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals/verify": { "post": { "tags": [ "preprod-evals" ], "summary": "Verify Fix", "description": "Verification webhook \u2014 PROVE a fix against a candidate endpoint/branch.", "operationId": "verify_fix_preprod_evals_verify_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreprodVerifyBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals/{run_id}/cancel": { "post": { "tags": [ "preprod-evals" ], "summary": "Cancel Preprod Eval", "description": "Cancel a run (terminal). A completed run cannot be cancelled.", "operationId": "cancel_preprod_eval_preprod_evals__run_id__cancel_post", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals/{run_id}/comparison": { "get": { "tags": [ "preprod-evals" ], "summary": "Comparison", "description": "Candidate-vs-baseline comparison.", "operationId": "comparison_preprod_evals__run_id__comparison_get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } }, { "name": "baseline", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "override baseline kind", "title": "Baseline" }, "description": "override baseline kind" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals/{run_id}/gate": { "get": { "tags": [ "preprod-evals" ], "summary": "Gate", "description": "Evaluate the run's ``gate_json`` against the candidate results \u2192 pass/fail + reasons.", "operationId": "gate_preprod_evals__run_id__gate_get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-evals/{run_id}/metrics": { "get": { "tags": [ "preprod-evals" ], "summary": "Metrics", "description": "Per-metric score rollup for a run's captured+scored sessions \u2014 the CI-gate surface.", "operationId": "metrics_preprod_evals__run_id__metrics_get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-compare": { "get": { "tags": [ "preprod-evals" ], "summary": "Compare Runs", "description": "Aligned N-run comparison over a shared golden version.", "operationId": "compare_runs_preprod_compare_get", "parameters": [ { "name": "runs", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "comma-separated run ids (A,B,C\u2026)", "title": "Runs" }, "description": "comma-separated run ids (A,B,C\u2026)" }, { "name": "run", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "description": "repeatable run id param", "title": "Run" }, "description": "repeatable run id param" }, { "name": "baseline", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "a run id (must be in the set) to mark per-row regressions against", "title": "Baseline" }, "description": "a run id (must be in the set) to mark per-row regressions against" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preprod-compare/trajectory": { "get": { "tags": [ "preprod-evals" ], "summary": "Trajectory Diff", "description": "Diff the candidate's captured trajectory against the baseline run's captured trajectory\nfor the SAME golden prompt.", "operationId": "trajectory_diff_preprod_compare_trajectory_get", "parameters": [ { "name": "run", "in": "query", "required": true, "schema": { "type": "string", "description": "candidate run id", "title": "Run" }, "description": "candidate run id" }, { "name": "item", "in": "query", "required": true, "schema": { "type": "string", "description": "dataset_version_item_id of the golden prompt", "title": "Item" }, "description": "dataset_version_item_id of the golden prompt" }, { "name": "baseline", "in": "query", "required": true, "schema": { "type": "string", "description": "baseline run id to diff against", "title": "Baseline" }, "description": "baseline run id to diff against" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scenario-suites": { "get": { "tags": [ "scenario-suites" ], "summary": "List Suites", "operationId": "list_suites_scenario_suites_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "scenario-suites" ], "summary": "Create Suite", "description": "Create a scenario suite from a set of failure modes + kick off generation.", "operationId": "create_suite_scenario_suites_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Body" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scenario-suites/{suite_id}": { "get": { "tags": [ "scenario-suites" ], "summary": "Get Suite", "operationId": "get_suite_scenario_suites__suite_id__get", "parameters": [ { "name": "suite_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Suite Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "scenario-suites" ], "summary": "Delete Suite", "description": "Hard-delete a suite AND its owned synthetic dataset (items + versions). A launched pre-prod\nrun already snapshotted its items, so it is unaffected.", "operationId": "delete_suite_scenario_suites__suite_id__delete", "parameters": [ { "name": "suite_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Suite Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scenario-suites/{suite_id}/scenarios": { "get": { "tags": [ "scenario-suites" ], "summary": "List Scenarios", "operationId": "list_scenarios_scenario_suites__suite_id__scenarios_get", "parameters": [ { "name": "suite_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Suite Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 1000, "minimum": 1, "default": 200, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scenario-suites/{suite_id}/regenerate": { "post": { "tags": [ "scenario-suites" ], "summary": "Regenerate Suite", "description": "Re-run generation for a suite (e.g. after adding exemplars or configuring an LLM). Optional\nbody may override ``per_mode``/``strategies``/``include_replay``/``connection_id``.", "operationId": "regenerate_suite_scenario_suites__suite_id__regenerate_post", "parameters": [ { "name": "suite_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Suite Id" } } ], "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": true }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scenario-suites/{suite_id}/launch": { "post": { "tags": [ "scenario-suites" ], "summary": "Launch Suite", "description": "One-click: create a pre-prod eval run over this suite's synthetic golden dataset.", "operationId": "launch_suite_scenario_suites__suite_id__launch_post", "parameters": [ { "name": "suite_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Suite Id" } } ], "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": true }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/topics/atlas": { "get": { "tags": [ "topics" ], "summary": "Get Atlas", "operationId": "get_atlas_topics_atlas_get", "parameters": [ { "name": "space", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Space" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Case-insensitive substring match on name", "title": "Q" }, "description": "Case-insensitive substring match on name" }, { "name": "severity", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" } }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort Dir" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/topics/{topic_id}": { "get": { "tags": [ "topics" ], "summary": "Get Topic", "operationId": "get_topic_topics__topic_id__get", "parameters": [ { "name": "topic_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Topic Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "topics" ], "summary": "Patch Topic", "operationId": "patch_topic_topics__topic_id__patch", "parameters": [ { "name": "topic_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Topic Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/topics/{topic_id}/examples": { "get": { "tags": [ "topics" ], "summary": "Get Examples", "operationId": "get_examples_topics__topic_id__examples_get", "parameters": [ { "name": "topic_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Topic Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/topics/spaces": { "post": { "tags": [ "topics" ], "summary": "Create Space", "operationId": "create_space_topics_spaces_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/topics": { "post": { "tags": [ "topics" ], "summary": "Create Topic", "operationId": "create_topic_topics_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/topics/{topic_id}/merge": { "post": { "tags": [ "topics" ], "summary": "Merge Topic", "operationId": "merge_topic_topics__topic_id__merge_post", "parameters": [ { "name": "topic_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Topic Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/topics/{topic_id}/split": { "post": { "tags": [ "topics" ], "summary": "Split Topic", "operationId": "split_topic_topics__topic_id__split_post", "parameters": [ { "name": "topic_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Topic Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/topics/{topic_id}/datasets": { "post": { "tags": [ "topics" ], "summary": "Create Dataset", "operationId": "create_dataset_topics__topic_id__datasets_post", "parameters": [ { "name": "topic_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Topic Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/activity/trend": { "get": { "tags": [ "activity" ], "summary": "Activity Trend", "description": "Event-volume trend for the Activity page: per-day (or per-hour) count of activity runs over\nthe selected window, plus a period-over-period total. Scoped to the current project like the\nfeed. Queued-but-unstarted runs are excluded \u2014 they have no place on a time axis yet.", "operationId": "activity_trend_activity_trend_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "grain", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/activity/runs": { "get": { "tags": [ "activity" ], "summary": "List Runs", "operationId": "list_runs_activity_runs_get", "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" } }, { "name": "state", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "State" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "started_after", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started After" } }, { "name": "started_before", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Started Before" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" } }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort Dir" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 100, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/eval-runs/{run_id}/metrics": { "get": { "tags": [ "activity" ], "summary": "Run Metrics", "description": "Real pipeline metrics for a score run, derived from activity_runs +\neval_tasks (no synthetic data). ``run_id`` is the activity-run id\n(``act_eval_{eval_run_id}``).", "operationId": "run_metrics_eval_runs__run_id__metrics_get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user-enrichments": { "get": { "tags": [ "enrichments" ], "summary": "List Enrichments", "operationId": "list_enrichments_user_enrichments_get", "parameters": [ { "name": "name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" } }, { "name": "mode", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mode" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "target_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Target Type" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" } }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort Dir" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "enrichments" ], "summary": "Create Enrichment", "operationId": "create_enrichment_user_enrichments_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateEnrichmentBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user-enrichments/{enrichment_id}": { "patch": { "tags": [ "enrichments" ], "summary": "Update Enrichment", "description": "Edit an enrichment. Metadata (name / output fields / prerequisites / status) mutates in\nplace; a changed ``definition`` (prompt or LLM connection) creates a new immutable version\nand promotes it (version history stays append-only, matching ``POST.../versions``).\nDisable = ``status='draft'`` (also drops the on-ingest trigger back to manual); re-enable =\n``status='enabled'``.", "operationId": "update_enrichment_user_enrichments__enrichment_id__patch", "parameters": [ { "name": "enrichment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Enrichment Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateEnrichmentBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "enrichments" ], "summary": "Delete Enrichment", "description": "Hard-delete an enrichment and everything it owns \u2014 versions, runs, computed outputs, and\nits Activity-feed reflections \u2014 project-scoped so a scoped caller can't delete another\nproject's enrichment.", "operationId": "delete_enrichment_user_enrichments__enrichment_id__delete", "parameters": [ { "name": "enrichment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Enrichment Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user-enrichments/{enrichment_id}/versions": { "post": { "tags": [ "enrichments" ], "summary": "Create Version", "operationId": "create_version_user_enrichments__enrichment_id__versions_post", "parameters": [ { "name": "enrichment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Enrichment Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VersionBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user-enrichments/{enrichment_id}/deployments": { "post": { "tags": [ "enrichments" ], "summary": "Create Deployment", "operationId": "create_deployment_user_enrichments__enrichment_id__deployments_post", "parameters": [ { "name": "enrichment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Enrichment Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user-enrichment-runs": { "post": { "tags": [ "enrichments" ], "summary": "Create Run", "operationId": "create_run_user_enrichment_runs_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/user-enrichment-runs/{run_id}": { "get": { "tags": [ "enrichments" ], "summary": "Get Run", "operationId": "get_run_user_enrichment_runs__run_id__get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } }, { "name": "sample", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 0, "default": 20, "title": "Sample" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/enrichment-catalog": { "get": { "tags": [ "enrichments" ], "summary": "Enrichment Catalog", "operationId": "enrichment_catalog_enrichment_catalog_get", "parameters": [ { "name": "targetType", "in": "query", "required": false, "schema": { "type": "string", "default": "trace", "title": "Targettype" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/enrichment-fields": { "get": { "tags": [ "enrichments" ], "summary": "Enrichment Fields", "description": "The enrichment output fields that actually have values in this project, with the\ndistinct values observed (capped). Drives the Traces/Sessions enrichment filter and the\n\"Create dataset from enrichment\" picker. Only fields with at least one output are returned,\nso the UI never offers a filter that can't match anything.", "operationId": "enrichment_fields_enrichment_fields_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/user-enrichments/{enrichment_id}/dataset": { "post": { "tags": [ "enrichments" ], "summary": "Create Dataset From Enrichment", "description": "The enrichment\u2192dataset\u2192judge bridge: materialize a dataset whose membership is every\nsession whose enrichment output ``field == value``. The dataset carries an\n``enrichment_filter`` source config, so (when ``streaming``) hourly sync keeps the cohort\nfresh as new traces are enriched \u2014 then any judge eval-run can target it via ``dataset_id``.", "operationId": "create_dataset_from_enrichment_user_enrichments__enrichment_id__dataset_post", "parameters": [ { "name": "enrichment_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Enrichment Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DatasetFromEnrichmentBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/companies": { "get": { "tags": [ "tenancy" ], "summary": "List Companies", "operationId": "list_companies_companies_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/orgs": { "get": { "tags": [ "tenancy" ], "summary": "List Orgs", "operationId": "list_orgs_orgs_get", "parameters": [ { "name": "company_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "tenancy" ], "summary": "Create Org", "description": "Create an org in the caller's company (admin-gated; enforces the tier's org cap).", "operationId": "create_org_orgs_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrgCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/orgs/{org_id}": { "patch": { "tags": [ "tenancy" ], "summary": "Update Org", "description": "Rename an org (or update its slug) within the caller's company.", "operationId": "update_org_orgs__org_id__patch", "parameters": [ { "name": "org_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Org Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrgUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/projects": { "get": { "tags": [ "tenancy" ], "summary": "List Projects", "operationId": "list_projects_projects_get", "parameters": [ { "name": "org_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Org Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "tenancy" ], "summary": "Create Project", "description": "Create a new project under an org.", "operationId": "create_project_projects_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/projects/current": { "get": { "tags": [ "tenancy" ], "summary": "Current Project", "description": "Report the project THIS connection is scoped to.", "operationId": "current_project_projects_current_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/projects/{project_id}": { "get": { "tags": [ "tenancy" ], "summary": "Get Project", "operationId": "get_project_projects__project_id__get", "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "tenancy" ], "summary": "Update Project", "operationId": "update_project_projects__project_id__patch", "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Project Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "tenancy" ], "summary": "Delete Project", "description": "Delete a project and every data-plane row scoped to it.", "operationId": "delete_project_projects__project_id__delete", "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/projects/{project_id}/prefs": { "put": { "tags": [ "tenancy" ], "summary": "Set Project Pref", "description": "Toggle the current user's per-user preference for a project (favorite on/off).", "operationId": "set_project_pref_projects__project_id__prefs_put", "parameters": [ { "name": "project_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Project Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProjectPref" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/users": { "get": { "tags": [ "tenancy" ], "summary": "List Users", "operationId": "list_users_users_get", "parameters": [ { "name": "company_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/memberships": { "get": { "tags": [ "tenancy" ], "summary": "List Memberships", "operationId": "list_memberships_memberships_get", "parameters": [ { "name": "user_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/overview": { "get": { "tags": [ "tenancy" ], "summary": "Overview", "description": "Tenancy tree (companies \u2192 orgs \u2192 projects) with per-project session counts.", "operationId": "overview_overview_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/login": { "post": { "tags": [ "auth" ], "summary": "Login", "description": "Verify email + password, issue a session token, return it with the user profile.", "operationId": "login_auth_login_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LoginBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/logout": { "post": { "tags": [ "auth" ], "summary": "Logout", "description": "Revoke the presented session token (best-effort; idempotent).", "operationId": "logout_auth_logout_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/me": { "get": { "tags": [ "auth" ], "summary": "Me", "description": "Return the currently authenticated user, or 401 if there is no valid session.", "operationId": "me_auth_me_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/me/workspace": { "get": { "tags": [ "auth" ], "summary": "Workspace", "description": "Single bootstrap contract the SPA renders its shell from.", "operationId": "workspace_me_workspace_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/accept-invite": { "post": { "tags": [ "auth" ], "summary": "Accept Invite", "description": "Activate an invited user: set their password from a one-time token, log them in.", "operationId": "accept_invite_auth_accept_invite_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AcceptInviteBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/change-password": { "post": { "tags": [ "auth" ], "summary": "Change Password", "description": "Change the signed-in user's password after re-verifying the current one.", "operationId": "change_password_auth_change_password_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChangePasswordBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/locale": { "put": { "tags": [ "auth" ], "summary": "Set Locale", "description": "Persist the signed-in user's preferred UI language.", "operationId": "set_locale_auth_locale_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetLocaleBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/persona": { "put": { "tags": [ "auth" ], "summary": "Set Persona", "description": "Record the signed-in user's persona lens.", "operationId": "set_persona_auth_persona_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetPersonaBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/digest": { "put": { "tags": [ "auth" ], "summary": "Set Digest", "description": "Set the signed-in user's persona digest email preference.", "operationId": "set_digest_auth_digest_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetDigestBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/digest/test": { "post": { "tags": [ "auth" ], "summary": "Send Test Digest", "description": "Compose the signed-in user's persona digest NOW and send it, ignoring the daily cadence.", "operationId": "send_test_digest_auth_digest_test_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/forgot-password": { "post": { "tags": [ "auth" ], "summary": "Forgot Password", "description": "Begin a forgotten-password reset for a registered user. Always returns a uniform 200.", "operationId": "forgot_password_auth_forgot_password_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ForgotPasswordBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/reset-password/validate": { "get": { "tags": [ "auth" ], "summary": "Validate Reset Token", "description": "Cheap pre-flight check the reset page runs before showing its form.", "operationId": "validate_reset_token_auth_reset_password_validate_get", "parameters": [ { "name": "token", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Token" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/reset-password": { "post": { "tags": [ "auth" ], "summary": "Reset Password", "description": "Complete a forgotten-password reset from a one-time token, then sign the user in.", "operationId": "reset_password_auth_reset_password_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResetPasswordBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/password-policy": { "get": { "tags": [ "auth" ], "summary": "Password Policy", "description": "The set-password rules the server will actually enforce: ``{minLength, breachCheck}``.", "operationId": "password_policy_auth_password_policy_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/sessions": { "get": { "tags": [ "auth" ], "summary": "List Sessions", "description": "The caller's OWN live sessions \u2014 \"where am I signed in\".", "operationId": "list_sessions_auth_sessions_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/sessions/{session_id}": { "delete": { "tags": [ "auth" ], "summary": "Revoke Session", "description": "Revoke ONE of the caller's own sessions \u2014 the \"I don't recognise that device\" action.", "operationId": "revoke_session_auth_sessions__session_id__delete", "parameters": [ { "name": "session_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Session Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/sessions/revoke-all": { "post": { "tags": [ "auth" ], "summary": "Revoke All Sessions", "description": "Sign out everywhere. Returns ``{\"revoked\": n}`` \u2014 how many sessions were actually ended.", "operationId": "revoke_all_sessions_auth_sessions_revoke_all_post", "parameters": [ { "name": "includeCurrent", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Includecurrent" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/mfa": { "get": { "tags": [ "auth" ], "summary": "Mfa Status", "description": "The caller's own MFA state. Reachable on an ``mfa_pending`` session \u2014 it is what the\nenrolment screen reads to know what to show.", "operationId": "mfa_status_auth_mfa_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/mfa/enroll": { "post": { "tags": [ "auth" ], "summary": "Mfa Enroll", "description": "Issue a fresh TOTP secret + provisioning URI. **Does not enable anything.**", "operationId": "mfa_enroll_auth_mfa_enroll_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnrollBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/mfa/verify": { "post": { "tags": [ "auth" ], "summary": "Mfa Verify", "description": "Confirm a code against the PENDING secret, then enable MFA and mint the recovery codes.", "operationId": "mfa_verify_auth_mfa_verify_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VerifyBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/mfa/challenge": { "post": { "tags": [ "auth" ], "summary": "Mfa Challenge", "description": "Exchange a ``nk_mfa_\u2026`` token + a second factor for a real session. **Unauthenticated.**", "operationId": "mfa_challenge_auth_mfa_challenge_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChallengeBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/mfa/disable": { "post": { "tags": [ "auth" ], "summary": "Mfa Disable", "description": "Turn the second factor off, after re-proving BOTH the password and the factor itself.", "operationId": "mfa_disable_auth_mfa_disable_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProveBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/mfa/recovery-codes": { "post": { "tags": [ "auth" ], "summary": "Mfa Regenerate Recovery Codes", "description": "Replace every outstanding recovery code. Returns the new set, shown once.", "operationId": "mfa_regenerate_recovery_codes_auth_mfa_recovery_codes_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProveBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/sso/providers": { "get": { "tags": [ "auth" ], "summary": "Sso Providers", "description": "Which SSO connection (if any) serves this email's domain \u2014 the login page's \"Sign in with\nSSO\" affordance. No secrets in the response.", "operationId": "sso_providers_auth_sso_providers_get", "parameters": [ { "name": "email", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Email" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/sso/{connection_id}/start": { "get": { "tags": [ "auth" ], "summary": "Sso Start", "description": "Begin an SSO login: build the authz redirect and 302 to the IdP.", "operationId": "sso_start_auth_sso__connection_id__start_get", "parameters": [ { "name": "connection_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Connection Id" } }, { "name": "redirect", "in": "query", "required": false, "schema": { "type": "string", "default": "/", "title": "Redirect" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/sso/oidc/callback": { "get": { "tags": [ "auth" ], "summary": "Sso Oidc Callback", "description": "OIDC authorization-code callback: consume state, exchange the code with PKCE, fully validate\nthe id_token, JIT-provision, and deliver the session (or an MFA challenge) to the SPA.", "operationId": "sso_oidc_callback_auth_sso_oidc_callback_get", "parameters": [ { "name": "code", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Code" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "State" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/sso/saml/acs": { "post": { "tags": [ "auth" ], "summary": "Sso Saml Acs", "description": "SAML Assertion Consumer Service (SP-initiated POST binding): validate the signed assertion and\ndeliver the session (or an MFA challenge) to the SPA.", "operationId": "sso_saml_acs_auth_sso_saml_acs_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/sso/saml/{connection_id}/metadata": { "get": { "tags": [ "auth" ], "summary": "Sso Saml Metadata", "description": "SP metadata XML for the IdP administrator (application/xml).", "operationId": "sso_saml_metadata_auth_sso_saml__connection_id__metadata_get", "parameters": [ { "name": "connection_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Connection Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/sso/connections": { "get": { "tags": [ "auth" ], "summary": "List Connections", "description": "List this company's SSO connections (client secrets never returned).", "operationId": "list_connections_auth_sso_connections_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "auth" ], "summary": "Create Connection", "description": "Create an SSO connection for this company. Protocol-specific required fields are validated\nbefore the store persists (and Fernet-encrypts any client secret).", "operationId": "create_connection_auth_sso_connections_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/sso/connections/{connection_id}": { "get": { "tags": [ "auth" ], "summary": "Get Connection", "description": "Read one connection (company-scoped; client secret never returned).", "operationId": "get_connection_auth_sso_connections__connection_id__get", "parameters": [ { "name": "connection_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Connection Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "auth" ], "summary": "Update Connection", "description": "Patch a connection (company-scoped). A raw ``oidcClientSecret`` is encrypted by the store; a\nsupplied required field may not be blanked.", "operationId": "update_connection_auth_sso_connections__connection_id__patch", "parameters": [ { "name": "connection_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Connection Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "auth" ], "summary": "Delete Connection", "description": "Delete a connection and its domain mappings (company-scoped).", "operationId": "delete_connection_auth_sso_connections__connection_id__delete", "parameters": [ { "name": "connection_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Connection Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/auth/sso/connections/{connection_id}/domains": { "put": { "tags": [ "auth" ], "summary": "Set Connection Domains", "description": "Set the email domains routed to this connection (home-realm discovery). A domain already\nclaimed by another company hits the UNIQUE index \u2014 surfaced as a clean 409.", "operationId": "set_connection_domains_auth_sso_connections__connection_id__domains_put", "parameters": [ { "name": "connection_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Connection Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/.well-known/oauth-protected-resource": { "get": { "tags": [ "mcp-oauth" ], "summary": "Oauth Protected Resource", "description": "RFC 9728 protected-resource metadata (fully wired).", "operationId": "oauth_protected_resource__well_known_oauth_protected_resource_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/.well-known/oauth-protected-resource/mcp": { "get": { "tags": [ "mcp-oauth" ], "summary": "Oauth Protected Resource Mcp", "description": "RFC 9728 metadata under the resource path some clients probe (fully wired).", "operationId": "oauth_protected_resource_mcp__well_known_oauth_protected_resource_mcp_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/.well-known/oauth-authorization-server": { "get": { "tags": [ "mcp-oauth" ], "summary": "Oauth Authorization Server", "description": "RFC 8414 authorization-server metadata (fully wired).", "operationId": "oauth_authorization_server__well_known_oauth_authorization_server_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/oauth/register": { "post": { "tags": [ "mcp-oauth" ], "summary": "Oauth Register", "description": "Full Dynamic Client Registration (RFC 7591) + RFC 7592 registration credential.", "operationId": "oauth_register_oauth_register_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/oauth/register/{client_id}": { "get": { "tags": [ "mcp-oauth" ], "summary": "Oauth Register Get", "description": "RFC 7592 client read \u2014 return the current registration (registration-token authed).", "operationId": "oauth_register_get_oauth_register__client_id__get", "parameters": [ { "name": "client_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Client Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "mcp-oauth" ], "summary": "Oauth Register Put", "description": "RFC 7592 client update \u2014 apply whitelisted metadata (registration-token authed).", "operationId": "oauth_register_put_oauth_register__client_id__put", "parameters": [ { "name": "client_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Client Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "mcp-oauth" ], "summary": "Oauth Register Delete", "description": "RFC 7592 client delete \u2014 soft-disable the client (registration-token authed). 204.", "operationId": "oauth_register_delete_oauth_register__client_id__delete", "parameters": [ { "name": "client_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Client Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/oauth/authorize": { "get": { "tags": [ "mcp-oauth" ], "summary": "Oauth Authorize", "description": "OAuth 2.1 authorization endpoint (the browser entry point from Claude Code).", "operationId": "oauth_authorize_oauth_authorize_get", "parameters": [ { "name": "response_type", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Response Type" } }, { "name": "client_id", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Client Id" } }, { "name": "redirect_uri", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Redirect Uri" } }, { "name": "code_challenge", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Code Challenge" } }, { "name": "code_challenge_method", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Code Challenge Method" } }, { "name": "state", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "State" } }, { "name": "scope", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Scope" } }, { "name": "resource", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Resource" } }, { "name": "login_hint", "in": "query", "required": false, "schema": { "type": "string", "default": "", "title": "Login Hint" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/oauth/authorize/decision": { "post": { "tags": [ "mcp-oauth" ], "summary": "Oauth Authorize Decision", "description": "The SPA consent callback (bearer ``nk_sess_``-authenticated).", "operationId": "oauth_authorize_decision_oauth_authorize_decision_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/oauth/token": { "post": { "tags": [ "mcp-oauth" ], "summary": "Oauth Token", "description": "OAuth 2.1 token endpoint (``grant_type=authorization_code``).", "operationId": "oauth_token_oauth_token_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/oauth/revoke": { "post": { "tags": [ "mcp-oauth" ], "summary": "Oauth Revoke", "description": "RFC 7009 token revocation \u2014 user-scoped.", "operationId": "oauth_revoke_oauth_revoke_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/oauth/introspect": { "post": { "tags": [ "mcp-oauth" ], "summary": "Oauth Introspect", "description": "RFC 7662 token introspection.", "operationId": "oauth_introspect_oauth_introspect_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/mcp/tokens": { "get": { "tags": [ "mcp-oauth" ], "summary": "List My Mcp Tokens", "description": "List the caller's OWN active ``nk_mcp_`` tokens (bearer ``nk_sess_``/``nk_mcp_`` auth).", "operationId": "list_my_mcp_tokens_auth_mcp_tokens_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/auth/mcp/tokens/{token_id}": { "delete": { "tags": [ "mcp-oauth" ], "summary": "Revoke My Mcp Token", "description": "Revoke one of the caller's OWN ``nk_mcp_`` tokens by id (bearer-authenticated).", "operationId": "revoke_my_mcp_token_auth_mcp_tokens__token_id__delete", "parameters": [ { "name": "token_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Token Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/members": { "get": { "tags": [ "members" ], "summary": "List Members", "description": "List the caller company's members (directory users + their status/role).", "operationId": "list_members_members_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/members/{user_id}/activity": { "get": { "tags": [ "members" ], "summary": "Member Activity", "description": "Lifecycle timeline for one member: the tenant audit events targeting them.", "operationId": "member_activity_members__user_id__activity_get", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/members/invite": { "post": { "tags": [ "members" ], "summary": "Invite Member", "description": "Invite a new member: create an ``invited`` directory user + a one-time activation link.", "operationId": "invite_member_members_invite_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InviteBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/members/bulk-persona": { "post": { "tags": [ "members" ], "summary": "Bulk Assign Persona", "description": "Set (or clear) the persona DEFAULT for a set of the caller company's members at once.", "operationId": "bulk_assign_persona_members_bulk_persona_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkPersonaBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/members/bulk-orgs": { "post": { "tags": [ "members" ], "summary": "Bulk Set Orgs", "description": "Assign org access to several members at once.", "operationId": "bulk_set_orgs_members_bulk_orgs_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BulkOrgsBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/members/{user_id}": { "patch": { "tags": [ "members" ], "summary": "Update Member", "description": "Change a member's role or status (e.g. disable). Scoped to the caller's company.", "operationId": "update_member_members__user_id__patch", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateMemberBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "members" ], "summary": "Remove Member", "description": "Remove a member (delete the directory user + revoke their sessions).", "operationId": "remove_member_members__user_id__delete", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/members/{user_id}/orgs": { "put": { "tags": [ "members" ], "summary": "Set Member Orgs", "description": "Assign a member to one or more orgs. A full REPLACE of the member's\norg-scoped membership grants, scoped to the caller's company. Admin-gated.", "operationId": "set_member_orgs_members__user_id__orgs_put", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SetMemberOrgsBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/members/{user_id}/resend-invite": { "post": { "tags": [ "members" ], "summary": "Resend Invite", "description": "Rotate an invited member's activation token and return a fresh one-time link.", "operationId": "resend_invite_members__user_id__resend_invite_post", "parameters": [ { "name": "user_id", "in": "path", "required": true, "schema": { "type": "string", "title": "User Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/overview/kpis": { "get": { "tags": [ "overview" ], "summary": "Overview Kpis", "description": "Hero KPI row: spine counts + scope-wide trace/session/error/spend totals + deltas.", "operationId": "overview_kpis_overview_kpis_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "30d", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/overview/timeseries": { "get": { "tags": [ "overview" ], "summary": "Overview Timeseries", "description": "Tenant trends: per-day traces / sessions / errors / eval pass-rate / spend over the range.", "operationId": "overview_timeseries_overview_timeseries_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "30d", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/overview/segments": { "get": { "tags": [ "overview" ], "summary": "Overview Segments", "description": "Segmentation table: scope sliced by org | project | agent.", "operationId": "overview_segments_overview_segments_get", "parameters": [ { "name": "by", "in": "query", "required": false, "schema": { "type": "string", "default": "org", "title": "By" } }, { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "30d", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/insights/observe": { "get": { "tags": [ "insights" ], "summary": "Observe", "description": "``{fleet:{sessions, errorRate, p99Ms, spendUsd}, anomalies:[\u2026]}``.", "operationId": "observe_insights_observe_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "24h", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "project_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/insights/diagnose": { "get": { "tags": [ "insights" ], "summary": "Diagnose", "description": "The Diagnose feed: ``{issues:[{projectId, type:'cluster'|'regression', label, affected,\nconfidence, link, asOf}]}`` \u2014 failure clusters and score regressions across the accessible\nprojects, filterable by ``range`` / ``from`` / ``to`` and repeatable ``project_id``.", "operationId": "diagnose_insights_diagnose_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "24h", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "project_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/insights/fix": { "get": { "tags": [ "insights" ], "summary": "Fix", "description": "The Fix feed: ``{remediations:[{projectId, clusterLabel, summary, likelyCause,\nrecommendation, confidence, affected}]}`` \u2014 suggested remediations for the latest failure\nclusters, highest-impact first. Repeatable ``project_id`` narrows the scope.", "operationId": "fix_insights_fix_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "24h", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "project_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/insights/refresh": { "post": { "tags": [ "insights" ], "summary": "Refresh", "description": "Run the anomaly + regression detectors now, within the caller's pinned tenant schema,\nover their accessible project set (``None`` \u21d2 all projects in the schema). Persists to\nthe insight store + dispatches newly-surfaced insights to the configured sinks. Returns\n``{detected, surfaced}`` counts. This is the synchronous counterpart to the nightly\nscheduler job \u2014 useful for the demo and for a 'refresh now' UI affordance.", "operationId": "refresh_insights_refresh_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/insights/summary": { "get": { "tags": [ "insights" ], "summary": "Summary", "description": "``{headline, body, llm, model, stats, empty, cached, generatedAt, briefing}`` \u2014 a short\nbriefing over the current fleet KPIs + top anomalies / issues / remediations for the scope +\nwindow.", "operationId": "summary_insights_summary_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "24h", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "project_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "array", "items": { "type": "string" } }, { "type": "null" } ], "title": "Project Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/insights/summary/briefing": { "post": { "tags": [ "insights" ], "summary": "Request Briefing", "description": "Request generation of the LLM narrative for a scope + window. **Idempotent.**", "operationId": "request_briefing_insights_summary_briefing_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BriefingRequest" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/insights/summary/briefing/{briefing_id}": { "get": { "tags": [ "insights" ], "summary": "Get Briefing", "description": "The cheap poll: ONE indexed row read, no measure or cluster queries \u2014 this is polled every\nfew seconds while a narrative generates.", "operationId": "get_briefing_insights_summary_briefing__briefing_id__get", "parameters": [ { "name": "briefing_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Briefing Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/insights/{insight_id}/feedback": { "post": { "tags": [ "insights" ], "summary": "Submit Feedback", "description": "Record user feedback on a surfaced insight. ``verdict`` \u2208\n``useful|actioned|not_useful|wrong|dismissed`` \u2014 a negative verdict (``not_useful``/\n``wrong``/``dismissed``) mutes the insight on the next detection pass until its signal\nresolves and recurs. 404 if the insight id is unknown.", "operationId": "submit_feedback_insights__insight_id__feedback_post", "parameters": [ { "name": "insight_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Insight Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedbackBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "insights" ], "summary": "Get Feedback", "description": "List the feedback recorded for an insight (most recent first). A scoped member/viewer\nmay only read feedback for an insight in a project they can access; an unknown id (incl.\none outside the pinned tenant schema) returns an empty list \u2014 no existence leak.", "operationId": "get_feedback_insights__insight_id__feedback_get", "parameters": [ { "name": "insight_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Insight Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/alerts": { "get": { "tags": [ "alerts" ], "summary": "List Alerts", "description": "List the project's alert rules (newest first).", "operationId": "list_alerts_alerts_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Alerts Alerts Get" } } } } } }, "post": { "tags": [ "alerts" ], "summary": "Create Alert", "operationId": "create_alert_alerts_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertRuleCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Alert Alerts Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/alerts/catalogue": { "get": { "tags": [ "alerts" ], "summary": "Alert Catalogue", "description": "The alertable measures + comparators + windows the rule-builder picker renders.", "operationId": "alert_catalogue_alerts_catalogue_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Alert Catalogue Alerts Catalogue Get" } } } } } } }, "/alerts/{rule_id}": { "get": { "tags": [ "alerts" ], "summary": "Get Alert", "operationId": "get_alert_alerts__rule_id__get", "parameters": [ { "name": "rule_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Rule Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Alert Alerts Rule Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "alerts" ], "summary": "Update Alert", "operationId": "update_alert_alerts__rule_id__patch", "parameters": [ { "name": "rule_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Rule Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AlertRuleUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Update Alert Alerts Rule Id Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "alerts" ], "summary": "Delete Alert", "operationId": "delete_alert_alerts__rule_id__delete", "parameters": [ { "name": "rule_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Rule Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Delete Alert Alerts Rule Id Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/alerts/{rule_id}/events": { "get": { "tags": [ "alerts" ], "summary": "Get Alert Events", "operationId": "get_alert_events_alerts__rule_id__events_get", "parameters": [ { "name": "rule_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Rule Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Alert Events Alerts Rule Id Events Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/alerts/{rule_id}/test": { "post": { "tags": [ "alerts" ], "summary": "Test Alert", "description": "Evaluate the rule NOW as a dry-run \u2014 resolve its metric over the window and report the value\n+ whether it would breach \u2014 WITHOUT recording an insight, firing a sink, or touching bookkeeping.\nThe 'Test' button in the rule editor.", "operationId": "test_alert_alerts__rule_id__test_post", "parameters": [ { "name": "rule_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Rule Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Test Alert Alerts Rule Id Test Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/measures/catalogue": { "get": { "tags": [ "dashboards" ], "summary": "Measure Catalogue", "description": "The measure catalogue: each measure + the dimensions valid for it + the widget types.", "operationId": "measure_catalogue_measures_catalogue_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/measures/fields": { "get": { "tags": [ "dashboards" ], "summary": "Measures Fields", "description": "Discover dynamic, sliceable ``session.metadata.*`` keys for the current scope.", "operationId": "measures_fields_measures_fields_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/dashboards": { "get": { "tags": [ "dashboards" ], "summary": "List Dashboards", "operationId": "list_dashboards_dashboards_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "dashboards" ], "summary": "Create Dashboard", "operationId": "create_dashboard_dashboards_post", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Body" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboards/favorites": { "get": { "tags": [ "dashboards" ], "summary": "List Favorites", "description": "The caller's favorited dashboards.", "operationId": "list_favorites_dashboards_favorites_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/dashboards/by-slug/{slug}": { "get": { "tags": [ "dashboards" ], "summary": "Get Dashboard By Slug", "description": "Resolve a dashboard by its stable ``slug`` within the caller's tenant.", "operationId": "get_dashboard_by_slug_dashboards_by_slug__slug__get", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "title": "Slug" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboards/{dash_id}": { "get": { "tags": [ "dashboards" ], "summary": "Get Dashboard", "operationId": "get_dashboard_dashboards__dash_id__get", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "dashboards" ], "summary": "Update Dashboard", "operationId": "update_dashboard_dashboards__dash_id__patch", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "dashboards" ], "summary": "Delete Dashboard", "operationId": "delete_dashboard_dashboards__dash_id__delete", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboards/{dash_id}/clone": { "post": { "tags": [ "dashboards" ], "summary": "Clone Dashboard", "description": "Deep-clone a dashboard the caller can see into a fresh **private** copy they own.", "operationId": "clone_dashboard_dashboards__dash_id__clone_post", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } } ], "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "type": "object", "additionalProperties": true }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboards/{dash_id}/widgets": { "post": { "tags": [ "dashboards" ], "summary": "Add Widget", "operationId": "add_widget_dashboards__dash_id__widgets_post", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboards/{dash_id}/widgets/reorder": { "post": { "tags": [ "dashboards" ], "summary": "Reorder Widgets", "description": "Persist a new widget display order.", "operationId": "reorder_widgets_dashboards__dash_id__widgets_reorder_post", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboards/{dash_id}/widgets/{wid}": { "patch": { "tags": [ "dashboards" ], "summary": "Update Widget", "operationId": "update_widget_dashboards__dash_id__widgets__wid__patch", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } }, { "name": "wid", "in": "path", "required": true, "schema": { "type": "string", "title": "Wid" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "dashboards" ], "summary": "Delete Widget", "operationId": "delete_widget_dashboards__dash_id__widgets__wid__delete", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } }, { "name": "wid", "in": "path", "required": true, "schema": { "type": "string", "title": "Wid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboards/{dash_id}/widgets/{wid}/clone": { "post": { "tags": [ "dashboards" ], "summary": "Clone Widget", "description": "Duplicate a widget within the same dashboard (config + color preserved).", "operationId": "clone_widget_dashboards__dash_id__widgets__wid__clone_post", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } }, { "name": "wid", "in": "path", "required": true, "schema": { "type": "string", "title": "Wid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboards/{dash_id}/widgets/{wid}/data": { "get": { "tags": [ "dashboards" ], "summary": "Widget Data", "description": "Resolve a widget's data LIVE via ``run_measure`` \u2014 the render-time data fetch.", "operationId": "widget_data_dashboards__dash_id__widgets__wid__data_get", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } }, { "name": "wid", "in": "path", "required": true, "schema": { "type": "string", "title": "Wid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/dashboards/favorites/{dash_id}": { "post": { "tags": [ "dashboards" ], "summary": "Add Favorite", "operationId": "add_favorite_dashboards_favorites__dash_id__post", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "dashboards" ], "summary": "Remove Favorite", "operationId": "remove_favorite_dashboards_favorites__dash_id__delete", "parameters": [ { "name": "dash_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Dash Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/failure-modes": { "get": { "tags": [ "taxonomy" ], "summary": "List Failure Modes", "operationId": "list_failure_modes_taxonomy_failure_modes_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "severity", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" } }, { "name": "provenance", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provenance" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Case-insensitive substring match on name", "title": "Q" }, "description": "Case-insensitive substring match on name" }, { "name": "sort_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" } }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort Dir" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "taxonomy" ], "summary": "Create Failure Mode", "operationId": "create_failure_mode_taxonomy_failure_modes_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FailureModeCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/failure-modes/import-template": { "get": { "tags": [ "taxonomy" ], "summary": "Failure Modes Import Template", "description": "Download the CSV import template (header + two illustrative rows).", "operationId": "failure_modes_import_template_taxonomy_failure_modes_import_template_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/taxonomy/failure-modes/{mode_id}": { "get": { "tags": [ "taxonomy" ], "summary": "Get Failure Mode", "operationId": "get_failure_mode_taxonomy_failure_modes__mode_id__get", "parameters": [ { "name": "mode_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Mode Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "taxonomy" ], "summary": "Patch Failure Mode", "operationId": "patch_failure_mode_taxonomy_failure_modes__mode_id__patch", "parameters": [ { "name": "mode_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Mode Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FailureModePatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "taxonomy" ], "summary": "Delete Failure Mode", "description": "Hard-delete a failure mode and its cluster-evidence links (project-scoped, audited).", "operationId": "delete_failure_mode_taxonomy_failure_modes__mode_id__delete", "parameters": [ { "name": "mode_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Mode Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/failure-modes/import": { "post": { "tags": [ "taxonomy" ], "summary": "Import Failure Modes Endpoint", "description": "Bulk-import a starter taxonomy (Phase C1).", "operationId": "import_failure_modes_endpoint_taxonomy_failure_modes_import_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FailureModeImportBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/failure-modes/import-file": { "post": { "tags": [ "taxonomy" ], "summary": "Import Failure Modes File", "description": "Bulk-import a taxonomy from an uploaded **file** (CSV or JSON) \u2014 the enterprise\n\"upload our failure taxonomy\" path.", "operationId": "import_failure_modes_file_taxonomy_failure_modes_import_file_post", "parameters": [ { "name": "format", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "csv|json \u2014 inferred from Content-Type/content when omitted", "title": "Format" }, "description": "csv|json \u2014 inferred from Content-Type/content when omitted" }, { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "default": "candidate", "title": "Status" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/failure-modes/{mode_id}/merge": { "post": { "tags": [ "taxonomy" ], "summary": "Merge Failure Mode", "operationId": "merge_failure_mode_taxonomy_failure_modes__mode_id__merge_post", "parameters": [ { "name": "mode_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Mode Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MergeBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/failure-modes/{mode_id}/split": { "post": { "tags": [ "taxonomy" ], "summary": "Split Failure Mode", "operationId": "split_failure_mode_taxonomy_failure_modes__mode_id__split_post", "parameters": [ { "name": "mode_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Mode Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SplitBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/failure-modes/{mode_id}/links": { "post": { "tags": [ "taxonomy" ], "summary": "Add Link", "operationId": "add_link_taxonomy_failure_modes__mode_id__links_post", "parameters": [ { "name": "mode_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Mode Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LinkBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/failure-modes/{mode_id}/links/{cluster_id}": { "delete": { "tags": [ "taxonomy" ], "summary": "Delete Link", "operationId": "delete_link_taxonomy_failure_modes__mode_id__links__cluster_id__delete", "parameters": [ { "name": "mode_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Mode Id" } }, { "name": "cluster_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Cluster Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/issues": { "get": { "tags": [ "taxonomy" ], "summary": "List Issues", "operationId": "list_issues_taxonomy_issues_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "description": "today|24h|7d|30d|all|custom", "default": "7d", "title": "Range" }, "description": "today|24h|7d|30d|all|custom" }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "state", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter by lifecycleState", "title": "State" }, "description": "Filter by lifecycleState" }, { "name": "severity", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Case-insensitive substring match on name", "title": "Q" }, "description": "Case-insensitive substring match on name" }, { "name": "include_muted", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Include Muted" } }, { "name": "include_resolved", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Include Resolved" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/issues/{mode_id}": { "get": { "tags": [ "taxonomy" ], "summary": "Get Issue", "operationId": "get_issue_taxonomy_issues__mode_id__get", "parameters": [ { "name": "mode_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Mode Id" } }, { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "7d", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/taxonomy/issues/{mode_id}/lifecycle": { "patch": { "tags": [ "taxonomy" ], "summary": "Patch Issue Lifecycle", "operationId": "patch_issue_lifecycle_taxonomy_issues__mode_id__lifecycle_patch", "parameters": [ { "name": "mode_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Mode Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IssueLifecycleBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/review-queue": { "get": { "tags": [ "review" ], "summary": "Review Queue", "description": "Active-learning-ranked sessions a human should review next.", "operationId": "review_queue_review_queue_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "maximum": 200, "minimum": 1 }, { "type": "null" } ], "title": "Limit" } }, { "name": "novelty_budget", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer", "maximum": 50, "minimum": 0 }, { "type": "null" } ], "title": "Novelty Budget" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/review": { "post": { "tags": [ "review" ], "summary": "Create Review", "description": "Write a ground-truth label. Reviewer + role resolved from the request identity.", "operationId": "create_review_review_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReviewCreate" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/review/labels": { "get": { "tags": [ "review" ], "summary": "List Labels", "description": "Unified human-label history \u2014 the source the Annotations tab renders.", "operationId": "list_labels_review_labels_get", "parameters": [ { "name": "targetType", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Targettype" } }, { "name": "verdict", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Verdict" } }, { "name": "reviewer", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reviewer" } }, { "name": "failureModeId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failuremodeid" } }, { "name": "clusterId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Clusterid" } }, { "name": "isGold", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Isgold" } }, { "name": "includeSuperseded", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Includesuperseded" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/review/reviewers": { "get": { "tags": [ "review" ], "summary": "List Label Reviewers", "description": "Distinct reviewers that have written a label in this project. Project-scoped.", "operationId": "list_label_reviewers_review_reviewers_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/review/label-options": { "get": { "tags": [ "review" ], "summary": "Label Options", "description": "Grouped options a reviewer can tag a verdict with: confirmed taxonomy failure modes and\ndiscovered clusters (each carrying its finite L1 ``bucket``/``bucketLabel`` + session count).", "operationId": "label_options_review_label_options_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/review/queue-config": { "get": { "tags": [ "review" ], "summary": "Get Queue Config", "description": "Current review-queue config for the project (defaults synthesized when unset).", "operationId": "get_queue_config_review_queue_config_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "put": { "tags": [ "review" ], "summary": "Put Queue Config", "description": "Upsert the project's review-queue config (gated ``require_action('review')``).", "operationId": "put_queue_config_review_queue_config_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QueueConfigBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/review/leaderboard": { "get": { "tags": [ "review" ], "summary": "Leaderboard", "description": "Per-reviewer QUALITY = agreement with the expert/consensus on **gold** items, not volume.", "operationId": "leaderboard_review_leaderboard_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/review/alignment": { "get": { "tags": [ "review" ], "summary": "List Alignment", "description": "Persisted judge\u2194expert alignment rows (the trend), newest first. Project-scoped.", "operationId": "list_alignment_review_alignment_get", "parameters": [ { "name": "judge_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Judge Id" } }, { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "all", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "latest_only", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Latest Only" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/review/alignment/refresh": { "post": { "tags": [ "review" ], "summary": "Refresh Alignment", "description": "Recompute + persist judge\u2194expert alignment for every judge that has scores.", "operationId": "refresh_alignment_review_alignment_refresh_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/review/alignment/disagreements": { "get": { "tags": [ "review" ], "summary": "Alignment Disagreements", "description": "Sessions where this judge disagreed with expert ground truth, split FN/FP. Project-scoped.", "operationId": "alignment_disagreements_review_alignment_disagreements_get", "parameters": [ { "name": "judge_id", "in": "query", "required": true, "schema": { "type": "string", "title": "Judge Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/review/gold": { "get": { "tags": [ "review" ], "summary": "List Gold", "description": "List the active gold-standard labels (``is_gold = 1``), newest first. Project-scoped.", "operationId": "list_gold_review_gold_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/review/adjudicate": { "post": { "tags": [ "review" ], "summary": "Adjudicate", "description": "Principal override: supersede every conflicting active label on a target and write the\nauthoritative one.", "operationId": "adjudicate_review_adjudicate_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdjudicateBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/flywheel/failure-modes/{mode_id}/generate-eval": { "post": { "tags": [ "flywheel" ], "summary": "Generate Eval", "operationId": "generate_eval_flywheel_failure_modes__mode_id__generate_eval_post", "parameters": [ { "name": "mode_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Mode Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/flywheel/gates": { "get": { "tags": [ "flywheel" ], "summary": "List Gates", "operationId": "list_gates_flywheel_gates_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "failureModeId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failuremodeid" } }, { "name": "name", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" } }, { "name": "sort_by", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort By" } }, { "name": "sort_dir", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sort Dir" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/flywheel/gates/{gate_id}": { "get": { "tags": [ "flywheel" ], "summary": "Get Gate", "description": "Rich single-gate detail: the stored gate row PLUS the provenance it binds together\n(failure mode / judge / dataset / deployment) and a bounded history of its recent eval\nruns, so the UI can explain *what this gate checks*, *when it last ran*, and *how it has\nbeen trending* on one click. Every cross-table read is best-effort and project-scoped.", "operationId": "get_gate_flywheel_gates__gate_id__get", "parameters": [ { "name": "gate_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Gate Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "flywheel" ], "summary": "Patch Gate", "operationId": "patch_gate_flywheel_gates__gate_id__patch", "parameters": [ { "name": "gate_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Gate Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GatePatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/flywheel/gates/{gate_id}/run": { "post": { "tags": [ "flywheel" ], "summary": "Run Gate", "operationId": "run_gate_flywheel_gates__gate_id__run_post", "parameters": [ { "name": "gate_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Gate Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/deploy-events/what-changed": { "get": { "tags": [ "deploy-events" ], "summary": "What Changed", "operationId": "what_changed_deploy_events_what_changed_get", "parameters": [ { "name": "at", "in": "query", "required": true, "schema": { "type": "string", "description": "ISO-8601 reference instant", "title": "At" }, "description": "ISO-8601 reference instant" }, { "name": "agentName", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agentname" } }, { "name": "windowHours", "in": "query", "required": false, "schema": { "type": "integer", "default": 168, "title": "Windowhours" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/deploy-events": { "get": { "tags": [ "deploy-events" ], "summary": "List Deploy Events", "operationId": "list_deploy_events_deploy_events_get", "parameters": [ { "name": "agentName", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agentname" } }, { "name": "since", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Since" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "deploy-events" ], "summary": "Create Deploy Event", "operationId": "create_deploy_event_deploy_events_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeployEventCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/preferences/table-columns": { "get": { "tags": [ "preferences" ], "summary": "Get Table Columns", "operationId": "get_table_columns_preferences_table_columns_get", "parameters": [ { "name": "view", "in": "query", "required": true, "schema": { "type": "string", "title": "View" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "preferences" ], "summary": "Put Table Columns", "operationId": "put_table_columns_preferences_table_columns_put", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TableColumnsUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/onboarding/status": { "get": { "tags": [ "onboarding" ], "summary": "Get Onboarding Status", "operationId": "get_onboarding_status_onboarding_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/onboarding/provision": { "post": { "tags": [ "onboarding" ], "summary": "Provision Onboarding", "operationId": "provision_onboarding_onboarding_provision_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/onboarding/dismiss": { "post": { "tags": [ "onboarding" ], "summary": "Dismiss Onboarding", "operationId": "dismiss_onboarding_onboarding_dismiss_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/onboarding/complete": { "post": { "tags": [ "onboarding" ], "summary": "Complete Onboarding", "operationId": "complete_onboarding_onboarding_complete_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/onboarding/tenant": { "get": { "tags": [ "onboarding" ], "summary": "Get Tenant Onboarding", "operationId": "get_tenant_onboarding_onboarding_tenant_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/onboarding/tenant/ack": { "post": { "tags": [ "onboarding" ], "summary": "Ack Tenant Step", "description": "Mark a checklist step acknowledged by the admin (idempotent).", "operationId": "ack_tenant_step_onboarding_tenant_ack_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AckBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/onboarding/tenant/complete": { "post": { "tags": [ "onboarding" ], "summary": "Complete Tenant Onboarding", "operationId": "complete_tenant_onboarding_onboarding_tenant_complete_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/onboarding/tenant/dismiss": { "post": { "tags": [ "onboarding" ], "summary": "Dismiss Tenant Onboarding", "operationId": "dismiss_tenant_onboarding_onboarding_tenant_dismiss_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/chat/stream": { "post": { "tags": [ "chat" ], "summary": "Chat Stream", "operationId": "chat_stream_chat_stream_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatStreamBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/chat/settings": { "get": { "tags": [ "chat" ], "summary": "Get Chat Settings", "operationId": "get_chat_settings_chat_settings_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "put": { "tags": [ "chat" ], "summary": "Put Chat Settings", "operationId": "put_chat_settings_chat_settings_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatSettingsBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/mcp": { "get": { "tags": [ "mcp" ], "summary": "Mcp Get", "description": "Server\u2192client SSE stream is not offered (stateless server). Beating the SPA GET\ncatch-all with an explicit 405 so a client's optional GET probe gets a clean answer,\nnot the app shell.", "operationId": "mcp_get_mcp_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "mcp" ], "summary": "Mcp Endpoint", "description": "MCP Streamable HTTP endpoint. Accepts a single JSON-RPC message or a batch array.", "operationId": "mcp_endpoint_mcp_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/docs-search": { "get": { "tags": [ "docs" ], "summary": "Docs Search", "description": "Search the shipped documentation. Returns ranked page snippets (may be empty).", "operationId": "docs_search_docs_search_get", "parameters": [ { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "description": "Search query over the product documentation.", "default": "", "title": "Q" }, "description": "Search query over the product documentation." }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 8, "minimum": 1, "default": 5, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/app-config": { "get": { "summary": "App Config", "description": "Front-end bootstrap: docs URL + release version. Public, non-tenant, cache-friendly.", "operationId": "app_config_app_config_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response App Config App Config Get" } } } } }, "tags": [ "other" ] } }, "/audit/trend": { "get": { "tags": [ "audit" ], "summary": "Audit Trend", "description": "Event-volume trend for the admin audit log: per-day (or per-hour) count of audit events over\nthe selected window. Scoped to the events you can see \u2014 your company's, plus shared-schema\nevents \u2014 never another company's.", "operationId": "audit_trend_audit_trend_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "30d", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "grain", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grain" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Audit Trend Audit Trend Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/audit": { "get": { "tags": [ "audit" ], "summary": "List Audit", "description": "Admin-only tenant audit log. Filterable by action/actor/target/org/project/status,\nthe canonical time ticker, and a free-text ``q`` (substring over summary/target name/\naction). Returns ``{data, meta:{total, limit, offset, facets}}``.", "operationId": "list_audit_audit_get", "parameters": [ { "name": "action", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Action" } }, { "name": "actorId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actorid" } }, { "name": "actorType", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Actortype" } }, { "name": "targetType", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Targettype" } }, { "name": "orgId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Orgid" } }, { "name": "projectId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Projectid" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } }, { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "30d", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "sortBy", "in": "query", "required": false, "schema": { "type": "string", "default": "created", "title": "Sortby" } }, { "name": "sortDir", "in": "query", "required": false, "schema": { "type": "string", "default": "desc", "title": "Sortdir" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 100, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response List Audit Audit Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/personas": { "get": { "tags": [ "personas" ], "summary": "Get Personas", "description": "List the personas (lenses) available to the caller's tenant \u2014 powers the switcher/modal.", "operationId": "get_personas_personas_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "personas" ], "summary": "Create Persona Route", "description": "Create a tenant-authored (``custom``) persona lens. Admin + ``custom_personas`` (Silver+).", "operationId": "create_persona_route_personas_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePersonaBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/personas/{key}": { "patch": { "tags": [ "personas" ], "summary": "Update Persona Route", "description": "Edit a persona. Editing a **platform** lens flips it to ``custom`` provenance (freezing it \u2014\nit stops receiving code upgrades); an already-custom lens is edited in place. The always-on\n``full_workspace`` escape hatch can't be customized.", "operationId": "update_persona_route_personas__key__patch", "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "title": "Key" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdatePersonaBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "personas" ], "summary": "Delete Persona Route", "description": "Delete a **custom** persona. Deleting a customized *platform* key resets it to the shipped\ndefault (re-seeded on the next ensure); deleting a purely-custom key also clears it from any\nmember who had it as a default (they fall back to their role-derived lens). Platform lenses that\nwere never customized, and ``full_workspace``, can't be deleted.", "operationId": "delete_persona_route_personas__key__delete", "parameters": [ { "name": "key", "in": "path", "required": true, "schema": { "type": "string", "title": "Key" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/retention/policies": { "get": { "tags": [ "retention" ], "summary": "List Policies", "description": "List the tenant's retention policies + a preview of the effective retention (days) resolved\nper project (most-specific-first: project override \u2192 company policy \u2192 platform env default).", "operationId": "list_policies_retention_policies_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "put": { "tags": [ "retention" ], "summary": "Upsert Policy", "description": "Create or update a retention policy for a scope. A ``company`` policy is forced to the\ncaller's own company (its ``scope_id`` can't be spoofed); a ``project`` policy requires an\nexplicit ``scope_id`` (the project). ``retention_days`` is clamped to ``>= 0`` (0 = keep\nforever). Upserts on the unique ``(scope_type, scope_id)`` pair.", "operationId": "upsert_policy_retention_policies_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PolicyBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/retention/policies/{policy_id}": { "delete": { "tags": [ "retention" ], "summary": "Delete Policy", "description": "Delete a retention policy (the scope reverts to the next-coarser effective window).", "operationId": "delete_policy_retention_policies__policy_id__delete", "parameters": [ { "name": "policy_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Policy Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/retention/erasure": { "post": { "tags": [ "retention" ], "summary": "Create Erasure", "description": "Submit a GDPR Art. 17 erasure. Validates the selector is non-empty (an empty selector can\nnever fan out to \"erase everything\"), records a ``pending`` request, and starts the erasure\nasynchronously \u2014 poll the request for its terminal status and manifest.", "operationId": "create_erasure_retention_erasure_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErasureBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "retention" ], "summary": "List Erasures", "description": "List erasure requests for the tenant, newest first (compliance evidence register).", "operationId": "list_erasures_retention_erasure_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/retention/erasure/{request_id}": { "get": { "tags": [ "retention" ], "summary": "Get Erasure", "operationId": "get_erasure_retention_erasure__request_id__get", "parameters": [ { "name": "request_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Request Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/usage": { "get": { "tags": [ "usage" ], "summary": "Get Usage", "description": "Return the current tenant's usage aggregates, grouped by ``group_by``.", "operationId": "get_usage_usage_get", "parameters": [ { "name": "since", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Inclusive start day (YYYY-MM-DD); default 30d ago", "title": "Since" }, "description": "Inclusive start day (YYYY-MM-DD); default 30d ago" }, { "name": "until", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Inclusive end day (YYYY-MM-DD); default today", "title": "Until" }, "description": "Inclusive end day (YYYY-MM-DD); default today" }, { "name": "project_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Restrict to one project id", "title": "Project Id" }, "description": "Restrict to one project id" }, { "name": "group_by", "in": "query", "required": false, "schema": { "type": "string", "description": "feature | day | project | connection", "default": "feature", "title": "Group By" }, "description": "feature | day | project | connection" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Usage Usage Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/usage/kpis": { "get": { "tags": [ "usage" ], "summary": "Get Usage Kpis", "description": "Headline KPI tiles for the tenant Usage page.", "operationId": "get_usage_kpis_usage_kpis_get", "parameters": [ { "name": "since", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Inclusive start day (YYYY-MM-DD); default 30d ago", "title": "Since" }, "description": "Inclusive start day (YYYY-MM-DD); default 30d ago" }, { "name": "until", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Inclusive end day (YYYY-MM-DD); default today", "title": "Until" }, "description": "Inclusive end day (YYYY-MM-DD); default today" }, { "name": "project_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Restrict to one project id", "title": "Project Id" }, "description": "Restrict to one project id" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Usage Kpis Usage Kpis Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/usage/summary": { "get": { "tags": [ "usage" ], "summary": "Get Usage Summary", "description": "Totals per feature for the window + a daily timeseries for the headline features.", "operationId": "get_usage_summary_usage_summary_get", "parameters": [ { "name": "since", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Inclusive start day (YYYY-MM-DD); default 30d ago", "title": "Since" }, "description": "Inclusive start day (YYYY-MM-DD); default 30d ago" }, { "name": "until", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Inclusive end day (YYYY-MM-DD); default today", "title": "Until" }, "description": "Inclusive end day (YYYY-MM-DD); default today" }, { "name": "project_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Restrict to one project id", "title": "Project Id" }, "description": "Restrict to one project id" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Usage Summary Usage Summary Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/redaction/settings": { "get": { "tags": [ "redaction" ], "summary": "Get Redaction Settings", "description": "The per-project policy row + the resolved effective modes (for the governance UI).", "operationId": "get_redaction_settings_redaction_settings_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "put": { "tags": [ "redaction" ], "summary": "Put Redaction Settings", "description": "Set the per-project policy. Admin-gated (``MANAGE_RETENTION`` \u2014 the same privacy-admin\npersona that owns retention/erasure; deliberately no new authz action).", "operationId": "put_redaction_settings_redaction_settings_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PutRedactionSettingsBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/redaction/preview": { "post": { "tags": [ "redaction" ], "summary": "Preview Redaction", "description": "Run the project's policy (\u00b1 a mode override) over a sample. NEVER persists the text.", "operationId": "preview_redaction_redaction_preview_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreviewBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/model-prices/observed": { "get": { "tags": [ "model-prices" ], "summary": "Observed Models", "description": "The models this project ACTUALLY ran over the window, joined against the resolved table.", "operationId": "observed_models_model_prices_observed_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "30d", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } }, { "name": "projectId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Projectid" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Observed Models Model Prices Observed Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/model-prices": { "get": { "tags": [ "model-prices" ], "summary": "List Model Prices", "description": "The tenant's price table \u2014 platform list prices plus this project's own overrides.", "operationId": "list_model_prices_model_prices_get", "parameters": [ { "name": "includeHistory", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Includehistory" } }, { "name": "provider", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider" } }, { "name": "q", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Q" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response List Model Prices Model Prices Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "model-prices" ], "summary": "Create Model Price", "description": "Create (or idempotently replace) a TENANT price override.", "operationId": "create_model_price_model_prices_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModelPriceCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Create Model Price Model Prices Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/model-prices/{price_id}": { "patch": { "tags": [ "model-prices" ], "summary": "Update Model Price", "description": "Edit a TENANT price row. A ``platform`` row is immutable to the tenant \u2192 **409**.", "operationId": "update_model_price_model_prices__price_id__patch", "parameters": [ { "name": "price_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Price Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModelPriceUpdate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Update Model Price Model Prices Price Id Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "model-prices" ], "summary": "Delete Model Price", "description": "Delete a TENANT override \u2014 the model reverts to the platform list price, or to *unpriced*\nif the catalogue does not name it. A ``platform`` row is immutable to the tenant \u2192 **409**.", "operationId": "delete_model_price_model_prices__price_id__delete", "parameters": [ { "name": "price_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Price Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/badge/{token}.svg": { "get": { "tags": [ "badges" ], "summary": "Badge Svg", "description": "PUBLIC eval-status badge. Verify the token, pin the tenant schema, render the SVG.", "operationId": "badge_svg_badge__token__svg_get", "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string", "title": "Token" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/badge/mint": { "post": { "tags": [ "badges" ], "summary": "Mint Badge", "description": "Mint a signed badge token + ready-to-paste markdown for the current project (+ optional judge).", "operationId": "mint_badge_badge_mint_post", "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/MintBadgeRequest" }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Mint Badge Badge Mint Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/share-links/settings": { "get": { "tags": [ "share-links" ], "summary": "Get Share Settings", "description": "Per-project toggle state + the global flag / TTL bounds (for the UI).", "operationId": "get_share_settings_share_links_settings_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "put": { "tags": [ "share-links" ], "summary": "Put Share Settings", "description": "Flip the per-project share toggle. Admin-gated: enabling PUBLIC (even redacted) sharing is a\nsensitive project-config / data-governance decision, so it reuses the admin ``DELETE_RESOURCE``\ncapability. (A dedicated ``MANAGE_SHARE_LINKS`` action is the clean follow-up \u2014 deferred to\navoid editing the shared authz matrix concurrently.)", "operationId": "put_share_settings_share_links_settings_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToggleBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/share-links": { "get": { "tags": [ "share-links" ], "summary": "List Share Links", "operationId": "list_share_links_share_links_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "share-links" ], "summary": "Create Share Link", "operationId": "create_share_link_share_links_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateShareLinkBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/share-links/{link_id}": { "delete": { "tags": [ "share-links" ], "summary": "Revoke Share Link", "operationId": "revoke_share_link_share_links__link_id__delete", "parameters": [ { "name": "link_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Link Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/share/{token}": { "get": { "tags": [ "share-links" ], "summary": "Public Share View", "description": "Resolve a share token \u2192 pin the owning company's schema \u2192 load + REDACT the incident.", "operationId": "public_share_view_share__token__get", "parameters": [ { "name": "token", "in": "path", "required": true, "schema": { "type": "string", "title": "Token" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/trace-inlets": { "get": { "tags": [ "trace-inlets" ], "summary": "List Connectors", "operationId": "list_connectors_trace_inlets_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Connectors Trace Inlets Get" } } } } } }, "post": { "tags": [ "trace-inlets" ], "summary": "Create Connector", "operationId": "create_connector_trace_inlets_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TraceInletCreate" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Connector Trace Inlets Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/trace-inlets/{inlet_id}": { "patch": { "tags": [ "trace-inlets" ], "summary": "Update Connector", "operationId": "update_connector_trace_inlets__inlet_id__patch", "parameters": [ { "name": "inlet_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Inlet Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TraceInletPatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Update Connector Trace Inlets Inlet Id Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "trace-inlets" ], "summary": "Delete Connector", "operationId": "delete_connector_trace_inlets__inlet_id__delete", "parameters": [ { "name": "inlet_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Inlet Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/trace-inlets/{inlet_id}/test": { "post": { "tags": [ "trace-inlets" ], "summary": "Test Connector", "description": "Bounded reachability/auth probe. Honest error string on failure; never raises to a 500.", "operationId": "test_connector_trace_inlets__inlet_id__test_post", "parameters": [ { "name": "inlet_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Inlet Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Test Connector Trace Inlets Inlet Id Test Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/trace-inlets/{inlet_id}/sync": { "post": { "tags": [ "trace-inlets" ], "summary": "Sync Connector", "description": "Run this connector's sync NOW (bounded), synchronously off the event loop. Never 500s on a\nconnector error \u2014 returns ``{ok: false,...}``.", "operationId": "sync_connector_trace_inlets__inlet_id__sync_post", "parameters": [ { "name": "inlet_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Inlet Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Sync Connector Trace Inlets Inlet Id Sync Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/outcomes": { "post": { "tags": [ "outcomes" ], "summary": "Push Outcomes", "description": "Record one or many business outcomes.", "operationId": "push_outcomes_outcomes_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OutcomePush" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Push Outcomes Outcomes Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "outcomes" ], "summary": "List Outcomes", "operationId": "list_outcomes_outcomes_get", "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "matchState", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Matchstate" } }, { "name": "correlationKey", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Correlationkey" } }, { "name": "conversationId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Conversationid" } }, { "name": "sessionId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sessionid" } }, { "name": "since", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Since" } }, { "name": "until", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Until" } }, { "name": "includeSuperseded", "in": "query", "required": false, "schema": { "type": "boolean", "default": false, "title": "Includesuperseded" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response List Outcomes Outcomes Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/outcomes/coverage": { "get": { "tags": [ "outcomes" ], "summary": "Outcome Coverage", "description": "Match coverage \u2014 the honest denominator.", "operationId": "outcome_coverage_outcomes_coverage_get", "parameters": [ { "name": "since", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Since" } }, { "name": "until", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Until" } }, { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Outcome Coverage Outcomes Coverage Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/outcomes/kinds": { "get": { "tags": [ "outcomes" ], "summary": "List Kinds", "description": "The platform outcome catalogue. An unknown kind is still accepted on push (forward\ncompatibility with tenant-defined KPIs) \u2014 this is the curated set the UI offers.", "operationId": "list_kinds_outcomes_kinds_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Kinds Outcomes Kinds Get" } } } } } } }, "/outcomes/settings": { "get": { "tags": [ "outcomes" ], "summary": "Get Settings Route", "operationId": "get_settings_route_outcomes_settings_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Settings Route Outcomes Settings Get" } } } } } }, "put": { "tags": [ "outcomes" ], "summary": "Put Settings Route", "operationId": "put_settings_route_outcomes_settings_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OutcomeSettingsPut" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Put Settings Route Outcomes Settings Put" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/outcomes/reconcile": { "post": { "tags": [ "outcomes" ], "summary": "Reconcile Now", "description": "Re-attempt correlation for this project's parked outcomes, right now.", "operationId": "reconcile_now_outcomes_reconcile_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Reconcile Now Outcomes Reconcile Post" } } } } } } }, "/outcomes/{outcome_id}": { "get": { "tags": [ "outcomes" ], "summary": "Get Outcome", "operationId": "get_outcome_outcomes__outcome_id__get", "parameters": [ { "name": "outcome_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Outcome Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Outcome Outcomes Outcome Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/outcomes/{outcome_id}/revisions": { "get": { "tags": [ "outcomes" ], "summary": "Get Outcome Revisions", "description": "Every revision of the outcome's series, oldest \u2192 newest.", "operationId": "get_outcome_revisions_outcomes__outcome_id__revisions_get", "parameters": [ { "name": "outcome_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Outcome Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Outcome Revisions Outcomes Outcome Id Revisions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/outcome-inlets": { "get": { "tags": [ "outcome-inlets" ], "summary": "List Connectors", "operationId": "list_connectors_outcome_inlets_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Connectors Outcome Inlets Get" } } } } } }, "post": { "tags": [ "outcome-inlets" ], "summary": "Create Connector", "operationId": "create_connector_outcome_inlets_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OutcomeInletCreate" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Connector Outcome Inlets Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/outcome-inlets/{inlet_id}": { "patch": { "tags": [ "outcome-inlets" ], "summary": "Update Connector", "operationId": "update_connector_outcome_inlets__inlet_id__patch", "parameters": [ { "name": "inlet_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Inlet Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OutcomeInletPatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Update Connector Outcome Inlets Inlet Id Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "outcome-inlets" ], "summary": "Delete Connector", "operationId": "delete_connector_outcome_inlets__inlet_id__delete", "parameters": [ { "name": "inlet_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Inlet Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/outcome-inlets/{inlet_id}/test": { "post": { "tags": [ "outcome-inlets" ], "summary": "Test Connector", "description": "Bounded reachability/auth probe. Honest error string on failure; never raises to a 500.", "operationId": "test_connector_outcome_inlets__inlet_id__test_post", "parameters": [ { "name": "inlet_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Inlet Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Test Connector Outcome Inlets Inlet Id Test Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/outcome-inlets/{inlet_id}/sync": { "post": { "tags": [ "outcome-inlets" ], "summary": "Sync Connector", "description": "Run this connector's sync NOW (bounded), synchronously off the event loop. Never 500s on a\nconnector error \u2014 returns ``{ok: false,...}``.", "operationId": "sync_connector_outcome_inlets__inlet_id__sync_post", "parameters": [ { "name": "inlet_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Inlet Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Sync Connector Outcome Inlets Inlet Id Sync Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpi-definitions/options": { "get": { "tags": [ "kpi-definitions" ], "summary": "Kpi Options", "description": "The vocabulary an admin can actually pick from \u2014 the platform catalogue **plus what this\nproject has really observed**.", "operationId": "kpi_options_kpi_definitions_options_get", "parameters": [ { "name": "metricKey", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Metrickey" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Kpi Options Kpi Definitions Options Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpi-definitions": { "get": { "tags": [ "kpi-definitions" ], "summary": "Get Kpi Definitions", "description": "This project's EFFECTIVE KPI definitions (declared values merged over platform defaults).", "operationId": "get_kpi_definitions_kpi_definitions_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Get Kpi Definitions Kpi Definitions Get" } } } } } }, "put": { "tags": [ "kpi-definitions" ], "summary": "Put Kpi Definitions", "description": "Declare what this project's KPIs mean. Admin-only (``MANAGE_OUTCOMES``).", "operationId": "put_kpi_definitions_kpi_definitions_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KpiDefinitionsPut" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Put Kpi Definitions Kpi Definitions Put" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/custom-measures": { "get": { "tags": [ "custom-measures" ], "summary": "List Custom Measures", "description": "This tenant's measures + the platform catalogue + the authoring limit.", "operationId": "list_custom_measures_custom_measures_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response List Custom Measures Custom Measures Get" } } } } } }, "post": { "tags": [ "custom-measures" ], "summary": "Create Custom Measure", "description": "Define a new measure. Admin (``MANAGE_MEASURES``) + ``custom_measures`` tier (Silver+).", "operationId": "create_custom_measure_custom_measures_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomMeasureIn" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Create Custom Measure Custom Measures Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/custom-measures/options": { "get": { "tags": [ "custom-measures" ], "summary": "Custom Measure Options", "description": "The vocabulary an author can pick from \u2014 the shipped grammar **plus what this project has\nreally observed**.", "operationId": "custom_measure_options_custom_measures_options_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Custom Measure Options Custom Measures Options Get" } } } } } } }, "/custom-measures/{slug}": { "patch": { "tags": [ "custom-measures" ], "summary": "Update Custom Measure", "description": "Edit a measure you own. Editing a built-in platform measure returns 409.", "operationId": "update_custom_measure_custom_measures__slug__patch", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "title": "Slug" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CustomMeasurePatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Update Custom Measure Custom Measures Slug Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "delete": { "tags": [ "custom-measures" ], "summary": "Delete Custom Measure", "description": "Delete a measure. Reports what still REFERENCES it rather than silently orphaning them.", "operationId": "delete_custom_measure_custom_measures__slug__delete", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "title": "Slug" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Delete Custom Measure Custom Measures Slug Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/custom-measures/references/{slug}": { "get": { "tags": [ "custom-measures" ], "summary": "Custom Measure References", "description": "What currently reads this measure \u2014 shown BEFORE a destructive edit, not after.", "operationId": "custom_measure_references_custom_measures_references__slug__get", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "title": "Slug" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Custom Measure References Custom Measures References Slug Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/custom-measures/preview": { "post": { "tags": [ "custom-measures" ], "summary": "Preview Custom Measure", "description": "Resolve an UNSAVED definition over a bounded window \u2014 the \"does this actually work?\" button.", "operationId": "preview_custom_measure_custom_measures_preview_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PreviewIn" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Preview Custom Measure Custom Measures Preview Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpis": { "get": { "tags": [ "kpis" ], "summary": "List Kpis", "description": "This project's KPIs. ``status`` = ``live`` (default: draft + active) | ``active`` |\n``draft`` | ``archived`` | ``all``.", "operationId": "list_kpis_kpis_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "default": "live", "title": "Status" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "kpis" ], "summary": "Create Kpi", "description": "Promote a measure to a commitment.", "operationId": "create_kpi_kpis_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/KpiCreate" } } } }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpis/options": { "get": { "tags": [ "kpis" ], "summary": "Kpi Options", "description": "The measures this project may promote, each annotated with what the project actually has.", "operationId": "kpi_options_kpis_options_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/kpis/summary": { "get": { "tags": [ "kpis" ], "summary": "Kpi Summary", "description": "Every ACTIVE KPI with its current value, in display order.", "operationId": "kpi_summary_kpis_summary_get", "parameters": [ { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "30d", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpis/snapshot": { "post": { "tags": [ "kpis" ], "summary": "Snapshot All Kpis", "description": "Materialize daily history for every ACTIVE KPI in the caller's project scope.", "operationId": "snapshot_all_kpis_kpis_snapshot_post", "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpis/{kpi_id}": { "get": { "tags": [ "kpis" ], "summary": "Get Kpi", "description": "One KPI plus its current value over ``?range=``.", "operationId": "get_kpi_kpis__kpi_id__get", "parameters": [ { "name": "kpi_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Kpi Id" } }, { "name": "range", "in": "query", "required": false, "schema": { "type": "string", "default": "30d", "title": "Range" } }, { "name": "from", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" } }, { "name": "to", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "kpis" ], "summary": "Patch Kpi", "description": "Partially update a KPI.", "operationId": "patch_kpi_kpis__kpi_id__patch", "parameters": [ { "name": "kpi_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Kpi Id" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpis/{kpi_id}/archive": { "post": { "tags": [ "kpis" ], "summary": "Archive Kpi", "description": "Retire a commitment.", "operationId": "archive_kpi_kpis__kpi_id__archive_post", "parameters": [ { "name": "kpi_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Kpi Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpis/{kpi_id}/history": { "get": { "tags": [ "kpis" ], "summary": "Kpi History", "description": "This KPI's materialized daily history, plus where the series BREAKS.", "operationId": "kpi_history_kpis__kpi_id__history_get", "parameters": [ { "name": "kpi_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Kpi Id" } }, { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "default": 30, "title": "Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpis/{kpi_id}/calibration": { "get": { "tags": [ "kpis" ], "summary": "Kpi Calibration", "description": "How well this KPI's LLM classifier agrees with human ground truth.", "operationId": "kpi_calibration_kpis__kpi_id__calibration_get", "parameters": [ { "name": "kpi_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Kpi Id" } }, { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "default": 90, "title": "Days" } }, { "name": "window", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Window" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpis/{kpi_id}/eroding-clusters": { "get": { "tags": [ "kpis" ], "summary": "Kpi Eroding Clusters", "description": "The failure clusters eroding this KPI, worst first.", "operationId": "kpi_eroding_clusters_kpis__kpi_id__eroding_clusters_get", "parameters": [ { "name": "kpi_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Kpi Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/kpis/{kpi_id}/snapshot": { "post": { "tags": [ "kpis" ], "summary": "Snapshot Kpi", "description": "Materialize daily history for ONE KPI.", "operationId": "snapshot_kpi_kpis__kpi_id__snapshot_post", "parameters": [ { "name": "kpi_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Kpi Id" } }, { "name": "days", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Days" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/fix-engine/runs": { "post": { "tags": [ "fix-engine" ], "summary": "Create Fix Run", "description": "Launch a Neens-orchestrated fix run for an accepted remediation.", "operationId": "create_fix_run_fix_engine_runs_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FixRunCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "fix-engine" ], "summary": "List Fix Runs", "description": "List fix runs (project-scoped), optionally filtered by remediation / status.", "operationId": "list_fix_runs_fix_engine_runs_get", "parameters": [ { "name": "remediationId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Remediationid" } }, { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/fix-engine/runs/{run_id}": { "get": { "tags": [ "fix-engine" ], "summary": "Get Fix Run", "description": "Fix-run detail (incl. eval/regression report + verifying judges + PR link).", "operationId": "get_fix_run_fix_engine_runs__run_id__get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/fix-engine/runs/{run_id}/cancel": { "post": { "tags": [ "fix-engine" ], "summary": "Cancel Fix Run", "description": "Cancel a fix run (terminal). A run already in a terminal state cannot be cancelled.", "operationId": "cancel_fix_run_fix_engine_runs__run_id__cancel_post", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/fix-engine/vcs-installations": { "get": { "tags": [ "fix-engine" ], "summary": "List Vcs Installations", "description": "List the project's VCS installations. NEVER returns the decrypted credential.", "operationId": "list_vcs_installations_fix_engine_vcs_installations_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "fix-engine" ], "summary": "Create Vcs Installation", "description": "Register a GitHub App / local-git installation the fix engine opens PRs against. The\ncredential (GitHub App PEM / token) is Fernet-encrypted at rest and NEVER returned.", "operationId": "create_vcs_installation_fix_engine_vcs_installations_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/VcsInstallationCreate" } } }, "required": true }, "responses": { "201": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/fix-engine/vcs-installations/{inst_id}": { "delete": { "tags": [ "fix-engine" ], "summary": "Delete Vcs Installation", "description": "Delete a VCS installation.", "operationId": "delete_vcs_installation_fix_engine_vcs_installations__inst_id__delete", "parameters": [ { "name": "inst_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Inst Id" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/fix-engine/vcs-installations/{inst_id}/test": { "post": { "tags": [ "fix-engine" ], "summary": "Test Vcs Installation", "description": "Bounded reachability/auth probe: for ``github_app`` mint an installation token; for\n``local_git`` run ``git ls-remote``. Honest ``{ok, detail}``; never raises to a 500.", "operationId": "test_vcs_installation_fix_engine_vcs_installations__inst_id__test_post", "parameters": [ { "name": "inst_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Inst Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompt-optimization/runs": { "post": { "tags": [ "prompt-optimization" ], "summary": "Create Optimization Run", "description": "Launch a GEPA-style offline prompt-optimization run.", "operationId": "create_optimization_run_prompt_optimization_runs_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OptimizationRunCreate" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "prompt-optimization" ], "summary": "List Optimization Runs", "description": "List optimization runs (project-scoped), newest first.", "operationId": "list_optimization_runs_prompt_optimization_runs_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "failureModeId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failuremodeid" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompt-optimization/runs/{run_id}": { "get": { "tags": [ "prompt-optimization" ], "summary": "Get Optimization Run", "description": "Run detail: the run + its candidate lineage + the Pareto frontier (recomputed over the\nrecorded per-task train scores, so the UI's badges are derived from the same pure function the\nloop used) + the outcome verdict + the markdown proof report.", "operationId": "get_optimization_run_prompt_optimization_runs__run_id__get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompt-optimization/runs/{run_id}/candidates/{candidate_id}": { "get": { "tags": [ "prompt-optimization" ], "summary": "Get Optimization Candidate", "description": "One candidate + its recorded rollouts (bounded), so a reviewer can read the actual replayed\noutput and the judge's reasoning behind every per-task score.", "operationId": "get_optimization_candidate_prompt_optimization_runs__run_id__candidates__candidate_id__get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } }, { "name": "candidate_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Candidate Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompt-optimization/runs/{run_id}/cancel": { "post": { "tags": [ "prompt-optimization" ], "summary": "Cancel Optimization Run", "description": "Cancel a queued/running run (terminal). The worker re-reads the status at the top of every\niteration, so an in-flight run stops at the next boundary instead of spending the rest of the\nbudget; every terminal write it makes is guarded ``AND status NOT IN ('cancelled')``.", "operationId": "cancel_optimization_run_prompt_optimization_runs__run_id__cancel_post", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompt-optimization/runs/{run_id}/emit-remediation": { "post": { "tags": [ "prompt-optimization" ], "summary": "Emit Remediation", "description": "Manually emit the winning candidate as a ``prompt_change`` remediation (the ``autoEmit=false``\npath). 409 when the run already emitted one; 422 when it did not clear the held-out bar \u2014 a run\nthat never beat baseline has nothing to propose, and that is a legitimate result, not an error.", "operationId": "emit_remediation_prompt_optimization_runs__run_id__emit_remediation_post", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Run Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/prompt-optimization/preview": { "get": { "tags": [ "prompt-optimization" ], "summary": "Preview Optimization", "description": "Pre-flight: the resolved task set, the recovered baseline prompt, the graders, and an\nESTIMATED rollout count \u2014 everything a user needs to judge the cost BEFORE spending a cent of\ntheir own LLM budget. Read-only; makes no LLM call and writes nothing.", "operationId": "preview_optimization_prompt_optimization_preview_get", "parameters": [ { "name": "failureModeId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failuremodeid" } }, { "name": "clusterId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Clusterid" } }, { "name": "maxTasks", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxtasks" } }, { "name": "valFraction", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Valfraction" } }, { "name": "minibatchSize", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minibatchsize" } }, { "name": "maxIterations", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxiterations" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/model-sweeps/preview": { "post": { "tags": [ "model-sweeps" ], "summary": "Preview Model Sweep", "description": "Pre-flight cost estimate \u2014 **writes nothing, spends nothing**.", "operationId": "preview_model_sweep_model_sweeps_preview_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModelSweepPreviewBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/model-sweeps": { "post": { "tags": [ "model-sweeps" ], "summary": "Create Model Sweep Route", "description": "Create a sweep + its arms and enqueue the launch onto the DEDICATED pre-prod fleet.", "operationId": "create_model_sweep_route_model_sweeps_post", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewModelSweepBody" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "get": { "tags": [ "model-sweeps" ], "summary": "List Model Sweeps", "description": "List sweeps (project-scoped), newest first. Headers only \u2014 the per-arm detail is one read\naway and a list page must not fan out N reconciles.", "operationId": "list_model_sweeps_model_sweeps_get", "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/model-sweeps/{sweep_id}": { "get": { "tags": [ "model-sweeps" ], "summary": "Get Model Sweep", "description": "Sweep detail: header + arms + per-arm child runs, **reconciled live**.", "operationId": "get_model_sweep_model_sweeps__sweep_id__get", "parameters": [ { "name": "sweep_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Sweep Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/model-sweeps/{sweep_id}/cancel": { "post": { "tags": [ "model-sweeps" ], "summary": "Cancel Model Sweep", "description": "Cancel a sweep + every non-terminal child pre-prod run it launched.", "operationId": "cancel_model_sweep_model_sweeps__sweep_id__cancel_post", "parameters": [ { "name": "sweep_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Sweep Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/model-sweeps/{sweep_id}/comparison": { "get": { "tags": [ "model-sweeps" ], "summary": "Sweep Comparison", "description": "The N-way comparison: per-arm quality + cost + regressions, the per-agent split, and ONE\nverdict \u2014 reconciled live so a running sweep is current.", "operationId": "sweep_comparison_model_sweeps__sweep_id__comparison_get", "parameters": [ { "name": "sweep_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Sweep Id" } }, { "name": "bar", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "description": "pass-rate bar in 0\u20131; overrides the sweep's gate", "title": "Bar" }, "description": "pass-rate bar in 0\u20131; overrides the sweep's gate" }, { "name": "baselineArm", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "arm id to compare against (default: position 0)", "title": "Baselinearm" }, "description": "arm id to compare against (default: position 0)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/model-sweeps/{sweep_id}/frontier": { "get": { "tags": [ "model-sweeps" ], "summary": "Sweep Frontier", "description": "The agent-model cost\u2013quality frontier for a sweep \u2014 per-arm cost (per case) vs stable-pass\nquality, with each arm classified (recommended / on_frontier / overpaying / quality_risk /\nunknown) and ONE recommended move.", "operationId": "sweep_frontier_model_sweeps__sweep_id__frontier_get", "parameters": [ { "name": "sweep_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Sweep Id" } }, { "name": "bar", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "number", "maximum": 1.0, "minimum": 0.0 }, { "type": "null" } ], "description": "pass-rate bar in 0\u20131; overrides the sweep's gate", "title": "Bar" }, "description": "pass-rate bar in 0\u20131; overrides the sweep's gate" }, { "name": "baselineArm", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "arm id to treat as the incumbent (default: pos 0)", "title": "Baselinearm" }, "description": "arm id to treat as the incumbent (default: pos 0)" } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/model-sweeps/{sweep_id}/arms/{arm_id}/regressions": { "get": { "tags": [ "model-sweeps" ], "summary": "Sweep Arm Regressions", "description": "Where this arm breaks: the golden prompts the BASELINE stably passed and this arm did not.", "operationId": "sweep_arm_regressions_model_sweeps__sweep_id__arms__arm_id__regressions_get", "parameters": [ { "name": "sweep_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Sweep Id" } }, { "name": "arm_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Arm Id" } }, { "name": "baselineArm", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Baselinearm" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scorer-comparisons": { "get": { "tags": [ "scorer-comparisons" ], "summary": "List Scorer Comparisons", "description": "List comparisons (project-scoped), newest first \u2014 headers only.", "operationId": "list_scorer_comparisons_scorer_comparisons_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "post": { "tags": [ "scorer-comparisons" ], "summary": "Create Scorer Comparison Route", "description": "Create a scorer comparison and start scoring.", "operationId": "create_scorer_comparison_route_scorer_comparisons_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NewScorerComparisonBody" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scorer-comparisons/{comparison_id}": { "get": { "tags": [ "scorer-comparisons" ], "summary": "Get Scorer Comparison", "description": "Comparison detail: meta + status/progress + the per-scorer side-by-side aggregate.", "operationId": "get_scorer_comparison_scorer_comparisons__comparison_id__get", "parameters": [ { "name": "comparison_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Comparison Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scorer-comparisons/{comparison_id}/run": { "post": { "tags": [ "scorer-comparisons" ], "summary": "Run Scorer Comparison Route", "description": "(Re)run a comparison to fill in any missing scores. Already-computed results are kept; only\ntraces that have not yet been scored by a given scorer are scored.", "operationId": "run_scorer_comparison_route_scorer_comparisons__comparison_id__run_post", "parameters": [ { "name": "comparison_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Comparison Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/scorer-comparisons/{comparison_id}/cancel": { "post": { "tags": [ "scorer-comparisons" ], "summary": "Cancel Scorer Comparison", "description": "Cancel a comparison that is still in progress. Scoring stops shortly after; any results\nalready computed are kept.", "operationId": "cancel_scorer_comparison_scorer_comparisons__comparison_id__cancel_post", "parameters": [ { "name": "comparison_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Comparison Id" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/webhooks/github": { "post": { "tags": [ "webhooks" ], "summary": "Github Webhook", "description": "Handle a GitHub webhook delivery. ``ping`` \u21d2 ``{ok:true}``; a MERGED ``pull_request`` closed\nevent \u21d2 record a close-out watch on the owning remediation. Auth is the HMAC signature only.", "operationId": "github_webhook_webhooks_github_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Github Webhook Webhooks Github Post" } } } } } } }, "/autonomy/settings": { "get": { "tags": [ "autonomy" ], "summary": "Get Settings Route", "description": "The project's autonomy level, suspension state and auto-accept policy.", "operationId": "get_settings_route_autonomy_settings_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } }, "patch": { "tags": [ "autonomy" ], "summary": "Patch Settings Route", "description": "Set the autonomy level and/or the auto-accept policy.", "operationId": "patch_settings_route_autonomy_settings_patch", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AutonomySettingsPatch" } } }, "required": true }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/autonomy/suspend": { "post": { "tags": [ "autonomy" ], "summary": "Suspend Route", "description": "The human kill switch: suspend autonomy for this project and cancel anything in flight.", "operationId": "suspend_route_autonomy_suspend_post", "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/SuspendBody" }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/autonomy/resume": { "post": { "tags": [ "autonomy" ], "summary": "Resume Route", "description": "Resume a suspended project. 409 when it is not suspended \u2014 resuming what is already running\nwould write a misleading ``resumed`` row into the decision trail.", "operationId": "resume_route_autonomy_resume_post", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/autonomy/status": { "get": { "tags": [ "autonomy" ], "summary": "Status Route", "description": "The SPA's single call: level + suspension + policy + the live health and budget signals the\nsweep will act on, plus the platform ceilings and what has already happened today.", "operationId": "status_route_autonomy_status_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/autonomy/decisions": { "get": { "tags": [ "autonomy" ], "summary": "List Decisions Route", "description": "The decision trail \u2014 every autonomous admission, refusal, suspension, resume and cancel.", "operationId": "list_decisions_route_autonomy_decisions_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 500, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "decision", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Decision" } }, { "name": "remediationId", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Remediationid" } }, { "name": "reason", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Reason" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/spend-budgets": { "get": { "tags": [ "spend-budgets" ], "summary": "List Budgets Route", "description": "Every known feature's budget for this project (unconfigured features read as unlimited).", "operationId": "list_budgets_route_spend_budgets_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } } } } }, "/spend-budgets/{feature}": { "get": { "tags": [ "spend-budgets" ], "summary": "Get Budget Route", "description": "One feature's budget.", "operationId": "get_budget_route_spend_budgets__feature__get", "parameters": [ { "name": "feature", "in": "path", "required": true, "schema": { "type": "string", "title": "Feature" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "put": { "tags": [ "spend-budgets" ], "summary": "Put Budget Route", "description": "Set a feature's spend limit + period. ``limitUsd: null`` clears the limit.", "operationId": "put_budget_route_spend_budgets__feature__put", "parameters": [ { "name": "feature", "in": "path", "required": true, "schema": { "type": "string", "title": "Feature" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BudgetPut" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/spend-budgets/{feature}/usage": { "get": { "tags": [ "spend-budgets" ], "summary": "Budget Usage Route", "description": "The current period's spend against the limit, plus the ledger rows behind it.", "operationId": "budget_usage_route_spend_budgets__feature__usage_get", "parameters": [ { "name": "feature", "in": "path", "required": true, "schema": { "type": "string", "title": "Feature" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": {} } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/health": { "get": { "summary": "Health", "description": "Liveness: the process is up. Always 200, cheap, no I/O.", "operationId": "health_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Health Health Get" } } } } }, "tags": [ "other" ] } }, "/ready": { "get": { "summary": "Ready", "description": "Readiness: probe the backends this role depends on. 200 if all ok, else 503.", "operationId": "ready_ready_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "additionalProperties": true, "type": "object", "title": "Response Ready Ready Get" } } } } }, "tags": [ "other" ] } } }, "components": { "schemas": { "AcceptInviteBody": { "properties": { "token": { "type": "string", "title": "Token" }, "password": { "type": "string", "title": "Password" }, "displayName": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Displayname" } }, "type": "object", "required": [ "token", "password" ], "title": "AcceptInviteBody" }, "AckBody": { "properties": { "step": { "type": "string", "title": "Step" } }, "type": "object", "required": [ "step" ], "title": "AckBody" }, "AdjudicateBody": { "properties": { "target_id": { "type": "string", "title": "Target Id" }, "verdict": { "type": "string", "title": "Verdict" }, "critique": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Critique" }, "is_gold": { "type": "boolean", "title": "Is Gold", "default": true } }, "type": "object", "required": [ "target_id", "verdict" ], "title": "AdjudicateBody" }, "AgentContextBody": { "properties": { "systemPrompt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Systemprompt" }, "repoUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Repourl" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } }, "type": "object", "title": "AgentContextBody", "description": "Optional per-project agent context \u2014 all fields optional (a partial PUT clears\nunspecified fields to null, since this is a single canonical row per project)." }, "AlertRuleCreate": { "properties": { "name": { "type": "string", "title": "Name" }, "measureKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Measurekey" }, "comparator": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Comparator" }, "threshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Threshold" }, "window": { "type": "string", "title": "Window", "default": "24h" }, "metricKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Metrickey" }, "severity": { "type": "string", "title": "Severity", "default": "high" }, "sinks": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Sinks" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Tags" }, "cooldownMinutes": { "type": "integer", "title": "Cooldownminutes", "default": 60 }, "enabled": { "type": "boolean", "title": "Enabled", "default": true }, "ruleType": { "type": "string", "title": "Ruletype", "default": "threshold" }, "config": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Config" }, "kpiId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kpiid" }, "lookbackDays": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Lookbackdays" }, "minDeltaPct": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Mindeltapct" } }, "type": "object", "required": [ "name" ], "title": "AlertRuleCreate" }, "AlertRuleUpdate": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "measureKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Measurekey" }, "comparator": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Comparator" }, "threshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Threshold" }, "window": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Window" }, "metricKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Metrickey" }, "severity": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" }, "sinks": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Sinks" }, "tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Tags" }, "cooldownMinutes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Cooldownminutes" }, "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" }, "ruleType": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Ruletype" }, "config": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Config" }, "kpiId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kpiid" }, "lookbackDays": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Lookbackdays" }, "minDeltaPct": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Mindeltapct" } }, "type": "object", "title": "AlertRuleUpdate" }, "AnnotationCreate": { "properties": { "targetType": { "type": "string", "title": "Targettype" }, "targetId": { "type": "string", "title": "Targetid" }, "value": { "type": "string", "title": "Value" }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Comment" }, "reviewer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reviewer" } }, "type": "object", "required": [ "targetType", "targetId", "value" ], "title": "AnnotationCreate" }, "ApprovedToolCall": { "properties": { "id": { "type": "string", "title": "Id" }, "tool": { "type": "string", "title": "Tool" }, "args": { "additionalProperties": true, "type": "object", "title": "Args", "default": {} }, "decision": { "type": "string", "title": "Decision" } }, "type": "object", "required": [ "id", "tool", "decision" ], "title": "ApprovedToolCall", "description": "The client's answer to a previous turn's ``tool_proposed`` event." }, "AssignBody": { "properties": { "session_ids": { "items": { "type": "string" }, "type": "array", "title": "Session Ids", "default": [] } }, "type": "object", "title": "AssignBody" }, "AutonomySettingsPatch": { "properties": { "level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Level" }, "policy": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Policy" } }, "additionalProperties": false, "type": "object", "title": "AutonomySettingsPatch" }, "BriefingRequest": { "properties": { "range": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Range", "default": "24h" }, "from": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "From" }, "to": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "To" }, "projectIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Projectids" } }, "type": "object", "title": "BriefingRequest", "description": "The window + scope to generate a narrative for \u2014 the same values ``GET /summary`` takes,\nin this repo's camelCase wire style." }, "BudgetPut": { "properties": { "limitUsd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Limitusd" }, "period": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Period" }, "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" } }, "additionalProperties": false, "type": "object", "title": "BudgetPut" }, "BulkOrgsBody": { "properties": { "userIds": { "items": { "type": "string" }, "type": "array", "title": "Userids" }, "orgIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Orgids" }, "allOrgs": { "type": "boolean", "title": "Allorgs", "default": false } }, "type": "object", "required": [ "userIds" ], "title": "BulkOrgsBody", "description": "Bulk-assign org access to several members at once." }, "BulkPersonaBody": { "properties": { "userIds": { "items": { "type": "string" }, "type": "array", "title": "Userids" }, "personaKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Personakey" } }, "type": "object", "required": [ "userIds" ], "title": "BulkPersonaBody", "description": "Bulk-assign a persona DEFAULT to several members at once." }, "ChallengeBody": { "properties": { "mfaToken": { "type": "string", "title": "Mfatoken" }, "code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Code" }, "recoveryCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recoverycode" } }, "type": "object", "required": [ "mfaToken" ], "title": "ChallengeBody" }, "ChangePasswordBody": { "properties": { "currentPassword": { "type": "string", "title": "Currentpassword" }, "newPassword": { "type": "string", "title": "Newpassword" } }, "type": "object", "required": [ "currentPassword", "newPassword" ], "title": "ChangePasswordBody" }, "ChatMessage": { "properties": { "role": { "type": "string", "title": "Role" }, "content": { "type": "string", "title": "Content" } }, "type": "object", "required": [ "role", "content" ], "title": "ChatMessage" }, "ChatSettingsBody": { "properties": { "connectionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Connectionid" } }, "type": "object", "title": "ChatSettingsBody" }, "ChatStreamBody": { "properties": { "messages": { "items": { "$ref": "#/components/schemas/ChatMessage" }, "type": "array", "title": "Messages" }, "approved_tool_call": { "anyOf": [ { "$ref": "#/components/schemas/ApprovedToolCall" }, { "type": "null" } ] } }, "type": "object", "required": [ "messages" ], "title": "ChatStreamBody" }, "ClusterConfigCreate": { "properties": { "name": { "type": "string", "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" }, "samplingPct": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Samplingpct" }, "windowDays": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Windowdays" }, "maxSessions": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxsessions" }, "minFailureSessions": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minfailuresessions" }, "minClusterSize": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minclustersize" }, "scoreThreshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Scorethreshold" }, "selectionMode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Selectionmode" }, "dedupLabels": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deduplabels" }, "scoreMetricKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scoremetrickey" } }, "type": "object", "required": [ "name" ], "title": "ClusterConfigCreate" }, "ClusterConfigEstimate": { "properties": { "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" }, "samplingPct": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Samplingpct" }, "windowDays": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Windowdays" }, "maxSessions": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxsessions" }, "minFailureSessions": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minfailuresessions" }, "minClusterSize": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minclustersize" }, "scoreThreshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Scorethreshold" }, "selectionMode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Selectionmode" }, "dedupLabels": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deduplabels" }, "scoreMetricKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scoremetrickey" } }, "type": "object", "title": "ClusterConfigEstimate" }, "ClusterConfigPatch": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" }, "samplingPct": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Samplingpct" }, "windowDays": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Windowdays" }, "maxSessions": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxsessions" }, "minFailureSessions": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minfailuresessions" }, "minClusterSize": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minclustersize" }, "scoreThreshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Scorethreshold" }, "selectionMode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Selectionmode" }, "dedupLabels": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deduplabels" }, "scoreMetricKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scoremetrickey" } }, "type": "object", "title": "ClusterConfigPatch" }, "ClusterMergeBody": { "properties": { "source_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Source Ids" }, "source_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Id" } }, "type": "object", "title": "ClusterMergeBody" }, "ClusterRenameBody": { "properties": { "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" } }, "type": "object", "title": "ClusterRenameBody" }, "ClusterRunBody": { "properties": { "dataset_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dataset Id" } }, "type": "object", "title": "ClusterRunBody" }, "ClusterSettingsPatch": { "properties": { "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" }, "samplingPct": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Samplingpct" }, "windowDays": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Windowdays" }, "maxSessions": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxsessions" }, "minFailureSessions": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minfailuresessions" }, "minClusterSize": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minclustersize" }, "scoreThreshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Scorethreshold" }, "selectionMode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Selectionmode" }, "dedupLabels": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Deduplabels" }, "scoreMetricKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scoremetrickey" } }, "type": "object", "title": "ClusterSettingsPatch" }, "ConfigLifecyclePatch": { "properties": { "stage": { "type": "string", "title": "Stage" } }, "type": "object", "required": [ "stage" ], "title": "ConfigLifecyclePatch" }, "ConversationAnnotation": { "properties": { "value": { "type": "string", "title": "Value" }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Comment" } }, "type": "object", "required": [ "value" ], "title": "ConversationAnnotation" }, "ConversationLabel": { "properties": { "label": { "type": "string", "title": "Label" } }, "type": "object", "required": [ "label" ], "title": "ConversationLabel" }, "CreateConnBody": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model" }, "baseUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Baseurl" }, "credential": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credential" }, "credentialMethod": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credentialmethod" }, "secretRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Secretref" }, "requestsPerMinute": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Requestsperminute" }, "scopeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scopetype" }, "scopeIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Scopeids" }, "isDefault": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Isdefault" }, "options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Options" } }, "type": "object", "title": "CreateConnBody" }, "CreateEnrichmentBody": { "properties": { "name": { "type": "string", "title": "Name" }, "mode": { "type": "string", "title": "Mode" }, "targetType": { "type": "string", "title": "Targettype" }, "outputFields": { "items": { "$ref": "#/components/schemas/OutputField" }, "type": "array", "title": "Outputfields", "default": [] }, "prerequisites": { "additionalProperties": true, "type": "object", "title": "Prerequisites", "default": {} }, "definition": { "additionalProperties": true, "type": "object", "title": "Definition", "default": {} } }, "type": "object", "required": [ "name", "mode", "targetType" ], "title": "CreateEnrichmentBody" }, "CreateKeyBody": { "properties": { "name": { "type": "string", "title": "Name" }, "role": { "type": "string", "title": "Role", "default": "writer" }, "mfaCode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mfacode" } }, "type": "object", "required": [ "name" ], "title": "CreateKeyBody" }, "CreatePersonaBody": { "properties": { "name": { "type": "string", "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "focusAreas": { "items": { "type": "string" }, "type": "array", "title": "Focusareas" }, "home": { "type": "string", "title": "Home", "default": "/" }, "defaultRange": { "type": "string", "title": "Defaultrange", "default": "7d" }, "nav": { "$ref": "#/components/schemas/PersonaNavInput" }, "dashboardIds": { "items": { "type": "string" }, "type": "array", "title": "Dashboardids" } }, "type": "object", "required": [ "name" ], "title": "CreatePersonaBody" }, "CreateShareLinkBody": { "properties": { "resourceType": { "type": "string", "title": "Resourcetype" }, "resourceId": { "type": "string", "title": "Resourceid" }, "ttlHours": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Ttlhours" } }, "type": "object", "required": [ "resourceType", "resourceId" ], "title": "CreateShareLinkBody" }, "CustomMeasureIn": { "properties": { "slug": { "type": "string", "title": "Slug" }, "label": { "type": "string", "title": "Label" }, "source": { "type": "string", "title": "Source" }, "agg": { "type": "string", "title": "Agg" }, "grain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grain" }, "unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Unit" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "outcomeKind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Outcomekind" }, "outcomeSource": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Outcomesource" }, "metadataPath": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Metadatapath" }, "classifierMetricKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Classifiermetrickey" }, "classifierLabels": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Classifierlabels" }, "rateOp": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rateop" }, "rateValue": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Ratevalue" }, "caseReducer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Casereducer" }, "filters": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Filters" }, "direction": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Direction" }, "target": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Target" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" } }, "type": "object", "required": [ "slug", "label", "source", "agg" ], "title": "CustomMeasureIn", "description": "A full definition. Field names are camelCase on the wire; the pure module normalizes\nboth spellings through ONE parser, so there is no second validation path to drift." }, "CustomMeasurePatch": { "properties": { "slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Slug" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Unit" }, "grain": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Grain" }, "agg": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agg" }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" }, "outcomeKind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Outcomekind" }, "outcomeSource": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Outcomesource" }, "metadataPath": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Metadatapath" }, "classifierMetricKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Classifiermetrickey" }, "classifierLabels": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Classifierlabels" }, "rateOp": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rateop" }, "rateValue": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Ratevalue" }, "caseReducer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Casereducer" }, "filters": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Filters" }, "direction": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Direction" }, "target": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Target" }, "category": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" } }, "type": "object", "title": "CustomMeasurePatch", "description": "A partial update. ``slug`` cannot be changed \u2014 alert rules and dashboard widgets reference\na measure by its slug; a request that includes it is rejected." }, "CustomPatternBody": { "properties": { "type": { "type": "string", "title": "Type" }, "pattern": { "type": "string", "title": "Pattern" } }, "type": "object", "required": [ "type", "pattern" ], "title": "CustomPatternBody" }, "DatasetFromEnrichmentBody": { "properties": { "name": { "type": "string", "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "field": { "type": "string", "title": "Field" }, "value": { "type": "string", "title": "Value" }, "streaming": { "type": "boolean", "title": "Streaming", "default": true }, "fields": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Fields" } }, "type": "object", "required": [ "name", "field", "value" ], "title": "DatasetFromEnrichmentBody" }, "DeployEventCreate": { "properties": { "kind": { "type": "string", "title": "Kind" }, "title": { "type": "string", "title": "Title" }, "agentName": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agentname" }, "oldValue": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Oldvalue" }, "newValue": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Newvalue" }, "deployedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Deployedat" }, "deployedBy": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Deployedby" } }, "type": "object", "required": [ "kind", "title" ], "title": "DeployEventCreate" }, "DeploymentBody": { "properties": { "schedule": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Schedule" } }, "type": "object", "title": "DeploymentBody" }, "DeploymentCreate": { "properties": { "version_id": { "type": "string", "title": "Version Id" }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scope" }, "trigger_policy": { "type": "string", "title": "Trigger Policy", "default": "manual" }, "filter": { "additionalProperties": true, "type": "object", "title": "Filter", "default": {} }, "pool_connection_ids": { "items": { "type": "string" }, "type": "array", "title": "Pool Connection Ids", "default": [] }, "success_threshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Success Threshold" }, "run_target_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Target Id" }, "dedupe": { "type": "boolean", "title": "Dedupe", "default": false } }, "type": "object", "required": [ "version_id" ], "title": "DeploymentCreate" }, "DeploymentPatch": { "properties": { "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "trigger_policy": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Trigger Policy" }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scope" }, "filter": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Filter" }, "pool_connection_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Pool Connection Ids" }, "success_threshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Success Threshold" }, "run_target_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Target Id" } }, "type": "object", "title": "DeploymentPatch" }, "EnrollBody": { "properties": {}, "type": "object", "title": "EnrollBody", "description": "Deliberately empty. The server picks the secret \u2014 a client-supplied one would let a caller\nenrol a secret an attacker already knows." }, "ErasureBody": { "properties": { "session_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Session Ids" }, "conversation_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Conversation Ids" }, "subject_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Subject Key" }, "subject_value": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Subject Value" }, "project_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Project Id" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" } }, "type": "object", "title": "ErasureBody" }, "EstimateRequest": { "properties": { "filter": { "additionalProperties": true, "type": "object", "title": "Filter", "default": {} } }, "type": "object", "title": "EstimateRequest" }, "EvalRunCreate": { "properties": { "deployment_id": { "type": "string", "title": "Deployment Id" }, "pool_connection_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Pool Connection Ids" }, "success_threshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Success Threshold" }, "sample_size": { "anyOf": [ { "type": "integer", "minimum": 1.0 }, { "type": "null" } ], "title": "Sample Size", "description": "Cap THIS run at this many of the deployment's eligible traces (most-recent first), leaving the deployment's stored sampling filter unchanged \u2014 e.g. 1000 to score the 1000 most-recent eligible traces without editing the deployment. The response `total` is the number actually queued (smaller than sample_size when fewer traces are eligible). Omit to let the deployment's filter decide the count." } }, "type": "object", "required": [ "deployment_id" ], "title": "EvalRunCreate" }, "FailureModeCreate": { "properties": { "cluster_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cluster Id" }, "name": { "type": "string", "title": "Name" }, "definition": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Definition" }, "severity": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" }, "owner": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Owner" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "provenance": { "type": "string", "title": "Provenance", "default": "human" }, "compliance_tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Compliance Tags" }, "exemplar_session_ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Exemplar Session Ids" }, "judge_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Judge Id" }, "dataset_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dataset Id" } }, "type": "object", "required": [ "name" ], "title": "FailureModeCreate" }, "FailureModeImportBody": { "properties": { "modes": { "items": { "$ref": "#/components/schemas/FailureModeImportItem" }, "type": "array", "title": "Modes", "default": [] }, "include_starter_library": { "type": "boolean", "title": "Include Starter Library", "default": false }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, "type": "object", "title": "FailureModeImportBody" }, "FailureModeImportItem": { "properties": { "name": { "type": "string", "title": "Name" }, "definition": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Definition" }, "severity": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" }, "compliance_tags": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Compliance Tags" }, "key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Key" } }, "type": "object", "required": [ "name" ], "title": "FailureModeImportItem" }, "FailureModePatch": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "definition": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Definition" }, "severity": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Severity" }, "owner": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Owner" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" } }, "type": "object", "title": "FailureModePatch" }, "FeedbackBody": { "properties": { "verdict": { "type": "string", "title": "Verdict" }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Comment" }, "reviewer": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reviewer" } }, "type": "object", "required": [ "verdict" ], "title": "FeedbackBody" }, "FeedbackIn": { "properties": { "rating": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Rating" }, "thumb": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thumb" }, "comment": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Comment" } }, "type": "object", "title": "FeedbackIn", "description": "End-user feedback on one session." }, "FixRunCreate": { "properties": { "remediationId": { "type": "string", "title": "Remediationid" }, "driver": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Driver" }, "vcsInstallationId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Vcsinstallationid" }, "repoUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Repourl" }, "baseBranch": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Basebranch" }, "versionLabel": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Versionlabel" }, "endpointUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Endpointurl" }, "agentConnectionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agentconnectionid" }, "maxAttempts": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxattempts" }, "passK": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Passk" } }, "additionalProperties": false, "type": "object", "required": [ "remediationId" ], "title": "FixRunCreate" }, "FixSimulationRun": { "properties": { "sessionId": { "type": "string", "title": "Sessionid" }, "editedSystemPrompt": { "type": "string", "title": "Editedsystemprompt" }, "judgeIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Judgeids" }, "connectionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Connectionid" } }, "type": "object", "required": [ "sessionId", "editedSystemPrompt" ], "title": "FixSimulationRun" }, "ForgotPasswordBody": { "properties": { "email": { "type": "string", "title": "Email" } }, "type": "object", "required": [ "email" ], "title": "ForgotPasswordBody" }, "FromRemediation": { "properties": { "remediationId": { "type": "string", "title": "Remediationid" }, "promptId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Promptid" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "commitMessage": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Commitmessage" } }, "type": "object", "required": [ "remediationId" ], "title": "FromRemediation" }, "GatePatch": { "properties": { "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "baselinePassRate": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Baselinepassrate" } }, "type": "object", "title": "GatePatch" }, "GenerateBody": { "properties": { "clusterId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Clusterid" }, "failureModeId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failuremodeid" } }, "type": "object", "title": "GenerateBody", "description": "Accepts BOTH spellings \u2014 the UI client (``ui/src/lib/remediationsApi.ts``) sends\ncamelCase (``clusterId``/``failureModeId``) while API/tests use snake_case;\n``populate_by_name`` keeps the field names valid alongside the camelCase aliases." }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "InviteBody": { "properties": { "email": { "type": "string", "title": "Email" }, "displayName": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Displayname" }, "role": { "type": "string", "title": "Role", "default": "member" }, "orgIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Orgids" }, "allOrgs": { "type": "boolean", "title": "Allorgs", "default": false }, "personaKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Personakey" } }, "type": "object", "required": [ "email" ], "title": "InviteBody" }, "IssueLifecycleBody": { "properties": { "state": { "type": "string", "title": "State" }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" }, "owner": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Owner" } }, "type": "object", "required": [ "state" ], "title": "IssueLifecycleBody" }, "JudgeCreate": { "properties": { "name": { "type": "string", "title": "Name" }, "type": { "type": "string", "title": "Type" }, "scope": { "type": "string", "title": "Scope", "default": "trace" }, "description": { "type": "string", "title": "Description", "default": "" }, "level": { "type": "string", "title": "Level", "default": "project" }, "definition": { "additionalProperties": true, "type": "object", "title": "Definition", "default": {} } }, "type": "object", "required": [ "name", "type" ], "title": "JudgeCreate" }, "JudgePatch": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scope" }, "level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Level" } }, "type": "object", "title": "JudgePatch" }, "KpiCreate": { "properties": { "measureKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Measurekey" }, "measure_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Measure Key" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "direction": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Direction" }, "target": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Target" }, "owner": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Owner" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "priority": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Priority" }, "reviewCadence": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reviewcadence" }, "review_cadence": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Review Cadence" } }, "type": "object", "title": "KpiCreate", "description": "Deliberately permissive at the Pydantic layer \u2014 ``core.services.kpis.normalize_kpi`` is the\nsingle validator, so the field rules live in ONE place and the demo seed, the router and any\nfuture importer all pass through exactly the same door." }, "KpiDefinitionsPut": { "properties": { "definitions": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Definitions" } }, "type": "object", "title": "KpiDefinitionsPut", "description": "Full replacement of the project's declarations." }, "LabelCreate": { "properties": { "label": { "type": "string", "title": "Label" } }, "type": "object", "required": [ "label" ], "title": "LabelCreate" }, "LabelSet": { "properties": { "version": { "type": "integer", "title": "Version" } }, "type": "object", "required": [ "version" ], "title": "LabelSet" }, "LifecyclePatch": { "properties": { "stage": { "type": "string", "title": "Stage" } }, "type": "object", "required": [ "stage" ], "title": "LifecyclePatch" }, "LinkBody": { "properties": { "cluster_id": { "type": "string", "title": "Cluster Id" }, "weight": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Weight" } }, "type": "object", "required": [ "cluster_id" ], "title": "LinkBody" }, "ListModelsBody": { "properties": { "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider" }, "baseUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Baseurl" }, "credential": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credential" }, "credentialMethod": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credentialmethod" }, "secretRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Secretref" } }, "type": "object", "title": "ListModelsBody" }, "LoginBody": { "properties": { "email": { "type": "string", "title": "Email" }, "password": { "type": "string", "title": "Password" }, "challengeToken": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Challengetoken" } }, "type": "object", "required": [ "email", "password" ], "title": "LoginBody" }, "MergeBody": { "properties": { "source_id": { "type": "string", "title": "Source Id" } }, "type": "object", "required": [ "source_id" ], "title": "MergeBody" }, "MetricBand": { "properties": { "pass": { "type": "number", "title": "Pass" }, "warn": { "type": "number", "title": "Warn" } }, "type": "object", "required": [ "pass", "warn" ], "title": "MetricBand" }, "MintBadgeRequest": { "properties": { "judgeId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Judgeid" } }, "type": "object", "title": "MintBadgeRequest", "description": "Body for ``POST /badge/mint`` \u2014 optionally scope the badge to a single judge." }, "ModelPriceCreate": { "properties": { "modelId": { "type": "string", "title": "Modelid" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider" }, "displayName": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Displayname" }, "familyPrefix": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Familyprefix" }, "inputPerMillion": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Inputpermillion" }, "cachedInputPerMillion": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Cachedinputpermillion" }, "outputPerMillion": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Outputpermillion" }, "effectiveFrom": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Effectivefrom" }, "effectiveTo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Effectiveto" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } }, "type": "object", "required": [ "modelId" ], "title": "ModelPriceCreate" }, "ModelPriceUpdate": { "properties": { "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider" }, "displayName": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Displayname" }, "inputPerMillion": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Inputpermillion" }, "cachedInputPerMillion": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Cachedinputpermillion" }, "outputPerMillion": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Outputpermillion" }, "effectiveFrom": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Effectivefrom" }, "effectiveTo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Effectiveto" }, "notes": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Notes" } }, "type": "object", "title": "ModelPriceUpdate", "description": "PATCH body \u2014 any subset of the mutable fields." }, "ModelSweepArmBody": { "properties": { "label": { "type": "string", "title": "Label" }, "agentConnectionId": { "type": "string", "title": "Agentconnectionid" } }, "additionalProperties": false, "type": "object", "required": [ "label", "agentConnectionId" ], "title": "ModelSweepArmBody" }, "ModelSweepPreviewBody": { "properties": { "datasetId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Datasetid" }, "datasetVersionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Datasetversionid" }, "scenarioSuiteId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scenariosuiteid" }, "arms": { "items": { "$ref": "#/components/schemas/ModelSweepArmBody" }, "type": "array", "title": "Arms" }, "passK": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Passk" }, "judgeDeploymentIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Judgedeploymentids" }, "budgetUsd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Budgetusd" } }, "additionalProperties": false, "type": "object", "title": "ModelSweepPreviewBody" }, "NewModelSweepBody": { "properties": { "datasetId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Datasetid" }, "datasetVersionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Datasetversionid" }, "scenarioSuiteId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scenariosuiteid" }, "arms": { "items": { "$ref": "#/components/schemas/ModelSweepArmBody" }, "type": "array", "title": "Arms" }, "passK": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Passk" }, "judgeDeploymentIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Judgedeploymentids" }, "budgetUsd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Budgetusd" }, "name": { "type": "string", "title": "Name" }, "versionLabel": { "type": "string", "title": "Versionlabel" }, "gate": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Gate" }, "baseline": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Baseline" } }, "additionalProperties": false, "type": "object", "required": [ "name", "versionLabel" ], "title": "NewModelSweepBody" }, "NewScorerComparisonBody": { "properties": { "name": { "type": "string", "title": "Name" }, "judgeId": { "type": "string", "title": "Judgeid" }, "scorerConnectionIds": { "items": { "type": "string" }, "type": "array", "title": "Scorerconnectionids" }, "window": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Window" }, "windowStart": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Windowstart" }, "windowEnd": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Windowend" } }, "additionalProperties": false, "type": "object", "required": [ "name", "judgeId" ], "title": "NewScorerComparisonBody" }, "OptimizationRunCreate": { "properties": { "failureModeId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failuremodeid" }, "clusterId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Clusterid" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "sessionIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array", "maxItems": 1000 }, { "type": "null" } ], "title": "Sessionids" }, "judgeIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array", "maxItems": 100 }, { "type": "null" } ], "title": "Judgeids" }, "connectionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Connectionid" }, "objective": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Objective" }, "maxRollouts": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxrollouts" }, "maxIterations": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxiterations" }, "minibatchSize": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Minibatchsize" }, "maxTasks": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxtasks" }, "valFraction": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Valfraction" }, "minImprovement": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Minimprovement" }, "autoEmit": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Autoemit" } }, "additionalProperties": false, "type": "object", "title": "OptimizationRunCreate" }, "OrgCreate": { "properties": { "name": { "type": "string", "title": "Name" }, "slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Slug" } }, "type": "object", "required": [ "name" ], "title": "OrgCreate" }, "OrgUpdate": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Slug" } }, "type": "object", "title": "OrgUpdate" }, "OutcomeIn": { "properties": { "correlationKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Correlationkey" }, "correlationType": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Correlationtype" }, "kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" }, "value": { "title": "Value" }, "unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Unit" }, "valueType": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Valuetype" }, "occurredAt": { "title": "Occurredat" }, "metadata": { "title": "Metadata" }, "idempotencyKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idempotencykey" }, "externalId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Externalid" }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, "type": "object", "title": "OutcomeIn" }, "OutcomeInletCreate": { "properties": { "provider": { "type": "string", "title": "Provider" }, "name": { "type": "string", "title": "Name" }, "baseUrl": { "type": "string", "title": "Baseurl" }, "credential": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credential" }, "options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Options" }, "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" }, "pollIntervalMinutes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Pollintervalminutes" }, "backfillDays": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Backfilldays" } }, "type": "object", "required": [ "provider", "name", "baseUrl" ], "title": "OutcomeInletCreate" }, "OutcomeInletPatch": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "baseUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Baseurl" }, "credential": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credential" }, "options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Options" }, "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" }, "pollIntervalMinutes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Pollintervalminutes" }, "backfillDays": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Backfilldays" } }, "type": "object", "title": "OutcomeInletPatch" }, "OutcomePush": { "properties": { "correlationKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Correlationkey" }, "correlationType": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Correlationtype" }, "kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" }, "value": { "title": "Value" }, "unit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Unit" }, "valueType": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Valuetype" }, "occurredAt": { "title": "Occurredat" }, "metadata": { "title": "Metadata" }, "idempotencyKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Idempotencykey" }, "externalId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Externalid" }, "source": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" }, "outcomes": { "anyOf": [ { "items": { "$ref": "#/components/schemas/OutcomeIn" }, "type": "array" }, { "type": "null" } ], "title": "Outcomes" } }, "type": "object", "title": "OutcomePush", "description": "Accepts a batch (``{\"outcomes\": [...]}``) OR a single outcome object at the top level." }, "OutcomeSettingsPut": { "properties": { "externalKeyPaths": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Externalkeypaths" }, "matchWindowHours": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Matchwindowhours" } }, "type": "object", "title": "OutcomeSettingsPut" }, "OutputField": { "properties": { "key": { "type": "string", "title": "Key" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" }, "outputType": { "type": "string", "title": "Outputtype", "default": "attribute" }, "valueType": { "type": "string", "title": "Valuetype", "default": "string" }, "enumValues": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Enumvalues" }, "table": { "type": "boolean", "title": "Table", "default": false } }, "type": "object", "required": [ "key" ], "title": "OutputField" }, "PersonaNavInput": { "properties": { "featured": { "items": { "type": "string" }, "type": "array", "title": "Featured" }, "hidden": { "items": { "type": "string" }, "type": "array", "title": "Hidden" } }, "type": "object", "title": "PersonaNavInput", "description": "The featured/hidden nav split. Everything not in either list renders collapsed under\n\"All features\" (derived on the client) \u2014 so ``collapsed`` needs no explicit storage." }, "PlaygroundRun": { "properties": { "promptId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Promptid" }, "label": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Label" }, "version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Version" }, "promptType": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prompttype" }, "content": { "anyOf": [ {}, { "type": "null" } ], "title": "Content" }, "config": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Config" }, "variables": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Variables" } }, "type": "object", "title": "PlaygroundRun" }, "PolicyBody": { "properties": { "scope_type": { "type": "string", "title": "Scope Type" }, "scope_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scope Id" }, "retention_days": { "type": "integer", "title": "Retention Days", "default": 0 }, "enabled": { "type": "boolean", "title": "Enabled", "default": true } }, "type": "object", "required": [ "scope_type" ], "title": "PolicyBody" }, "PreprodVerifyBody": { "properties": { "endpoint_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Endpoint Url" }, "agent_connection_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent Connection Id" }, "auth_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Auth Token" }, "request_shape": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Request Shape" }, "dataset_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dataset Id" }, "remediation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Remediation Id" }, "version_label": { "type": "string", "title": "Version Label" }, "min_pass_rate": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Min Pass Rate" }, "max_regressions": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Regressions" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" } }, "additionalProperties": false, "type": "object", "required": [ "version_label" ], "title": "PreprodVerifyBody", "description": "Verification-webhook request. ``version_label`` is required (the branch /\ncommit / preview id under test); everything else is resolved or defaulted." }, "PreviewBody": { "properties": { "text": { "type": "string", "title": "Text" }, "mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mode" } }, "type": "object", "required": [ "text" ], "title": "PreviewBody" }, "PreviewIn": { "properties": { "definition": { "additionalProperties": true, "type": "object", "title": "Definition" }, "days": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Days" }, "dimensions": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Dimensions" } }, "type": "object", "required": [ "definition" ], "title": "PreviewIn", "description": "An UNSAVED definition plus an optional window \u2014 the \"does this resolve?\" button." }, "PreviewRequest": { "properties": { "definition": { "additionalProperties": true, "type": "object", "title": "Definition", "default": {} }, "target_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Target Type" }, "sample_session_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sample Session Id" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" } }, "type": "object", "title": "PreviewRequest" }, "ProbeConnBody": { "properties": { "id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Id" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model" }, "baseUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Baseurl" }, "credential": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credential" }, "credentialMethod": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credentialmethod" }, "secretRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Secretref" }, "requestShape": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Requestshape" }, "invokePath": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Invokepath" }, "auth": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Auth" }, "outputJsonpath": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Outputjsonpath" }, "method": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Method" } }, "type": "object", "title": "ProbeConnBody" }, "ProjectCreate": { "properties": { "name": { "type": "string", "title": "Name" }, "org_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Org Id" }, "slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Slug" } }, "type": "object", "required": [ "name" ], "title": "ProjectCreate" }, "ProjectPref": { "properties": { "favorite": { "type": "boolean", "title": "Favorite" } }, "type": "object", "required": [ "favorite" ], "title": "ProjectPref", "description": "Per-user project preference toggle (currently just `favorite`)." }, "ProjectUpdate": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "slug": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Slug" }, "archived": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Archived" }, "org_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Org Id" } }, "type": "object", "title": "ProjectUpdate" }, "PromptCreate": { "properties": { "name": { "type": "string", "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "promptType": { "type": "string", "title": "Prompttype", "default": "chat" }, "content": { "title": "Content" }, "config": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Config" }, "commitMessage": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Commitmessage" }, "sourceType": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sourcetype" }, "sourceRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sourceref" } }, "type": "object", "required": [ "name", "content" ], "title": "PromptCreate" }, "PromptPatch": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" } }, "type": "object", "title": "PromptPatch" }, "ProveBody": { "properties": { "password": { "type": "string", "title": "Password" }, "code": { "type": "string", "title": "Code" } }, "type": "object", "required": [ "password", "code" ], "title": "ProveBody", "description": "The re-authentication both management actions require: the password AND a second factor." }, "PutRedactionSettingsBody": { "properties": { "mode": { "type": "string", "title": "Mode" }, "enforced": { "type": "boolean", "title": "Enforced", "default": false }, "egressMode": { "type": "string", "title": "Egressmode", "default": "" }, "allowlist": { "items": { "type": "string" }, "type": "array", "title": "Allowlist", "default": [] }, "customPatterns": { "items": { "$ref": "#/components/schemas/CustomPatternBody" }, "type": "array", "title": "Custompatterns", "default": [] } }, "type": "object", "required": [ "mode" ], "title": "PutRedactionSettingsBody" }, "QueueConfigBody": { "properties": { "statuses": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Statuses" }, "scoreFilters": { "anyOf": [ { "items": { "additionalProperties": true, "type": "object" }, "type": "array" }, { "type": "null" } ], "title": "Scorefilters" }, "includeFailureModeIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Includefailuremodeids" }, "includeClusterIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Includeclusterids" }, "includeTaxonomy": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Includetaxonomy" }, "onlyUnlabeled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Onlyunlabeled" }, "noveltyBudget": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Noveltybudget" }, "queueLimit": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Queuelimit" } }, "type": "object", "title": "QueueConfigBody" }, "RecordMergeBody": { "properties": { "prUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prurl" }, "commitSha": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Commitsha" }, "mergedAt": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Mergedat" } }, "type": "object", "title": "RecordMergeBody", "description": "Body for ``POST /remediations/items/{id}/record-merge`` \u2014 the manual / MCP merge-record path. All optional: pr/commit default from the remediation's columns, mergedAt\ndefaults to now." }, "RegenerateBody": { "properties": { "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" } }, "type": "object", "title": "RegenerateBody", "description": "Optional body for the single ``POST /remediations/items/{rid}/regenerate``. ``reason`` is a\nfree-text note recorded on the OLD (archived) remediation's evidence for audit." }, "RegenerateBulkBody": { "properties": { "remediationIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Remediationids" }, "failureModeId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failuremodeid" }, "allOpen": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Allopen" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" } }, "type": "object", "title": "RegenerateBulkBody", "description": "Body for ``POST /remediations/regenerate-bulk``. EXACTLY ONE selector must be set \u2014 an\nexplicit id list, a failure-mode/cluster's open backlog, or the whole project's open backlog \u2014\nelse the route 422s (none/ambiguous). ``reason`` is threaded onto each archived predecessor." }, "RemediationPatch": { "properties": { "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "workState": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workstate" }, "labels": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Labels" }, "prUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prurl" }, "commitSha": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Commitsha" }, "acknowledgedBy": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Acknowledgedby" }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" } }, "type": "object", "title": "RemediationPatch", "description": "Partial update. Any subset of the fields; at least one required.\n``model_fields_set`` distinguishes \"omitted\" from \"explicitly null\"." }, "ResetPasswordBody": { "properties": { "token": { "type": "string", "title": "Token" }, "newPassword": { "type": "string", "title": "Newpassword" } }, "type": "object", "required": [ "token", "newPassword" ], "title": "ResetPasswordBody" }, "ReviewCreate": { "properties": { "target_type": { "type": "string", "title": "Target Type", "default": "session" }, "target_id": { "type": "string", "title": "Target Id" }, "verdict": { "type": "string", "title": "Verdict" }, "critique": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Critique" }, "failure_mode_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failure Mode Id" }, "cluster_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cluster Id" }, "is_gold": { "type": "boolean", "title": "Is Gold", "default": false } }, "type": "object", "required": [ "target_id", "verdict" ], "title": "ReviewCreate" }, "RevokeKeyBody": { "properties": { "id": { "type": "string", "title": "Id" } }, "type": "object", "required": [ "id" ], "title": "RevokeKeyBody" }, "RunBody": { "properties": { "ids": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Ids" }, "filter": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Filter" }, "dataset_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Dataset Id" } }, "type": "object", "title": "RunBody" }, "RunTargetCreate": { "properties": { "name": { "type": "string", "title": "Name" }, "kind": { "type": "string", "title": "Kind" }, "grain": { "type": "string", "title": "Grain" }, "filter": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Filter" }, "sampling": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Sampling" }, "datasetId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Datasetid" }, "datasetVersionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Datasetversionid" }, "followLatest": { "type": "boolean", "title": "Followlatest", "default": false }, "defaultTrigger": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Defaulttrigger" } }, "type": "object", "required": [ "name", "kind", "grain" ], "title": "RunTargetCreate" }, "RunTargetPatch": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "filter": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Filter" }, "sampling": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Sampling" }, "datasetId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Datasetid" }, "datasetVersionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Datasetversionid" }, "followLatest": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Followlatest" }, "defaultTrigger": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Defaulttrigger" } }, "type": "object", "title": "RunTargetPatch" }, "ScoreDisplaySettingsPatch": { "properties": { "scaleMax": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Scalemax" }, "passThreshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Passthreshold" }, "warnThreshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Warnthreshold" }, "metricOverrides": { "anyOf": [ { "additionalProperties": { "$ref": "#/components/schemas/MetricBand" }, "type": "object" }, { "type": "null" } ], "title": "Metricoverrides" } }, "type": "object", "title": "ScoreDisplaySettingsPatch" }, "ScorePref": { "properties": { "metricKey": { "type": "string", "title": "Metrickey" }, "source": { "type": "string", "title": "Source" }, "targetType": { "type": "string", "title": "Targettype" }, "favorite": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Favorite" }, "hidden": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Hidden" } }, "type": "object", "required": [ "metricKey", "source", "targetType" ], "title": "ScorePref", "description": "Body for ``PUT /scores/prefs`` \u2014 a per-user favorite/hide toggle for one score type." }, "SetDigestBody": { "properties": { "optIn": { "type": "boolean", "title": "Optin" }, "frequency": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Frequency" } }, "type": "object", "required": [ "optIn" ], "title": "SetDigestBody" }, "SetLocaleBody": { "properties": { "locale": { "type": "string", "title": "Locale" } }, "type": "object", "required": [ "locale" ], "title": "SetLocaleBody" }, "SetMemberOrgsBody": { "properties": { "orgIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Orgids" }, "allOrgs": { "type": "boolean", "title": "Allorgs", "default": false } }, "type": "object", "title": "SetMemberOrgsBody", "description": "Replace an existing member's org assignment." }, "SetPersonaBody": { "properties": { "personaKey": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Personakey" }, "dismissed": { "type": "boolean", "title": "Dismissed", "default": false } }, "type": "object", "title": "SetPersonaBody" }, "SimulateRequest": { "properties": { "judgeId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Judgeid" }, "threshold": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Threshold" }, "connectionId": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Connectionid" }, "maxTargets": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Maxtargets" }, "targetIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Targetids" }, "sampling": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sampling" }, "strategy": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Strategy" } }, "type": "object", "title": "SimulateRequest", "description": "Optional overrides for a counterfactual simulation. Empty body \u21d2 today's auto behaviour\n(tiered judge, first N cluster members). All camelCase (the UI sends camelCase);\n``populate_by_name`` also accepts snake_case for API/tests." }, "SplitBody": { "properties": { "name": { "type": "string", "title": "Name" }, "cluster_ids": { "items": { "type": "string" }, "type": "array", "title": "Cluster Ids", "default": [] } }, "type": "object", "required": [ "name" ], "title": "SplitBody" }, "SuspendBody": { "properties": { "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" }, "detail": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Detail" } }, "additionalProperties": false, "type": "object", "title": "SuspendBody" }, "TableColumnsUpdate": { "properties": { "view": { "type": "string", "title": "View" }, "columns": { "items": { "type": "string" }, "type": "array", "title": "Columns" } }, "type": "object", "required": [ "view", "columns" ], "title": "TableColumnsUpdate" }, "ToggleBody": { "properties": { "enabled": { "type": "boolean", "title": "Enabled" } }, "type": "object", "required": [ "enabled" ], "title": "ToggleBody" }, "TraceInletCreate": { "properties": { "provider": { "type": "string", "title": "Provider" }, "name": { "type": "string", "title": "Name" }, "baseUrl": { "type": "string", "title": "Baseurl" }, "credential": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credential" }, "options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Options" }, "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" }, "pollIntervalMinutes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Pollintervalminutes" }, "backfillDays": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Backfilldays" } }, "type": "object", "required": [ "provider", "name", "baseUrl" ], "title": "TraceInletCreate" }, "TraceInletPatch": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "baseUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Baseurl" }, "credential": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credential" }, "options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Options" }, "enabled": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Enabled" }, "pollIntervalMinutes": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Pollintervalminutes" }, "backfillDays": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Backfilldays" } }, "type": "object", "title": "TraceInletPatch" }, "UpdateConnBody": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider" }, "model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model" }, "baseUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Baseurl" }, "credential": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credential" }, "credentialMethod": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credentialmethod" }, "secretRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Secretref" }, "requestsPerMinute": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Requestsperminute" }, "scopeType": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scopetype" }, "scopeIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Scopeids" }, "isDefault": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Isdefault" }, "options": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Options" } }, "type": "object", "title": "UpdateConnBody" }, "UpdateEnrichmentBody": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "outputFields": { "anyOf": [ { "items": { "$ref": "#/components/schemas/OutputField" }, "type": "array" }, { "type": "null" } ], "title": "Outputfields" }, "prerequisites": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Prerequisites" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "definition": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Definition" } }, "type": "object", "title": "UpdateEnrichmentBody", "description": "Partial edit of an existing enrichment. ``mode`` / ``targetType`` are intentionally NOT\neditable \u2014 output fields and stored outputs are shaped by them, so changing them would\norphan data; the UI creates a new enrichment instead. A non-empty ``definition`` (a changed\nprompt/connection) creates a new immutable version and promotes it; everything else mutates\nthe enrichment row in place." }, "UpdateMemberBody": { "properties": { "role": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role" }, "status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status" }, "personaDefault": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Personadefault" } }, "type": "object", "title": "UpdateMemberBody" }, "UpdatePersonaBody": { "properties": { "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "focusAreas": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Focusareas" }, "home": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Home" }, "defaultRange": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Defaultrange" }, "nav": { "anyOf": [ { "$ref": "#/components/schemas/PersonaNavInput" }, { "type": "null" } ] }, "dashboardIds": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "title": "Dashboardids" } }, "type": "object", "title": "UpdatePersonaBody", "description": "Partial edit \u2014 only the provided fields change. Editing a platform persona flips it to\n``custom`` provenance (frozen, no longer code-upgraded)." }, "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" }, "VcsInstallationCreate": { "properties": { "provider": { "type": "string", "title": "Provider" }, "name": { "type": "string", "title": "Name" }, "repoUrl": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Repourl" }, "baseBranch": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Basebranch" }, "config": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Config" }, "credential": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Credential" } }, "additionalProperties": false, "type": "object", "required": [ "provider", "name" ], "title": "VcsInstallationCreate" }, "VerifyBody": { "properties": { "password": { "type": "string", "title": "Password", "default": "" }, "code": { "type": "string", "title": "Code" } }, "type": "object", "required": [ "code" ], "title": "VerifyBody", "description": "The code **and** the account's current password." }, "VersionBody": { "properties": { "definition": { "additionalProperties": true, "type": "object", "title": "Definition", "default": {} }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" } }, "type": "object", "title": "VersionBody" }, "api__judges__VersionCreate": { "properties": { "definition": { "additionalProperties": true, "type": "object", "title": "Definition", "default": {} }, "note": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Note" }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Type" }, "scope": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Scope" }, "level": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Level" } }, "type": "object", "title": "VersionCreate" }, "api__prompts__VersionCreate": { "properties": { "content": { "title": "Content" }, "config": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Config" }, "commitMessage": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Commitmessage" }, "sourceType": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sourcetype" }, "sourceRef": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Sourceref" } }, "type": "object", "required": [ "content" ], "title": "VersionCreate" } } } }