{ "openapi": "3.1.0", "info": { "title": "PragmaChange management API", "version": "0.1.0", "description": "Single-administrator control plane. Production inference uses the native C ABI, never this HTTP API. JSON fields and PostgreSQL identifiers use snake_case." }, "servers": [ { "url": "/api/v1" } ], "security": [ { "session": [] } ], "paths": { "/login": { "post": { "summary": "Create a 12-hour administrator session", "operationId": "post_login", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "properties": { "token": { "type": "string" }, "csrf_token": { "type": "string" }, "expires_in": { "type": "integer" } }, "required": [ "token", "csrf_token", "expires_in" ], "additionalProperties": false } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "security": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "username": { "type": "string" }, "password": { "type": "string" } }, "required": [ "username", "password" ], "additionalProperties": false } } } } } }, "/logout": { "post": { "summary": "Revoke the current session", "operationId": "post_logout", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } } } } } }, "/overview": { "get": { "summary": "Workspace counts", "operationId": "get_overview", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/apis": { "get": { "summary": "List latest 200 apis (newest first)", "operationId": "get_apis", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object" } } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "summary": "Register an API host", "operationId": "post_apis", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Identifier" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "host": { "type": "string" } }, "required": [ "name", "host" ], "additionalProperties": false } } } } } }, "/endpoints": { "get": { "summary": "List latest 200 endpoints (newest first)", "operationId": "get_endpoints", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object" } } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "summary": "Create endpoint; reject overlapping routes", "operationId": "post_endpoints", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Identifier" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "api_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "method": { "type": "string" }, "path_template": { "type": "string" } }, "required": [ "api_id", "name", "method", "path_template" ], "additionalProperties": false } } } } } }, "/pipelines": { "get": { "summary": "List latest 200 pipelines (newest first)", "operationId": "get_pipelines", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object" } } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "summary": "Validate and save an immutable pipeline version", "operationId": "post_pipelines", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Pipeline" } } } } } }, "/datasets": { "get": { "summary": "List latest 200 datasets (newest first)", "operationId": "get_datasets", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object" } } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "summary": "Validate and import dataset with at least 20 usable rows", "operationId": "post_datasets", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DatasetImport" } } } } } }, "/training-jobs": { "get": { "summary": "List latest 200 training-jobs (newest first)", "operationId": "get_training_jobs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object" } } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "summary": "Queue a durable training job", "operationId": "post_training_jobs", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Identifier" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "dataset_id": { "type": "string", "format": "uuid" }, "parameters": { "$ref": "#/components/schemas/TrainingParameters" } }, "required": [ "dataset_id" ], "additionalProperties": false } } } } } }, "/models": { "get": { "summary": "List latest 200 models (newest first)", "operationId": "get_models", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object" } } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/releases": { "get": { "summary": "List latest 200 releases (newest first)", "operationId": "get_releases", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object" } } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "summary": "Validate and create an immutable release", "operationId": "post_releases", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Identifier" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "name": { "type": "string" }, "models": { "type": "array", "items": { "type": "object", "properties": { "model_version_id": { "type": "string", "format": "uuid" }, "thresholds": { "$ref": "#/components/schemas/Thresholds" } }, "required": [ "model_version_id", "thresholds" ], "additionalProperties": false } } }, "required": [ "name", "models" ], "additionalProperties": false } } } } } }, "/audit-events": { "get": { "summary": "List latest 200 audit-events (newest first)", "operationId": "get_audit_events", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object" } } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/pipelines/{id}/template": { "get": { "summary": "Generate CSV, JSONL and schema-manifest examples", "operationId": "get_pipelines_id_template", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string", "format": "uuid" } } ] } }, "/pipelines/{id}/replay": { "post": { "summary": "Replay events in isolated fresh window state", "operationId": "post_pipelines_id_replay", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "events": { "type": "array", "items": { "$ref": "#/components/schemas/RequestEvent" } }, "model_version_id": { "type": [ "string", "null" ], "format": "uuid" }, "thresholds": { "oneOf": [ { "$ref": "#/components/schemas/Thresholds" }, { "type": "null" } ] } }, "required": [ "events" ], "additionalProperties": false } } } } } }, "/datasets/preview": { "post": { "summary": "Validate without saving; return row errors and feature preview", "operationId": "post_datasets_preview", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DatasetImport" } } } } } }, "/training-jobs/{id}/retry": { "post": { "summary": "Retry a failed training job", "operationId": "post_training_jobs_id_retry", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": {}, "required": [], "additionalProperties": false } } } } } }, "/models/{id}": { "get": { "summary": "Model metadata with dataset, training job, pipeline, endpoint and API provenance", "operationId": "get_models_id", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object", "required": [ "id", "dataset", "training_job", "pipeline", "endpoint", "api" ], "properties": { "id": { "type": "string", "format": "uuid" }, "dataset": { "type": "object" }, "training_job": { "type": "object" }, "pipeline": { "type": "object" }, "endpoint": { "type": "object" }, "api": { "type": "object" } }, "additionalProperties": true } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string", "format": "uuid" } } ] } }, "/models/{id}/score": { "post": { "summary": "Score a vector with explicit thresholds", "operationId": "post_models_id_score", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Decision" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "in": "header", "name": "X-CSRF-Token", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "vector": { "type": "array", "items": { "type": "number" } }, "thresholds": { "$ref": "#/components/schemas/Thresholds" } }, "required": [ "vector", "thresholds" ], "additionalProperties": false } } } } } }, "/releases/{id}/download": { "get": { "summary": "Export verified release archive", "operationId": "get_releases_id_download", "responses": { "200": { "description": "Success", "content": { "application/gzip": { "schema": { "type": "string", "format": "binary" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string", "format": "uuid" } } ] } }, "/openapi.json": { "get": { "summary": "Read this API contract", "operationId": "get_openapi_json", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "object" } } } }, "401": { "description": "Session required", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "CSRF validation failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "Not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "Resource conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "Validation error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } } }, "components": { "securitySchemes": { "session": { "type": "http", "scheme": "bearer" } }, "schemas": { "Error": { "type": "object", "properties": { "error": { "type": "string" } }, "required": [ "error" ], "additionalProperties": false }, "Identifier": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "required": [ "id" ], "additionalProperties": false }, "Thresholds": { "type": "object", "properties": { "check": { "type": "number", "minimum": 0, "maximum": 1 }, "block": { "type": "number", "minimum": 0, "maximum": 1 } }, "required": [ "check", "block" ], "additionalProperties": false, "description": "Require check < block. Anomaly scores are not attack probabilities." }, "Source": { "oneOf": [ { "type": "object", "properties": { "kind": { "const": "header" }, "name": { "type": "string" } }, "required": [ "kind", "name" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "json_pointer" }, "pointer": { "type": "string" } }, "required": [ "kind", "pointer" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "query_parameter" }, "name": { "type": "string" } }, "required": [ "kind", "name" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "path_parameter" }, "name": { "type": "string" } }, "required": [ "kind", "name" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "const": "client_ip" } }, "required": [ "kind" ], "additionalProperties": false } ] }, "Extractor": { "type": "object", "properties": { "name": { "type": "string" }, "source": { "$ref": "#/components/schemas/Source" } }, "required": [ "name", "source" ], "additionalProperties": false }, "Partition": { "type": "object", "properties": { "name": { "type": "string" }, "components": { "type": "array", "items": { "type": "string" } } }, "required": [ "name", "components" ], "additionalProperties": false }, "Window": { "type": "object", "properties": { "name": { "type": "string" }, "duration_ms": { "type": "integer", "minimum": 1, "maximum": 86400000 } }, "required": [ "name", "duration_ms" ], "additionalProperties": false }, "Feature": { "type": "object", "properties": { "name": { "type": "string" }, "operation": { "enum": [ "count", "rate", "sum", "mean", "min", "max", "stddev", "distinct_count", "interarrival_mean", "interarrival_stddev", "current_value", "body_size" ] }, "source": { "type": [ "string", "null" ] }, "partition": { "type": [ "string", "null" ] }, "window": { "type": [ "string", "null" ] } }, "required": [ "name", "operation", "source", "partition", "window" ], "additionalProperties": false }, "Limits": { "type": "object", "properties": { "max_body_bytes": { "type": "integer" }, "max_partitions": { "type": "integer" }, "max_events_per_partition": { "type": "integer" }, "max_partition_bytes": { "type": "integer" } }, "required": [ "max_body_bytes", "max_partitions", "max_events_per_partition", "max_partition_bytes" ], "additionalProperties": false }, "RequestEvent": { "type": "object", "properties": { "timestamp_ms": { "type": "integer" }, "endpoint_id": { "type": "string", "format": "uuid" }, "method": { "type": "string" }, "path": { "type": "string" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "query": { "type": "object", "additionalProperties": { "type": "string" } }, "client_ip": { "type": "string" }, "body": {}, "body_size": { "type": "integer" } }, "required": [ "timestamp_ms", "endpoint_id", "method", "path" ], "additionalProperties": false }, "TrainingParameters": { "type": "object", "properties": { "n_estimators": { "type": "integer", "minimum": 1, "maximum": 512, "default": 100 }, "max_samples": { "type": "integer", "minimum": 2, "maximum": 65536, "default": 256 }, "seed": { "type": "integer", "minimum": 0, "maximum": 4294967295, "default": 42 } }, "required": [], "additionalProperties": false }, "Decision": { "type": "object", "properties": { "action": { "enum": [ "allow", "check", "block" ] }, "risk_score": { "type": [ "number", "null" ] }, "reason": { "type": "string" }, "pipeline_version_id": { "type": "string", "format": "uuid" }, "model_version_id": { "type": [ "string", "null" ], "format": "uuid" } }, "required": [ "action", "risk_score", "reason", "pipeline_version_id", "model_version_id" ], "additionalProperties": false }, "Pipeline": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "endpoint_id": { "type": "string", "format": "uuid" }, "api_host": { "type": "string" }, "method": { "type": "string" }, "path_template": { "type": "string" }, "extractors": { "type": "array", "items": { "$ref": "#/components/schemas/Extractor" } }, "partitions": { "type": "array", "items": { "$ref": "#/components/schemas/Partition" } }, "windows": { "type": "array", "items": { "$ref": "#/components/schemas/Window" } }, "features": { "type": "array", "items": { "$ref": "#/components/schemas/Feature" } }, "limits": { "$ref": "#/components/schemas/Limits" } }, "required": [ "id", "endpoint_id", "api_host", "method", "path_template", "extractors", "partitions", "windows", "features", "limits" ], "additionalProperties": false, "description": "POST assigns a fresh id and derives host/method/path from endpoint_id. Feature order is significant. Versions are immutable." }, "DatasetImport": { "type": "object", "properties": { "pipeline_version_id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "format": { "enum": [ "request_events", "feature_vectors" ] }, "content": { "type": "string" }, "schema_hash": { "type": "string" }, "recording_manifest": { "oneOf": [ { "$ref": "#/components/schemas/RecordingManifest" }, { "type": "null" } ] } }, "required": [ "pipeline_version_id", "name", "format", "content", "schema_hash" ], "additionalProperties": false, "description": "Maximum request size 16 MiB; up to 100,000 rows. JSONL event rows or CSV with exact named columns. At least 20 complete vectors for import." }, "RecordingManifest": { "title": "PragmaChange recording manifest v1", "type": "object", "additionalProperties": false, "required": [ "format_version", "recording_id", "config", "row_count", "byte_count", "content_sha256", "finalized" ], "properties": { "format_version": { "const": 1 }, "recording_id": { "type": "string", "format": "uuid" }, "config": { "type": "object", "additionalProperties": false, "required": [ "format" ], "properties": { "format": { "enum": [ "request_events", "behavior_events" ] }, "application_id": { "type": [ "string", "null" ], "format": "uuid" }, "pipeline_version_id": { "type": [ "string", "null" ], "format": "uuid" }, "endpoint_id": { "type": [ "string", "null" ], "format": "uuid" }, "schema_hash": { "type": [ "string", "null" ], "pattern": "^[0-9a-fA-F]{64}$" }, "allowed_headers": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 64 }, "default": [] }, "allowed_query": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 64 }, "default": [] }, "allowed_body_fields": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 64 }, "default": [] }, "allowed_attributes": { "type": "array", "maxItems": 32, "items": { "type": "string", "minLength": 1, "maxLength": 64 }, "default": [] }, "include_client_ip": { "type": "boolean", "default": false }, "max_bytes": { "type": "integer", "minimum": 1, "maximum": 4194304, "default": 4194304 }, "max_records": { "type": "integer", "minimum": 1, "maximum": 100000, "default": 100000 } }, "allOf": [ { "if": { "properties": { "format": { "const": "request_events" } } }, "then": { "required": [ "endpoint_id", "pipeline_version_id", "schema_hash" ], "properties": { "endpoint_id": { "type": "string", "format": "uuid" }, "pipeline_version_id": { "type": "string", "format": "uuid" }, "schema_hash": { "type": "string" } } } }, { "if": { "properties": { "format": { "const": "behavior_events" } } }, "then": { "required": [ "application_id" ], "properties": { "application_id": { "type": "string", "format": "uuid" } } } } ] }, "pipeline_version_id": { "type": [ "string", "null" ], "format": "uuid" }, "schema_hash": { "type": [ "string", "null" ] }, "row_count": { "type": "integer", "minimum": 0, "maximum": 100000 }, "byte_count": { "type": "integer", "minimum": 0, "maximum": 4194304 }, "content_sha256": { "type": "string", "pattern": "^[0-9a-f]{64}$" }, "finalized": { "type": "boolean" } }, "description": "Import requires finalized=true, at least one row, exact byte/row counts and SHA-256 of UTF-8 records.jsonl including its final newline. Top-level pipeline bindings must equal config bindings. Records are at most 16 KiB each. Field string limits are UTF-8 byte limits." } } } }