{ "openapi": "3.1.0", "info": { "title": "ChoiceProof Cloud API", "version": "0.1.0", "description": "Cloud API v1 / cloud-2026-10-24.1. Bounded deterministic verification of approved evidence. Collectors perform external readback in the configured customer or connector environment; the verifier performs no external action." }, "servers": [{ "url": "https://choiceproof.dev" }], "security": [{ "ProjectKey": [] }], "paths": { "/api/v1/tasks": { "post": { "operationId": "authorizeTask", "description": "Workspace admin session or a template-bound authorize credential. Verify keys cannot authorize. Same template/taskId and parameters recover the same profile; changed parameters return 409.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "templateId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "taskId": { "type": "string", "minLength": 1, "maxLength": 160 }, "sourceBinding": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "target": { "minItems": 1, "maxItems": 8, "type": "array", "items": { "type": "string", "pattern": "^(0|[1-9][0-9]{0,19})$" } }, "cutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" } }, "required": ["projectId", "templateId", "taskId", "target"], "additionalProperties": false } } } }, "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object", "properties": { "profileId": { "type": "string", "format": "uuid" }, "profile": { "type": "object" }, "profileHash": { "type": "string" }, "replayed": { "type": "boolean" } } } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } }, "get": { "operationId": "getTaskProfile", "parameters": [ { "name": "projectId", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "profileId", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object" } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } }, "/api/v1/connection": { "get": { "operationId": "checkConnection", "parameters": [ { "name": "projectId", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object", "properties": { "connected": { "const": true }, "projectId": { "type": "string" }, "scope": { "type": "string" }, "templateId": { "type": ["string", "null"] }, "serverTime": { "type": "string", "format": "date-time" } } } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } }, "/api/v1/acceptance": { "get": { "operationId": "getDevelopmentAcceptance", "description": "Read the exact task or latest commit acceptance, stable requirement failure codes, expected/observed values, current evidence validity, retry guidance and independent GitHub/receiver delivery states. Historical conclusions are immutable. ChoiceProof does not launch a coding agent. Read-scoped project keys cannot modify requirements.", "parameters": [ { "name": "projectId", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "connectorId", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "taskId", "in": "query", "schema": { "type": "string", "maxLength": 160 } }, { "name": "commitSha", "in": "query", "schema": { "type": "string", "pattern": "^[a-f0-9]{40}$" } } ], "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object", "required": [ "schemaVersion", "status", "binding", "next", "history" ], "properties": { "schemaVersion": { "const": "choiceproof.cloud.acceptance.v1" }, "status": { "enum": [ "completed", "waiting", "needs_attention", "not_received" ] }, "projectId": { "type": "string", "format": "uuid" }, "connectorId": { "type": "string", "format": "uuid" }, "verificationId": { "type": ["string", "null"], "format": "uuid" }, "ruleVersion": { "type": ["string", "null"] }, "conclusion": { "enum": ["CONFIRMED", "UNRESOLVED", null] }, "validity": { "type": "object", "properties": { "issuedAt": { "type": ["string", "null"], "format": "date-time" }, "validUntil": { "type": ["string", "null"], "format": "date-time" }, "current": { "type": "boolean" } } }, "binding": { "type": ["object", "null"], "properties": { "repository": { "type": "string" }, "repositoryId": { "type": "string" }, "workflowId": { "type": "string" }, "taskId": { "type": "string" }, "commitSha": { "type": "string" }, "runId": { "type": "string" }, "runAttempt": { "type": "integer", "minimum": 1 } } }, "acceptance": { "anyOf": [ { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.cloud.acceptance-feedback.v1" }, "requirements": { "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "satisfied": { "type": "boolean" }, "code": { "type": "string" }, "expected": {}, "actual": {}, "evidence": { "type": "string" }, "nextAction": { "type": "string" }, "retryable": { "type": "boolean" }, "action": { "type": "string", "enum": [ "none", "change_code", "change_configuration", "new_run" ] } }, "required": [ "id", "title", "satisfied", "code", "evidence", "nextAction", "retryable", "action" ], "additionalProperties": false } }, "satisfied": { "type": "boolean" }, "satisfiedCount": { "type": "number", "minimum": 0, "multipleOf": 1 }, "requiredCount": { "type": "number", "exclusiveMinimum": 0, "multipleOf": 1 } }, "required": [ "schemaVersion", "requirements", "satisfied", "satisfiedCount", "requiredCount" ], "additionalProperties": false }, { "type": "null" } ] }, "github": { "type": "object", "properties": { "enabled": { "type": "boolean" }, "state": { "type": "string" }, "error": { "type": ["string", "null"] }, "url": { "type": ["string", "null"] } } }, "guidance": { "type": "object", "properties": { "category": { "type": "string" }, "code": { "type": "string" }, "title": { "type": "string" }, "action": { "type": "string" }, "message": { "type": "string" }, "automatic": { "type": "boolean", "description": "Whether collection retries automatically; never a code-edit trigger." } } }, "feedback": { "type": "object", "description": "Signed result notification status. Acknowledgment does not mean a customer action was executed. Pull means available for an authorized client to retrieve.", "properties": { "state": { "enum": [ "not_created", "pull", "pending", "delivering", "delivered", "failed" ] }, "label": { "type": "string" }, "attempts": { "type": "integer" }, "error": { "type": ["string", "null"] }, "acknowledgedAt": { "type": ["string", "null"], "format": "date-time" }, "retryAt": { "type": ["string", "null"], "format": "date-time" } } }, "next": { "type": "object", "required": [ "reasonCode", "action", "message", "retryable", "retryAt" ], "properties": { "reasonCode": { "type": "string" }, "action": { "enum": [ "none", "change_code", "change_configuration", "new_run", "reconnect", "wait" ] }, "message": { "type": "string" }, "retryable": { "type": "boolean" }, "retryAt": { "type": ["string", "null"], "format": "date-time" } } }, "history": { "type": "array", "items": { "type": "object" } } } } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } }, "/api/v1/acceptance/export": { "get": { "operationId": "exportDevelopmentAcceptance", "description": "Export one task including rule version, exact GitHub task/version binding, actual parsed report input, signed result and deterministic replay materials. Project read permission required; 30-day retention.", "parameters": [ { "name": "projectId", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "jobId", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object", "required": ["job", "stages", "events", "verification"], "properties": { "job": { "type": "object" }, "stages": { "type": "array", "items": { "type": "object" } }, "events": { "type": "array", "items": { "type": "object" } }, "deliveries": { "type": "array", "items": { "type": "object" } }, "verification": { "type": ["object", "null"] } } } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } }, "/api/v1/requests": { "get": { "operationId": "lookupRequest", "parameters": [ { "name": "projectId", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "reference", "in": "query", "schema": { "type": "string", "maxLength": 160 } } ], "description": "Find an original request ID or idempotency key after interruption. Reports and attempts have identical project access control. Failed attempts contain codes only; no submitted evidence.", "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object" } }, "original": { "type": ["object", "null"] }, "retry": { "type": "string" } } } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } }, "/api/v1/verifications": { "post": { "operationId": "createVerification", "parameters": [ { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "pattern": "^[A-Za-z0-9._:-]{8,128}$" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$schema": "http://json-schema.org/draft-07/schema#", "oneOf": [ { "type": "object", "properties": { "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "type": { "type": "string", "const": "coordinate_completion" }, "profileId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "observations": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.coordinate-observation.v1" }, "profileHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "taskId": { "type": "string", "minLength": 1, "maxLength": 160 }, "nonce": { "type": "string", "minLength": 1, "maxLength": 160 }, "domainId": { "type": "string", "minLength": 1, "maxLength": 160 }, "cutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "observedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "values": { "minItems": 1, "maxItems": 8, "type": "array", "items": { "type": "string", "maxLength": 20, "pattern": "^(0|[1-9][0-9]*)$" } }, "signer": { "type": "object", "properties": { "scheme": { "type": "string", "const": "ed25519-jcs" }, "keyId": { "type": "string", "minLength": 1, "maxLength": 160 }, "publicKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": ["scheme", "keyId", "publicKey"], "additionalProperties": false }, "signature": { "type": "string", "pattern": "^[a-f0-9]{128}$" } }, "required": [ "schemaVersion", "profileHash", "taskId", "nonce", "domainId", "cutoff", "observedAt", "values", "signer", "signature" ], "additionalProperties": false } } }, "required": [ "projectId", "type", "profileId", "observations" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "execution_evidence" }, "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "profileId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "artifacts": { "type": "object", "properties": { "envelopes": { "default": [], "minItems": 0, "maxItems": 0, "type": "array", "items": { "not": {} } }, "checkpoints": { "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.evidenceCheckpoint.v2" }, "checkpointHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "enterpriseIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "checkpointSequence": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "previousCheckpointHash": { "anyOf": [ { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, { "type": "null" } ] }, "treeProfile": { "type": "string", "const": "choiceproof.orderedEvidenceMerkle.v2" }, "leafCount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "merkleRoot": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "streamRanges": { "minItems": 1, "maxItems": 4096, "type": "array", "items": { "type": "object", "properties": { "streamIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "trustDomainHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "epochIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "sequenceAuthority": { "type": "string", "enum": [ "source_native", "enterprise_capture_store" ] }, "completenessScope": { "type": "string", "enum": [ "upstream_stream", "capture_order_only" ] }, "firstSequence": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "lastSequence": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "attestationCount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "predecessorAttestationHash": { "anyOf": [ { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, { "type": "null" } ] }, "finalAttestationHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }, "required": [ "streamIdHash", "trustDomainHash", "epochIdHash", "sequenceAuthority", "completenessScope", "firstSequence", "lastSequence", "attestationCount", "predecessorAttestationHash", "finalAttestationHash" ], "additionalProperties": false } }, "createdAt": { "type": "string" }, "factualTruth": { "type": "string", "const": "NOT_CLAIMED" }, "signer": { "type": "object", "properties": { "scheme": { "type": "string", "const": "ed25519-jcs" }, "keyId": { "type": "string", "pattern": "^ed25519-jcs:[0-9a-f]{24}$" }, "publicKey": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": ["scheme", "keyId", "publicKey"], "additionalProperties": false }, "signature": { "type": "string", "pattern": "^[0-9a-f]{128}$" } }, "required": [ "schemaVersion", "checkpointHash", "enterpriseIdHash", "checkpointSequence", "previousCheckpointHash", "treeProfile", "leafCount", "merkleRoot", "streamRanges", "createdAt", "factualTruth", "signer", "signature" ], "additionalProperties": false } }, "inclusionProofs": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.evidenceInclusionProof.v2" }, "treeProfile": { "type": "string", "const": "choiceproof.orderedEvidenceMerkle.v2" }, "checkpointHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "envelopeHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "leafIndex": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "leafCount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "siblings": { "maxItems": 64, "type": "array", "items": { "type": "object", "properties": { "level": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "position": { "type": "string", "enum": ["left", "right", "carry"] }, "hash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }, "required": ["level", "position", "hash"], "additionalProperties": false } } }, "required": [ "schemaVersion", "treeProfile", "checkpointHash", "envelopeHash", "leafIndex", "leafCount", "siblings" ], "additionalProperties": false } }, "externalFinalityAttestations": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.externalFinalityAttestation.v2" }, "checkpointHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "commitmentTypedDataHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "finalitySystem": { "type": "string", "pattern": "^[a-z][a-z0-9_.:-]{1,127}$" }, "finalityLevel": { "type": "string", "enum": [ "service_registered", "chain_confirmed", "chain_finalized" ] }, "finalityReferenceHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "chainId": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, { "type": "null" } ] }, "blockNumber": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, { "type": "null" } ] }, "blockHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "observedAt": { "type": "string" }, "verifierIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "verifierImplementationHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "networkUsed": { "type": "boolean" }, "factualTruth": { "type": "string", "const": "NOT_CLAIMED" }, "signer": { "type": "object", "properties": { "scheme": { "type": "string", "const": "ed25519-jcs" }, "keyId": { "type": "string", "pattern": "^ed25519-jcs:[0-9a-f]{24}$" }, "publicKey": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": ["scheme", "keyId", "publicKey"], "additionalProperties": false }, "signature": { "type": "string", "pattern": "^[0-9a-f]{128}$" } }, "required": [ "schemaVersion", "checkpointHash", "commitmentTypedDataHash", "finalitySystem", "finalityLevel", "finalityReferenceHash", "chainId", "blockNumber", "blockHash", "observedAt", "verifierIdHash", "verifierImplementationHash", "networkUsed", "factualTruth", "signer", "signature" ], "additionalProperties": false } } }, "required": [ "checkpoints", "inclusionProofs", "externalFinalityAttestations" ], "additionalProperties": false } }, "required": ["type", "projectId", "profileId", "artifacts"], "additionalProperties": false } ] } } } }, "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object", "required": ["id", "report", "replayed"], "properties": { "id": { "type": "string", "format": "uuid" }, "report": { "oneOf": [ { "type": "object", "required": [ "schemaVersion", "protocolVersion", "verifierVersion", "verificationId", "projectId", "profileId", "inputHash", "policyHash", "policy", "evaluatedAt", "executionStatus", "conclusion", "decision", "certificate", "checks", "requiredMaterials", "timings", "reportHash" ], "properties": { "verificationId": { "type": "string" }, "schemaVersion": { "const": "choiceproof.cloud.report.v1" }, "protocolVersion": { "enum": ["0.1.0", "2.5.0"] }, "verifierVersion": { "type": "string", "examples": ["cloud-2026-10-24.1"], "description": "Pinned verifier release. Historical reports retain their original version." }, "type": { "const": "coordinate_completion" }, "projectId": { "type": "string", "format": "uuid" }, "profileId": { "type": "string", "format": "uuid" }, "inputHash": { "type": "string" }, "policyHash": { "type": "string" }, "reportHash": { "type": "string" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "executionStatus": { "const": "completed" }, "conclusion": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "decision": { "type": "object", "properties": { "status": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "reason": { "enum": [ "WITHIN_CERTIFIED_BUDGET", "PROFILE_EXPIRED", "ASSESSMENT_TOO_EARLY", "DELIVERY_BUDGET_EXCEEDED" ] }, "profileHash": { "type": "string" }, "certificateHash": { "type": "string" }, "distance": { "type": "integer" }, "missingDomains": { "type": "array", "items": { "type": "string" } }, "disagreeingDomains": { "type": "array", "items": { "type": "string" } }, "conflictingDomains": { "type": "array", "items": { "type": "string" } }, "admittedObservations": { "type": "integer" }, "rejectedObservations": { "type": "integer" }, "limitations": { "type": "string" } } }, "policy": { "type": "object", "properties": { "kind": { "const": "workspace-admin-approved-profile" }, "approvalId": { "type": "string" }, "approvedBy": { "type": "string" }, "approvedAt": { "type": "string", "format": "date-time" }, "profileHash": { "type": "string" }, "falseReports": { "type": "integer" }, "omissions": { "type": "integer" }, "networkUsed": { "const": false }, "externalReadback": { "const": "NOT_REQUESTED" } } }, "certificate": { "type": "object" }, "checks": { "type": "object" }, "requiredMaterials": { "type": "array", "items": { "type": "string" } }, "timings": { "type": "object", "properties": { "kernelDurationMs": { "type": "integer", "minimum": 0 }, "queueDurationMs": { "const": 0 } } } } }, { "type": "object", "required": [ "type", "schemaVersion", "protocolVersion", "verifierVersion", "verificationId", "projectId", "profileId", "inputHash", "policyHash", "policy", "evaluatedAt", "executionStatus", "conclusion", "dimensions", "timings", "reportHash" ], "properties": { "verificationId": { "type": "string" }, "schemaVersion": { "const": "choiceproof.cloud.report.v1" }, "protocolVersion": { "enum": ["0.1.0", "2.5.0"] }, "verifierVersion": { "type": "string", "examples": ["cloud-2026-10-24.1"], "description": "Pinned verifier release. Historical reports retain their original version." }, "type": { "const": "execution_evidence" }, "projectId": { "type": "string", "format": "uuid" }, "profileId": { "type": "string", "format": "uuid" }, "inputHash": { "type": "string" }, "policyHash": { "type": "string" }, "reportHash": { "type": "string" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "executionStatus": { "const": "completed" }, "conclusion": { "enum": ["PASS", "FAIL", "INDETERMINATE"] }, "decision": { "type": "object", "properties": { "status": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "reason": { "enum": [ "WITHIN_CERTIFIED_BUDGET", "PROFILE_EXPIRED", "ASSESSMENT_TOO_EARLY", "DELIVERY_BUDGET_EXCEEDED" ] }, "profileHash": { "type": "string" }, "certificateHash": { "type": "string" }, "distance": { "type": "integer" }, "missingDomains": { "type": "array", "items": { "type": "string" } }, "disagreeingDomains": { "type": "array", "items": { "type": "string" } }, "conflictingDomains": { "type": "array", "items": { "type": "string" } }, "admittedObservations": { "type": "integer" }, "rejectedObservations": { "type": "integer" }, "limitations": { "type": "string" } } }, "policy": { "type": "object", "properties": { "kind": { "const": "workspace-admin-approved-evidence-policy" }, "scope": { "const": "public-checkpoint-signatures-inclusion-and-finality-statements" }, "profileHash": { "type": "string" }, "approvedBy": { "type": "string" }, "approvedAt": { "type": "string", "format": "date-time" }, "networkUsed": { "const": false } } }, "certificate": { "type": "object" }, "checks": { "type": "object" }, "requiredMaterials": { "type": "array", "items": { "type": "string" } }, "timings": { "type": "object", "properties": { "kernelDurationMs": { "type": "integer", "minimum": 0 }, "queueDurationMs": { "const": 0 } } }, "dimensions": { "type": "object", "description": "Public checkpoint integrity, assembler authenticity and signed finality statement checks; private continuity and corroboration are NOT_PROVIDED." } } } ] }, "replayed": { "type": "boolean" } } } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } }, "get": { "operationId": "listVerifications", "parameters": [ { "name": "search", "in": "query", "schema": { "type": "string", "maxLength": 160 } }, { "name": "projectId", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "page", "in": "query", "schema": { "type": "integer", "minimum": 0, "maximum": 1000, "default": 0 } }, { "name": "conclusion", "in": "query", "schema": { "enum": [ "CONFIRMED", "UNRESOLVED", "PASS", "FAIL", "INDETERMINATE" ] } } ], "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object", "properties": { "items": { "type": "array", "maxItems": 20, "items": { "type": "object", "properties": { "id": { "type": "string" }, "conclusion": { "enum": [ "CONFIRMED", "UNRESOLVED", "PASS", "FAIL", "INDETERMINATE" ] }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "input_hash": { "type": "string" }, "connectorTask": { "description": "Project-scoped GitHub task context, or null for a verification without a retained connector task. This navigation metadata is outside the signed report and export.", "anyOf": [ { "type": "object", "required": [ "id", "connectorId", "repository", "workflowName", "runId", "attempt", "commitSha" ], "properties": { "id": { "type": "string", "format": "uuid" }, "connectorId": { "type": "string", "format": "uuid" }, "repository": { "type": "string" }, "workflowName": { "type": ["string", "null"] }, "runId": { "type": "string" }, "attempt": { "type": "integer", "minimum": 1 }, "commitSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" } } }, { "type": "null" } ] } } } }, "page": { "type": "integer" }, "hasMore": { "type": "boolean" } } } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } }, "/api/v1/verifications/{id}": { "get": { "operationId": "getVerification", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object", "properties": { "id": { "type": "string" }, "report": { "oneOf": [ { "type": "object", "required": [ "schemaVersion", "protocolVersion", "verifierVersion", "verificationId", "projectId", "profileId", "inputHash", "policyHash", "policy", "evaluatedAt", "executionStatus", "conclusion", "decision", "certificate", "checks", "requiredMaterials", "timings", "reportHash" ], "properties": { "verificationId": { "type": "string" }, "schemaVersion": { "const": "choiceproof.cloud.report.v1" }, "protocolVersion": { "enum": ["0.1.0", "2.5.0"] }, "verifierVersion": { "type": "string", "examples": ["cloud-2026-10-24.1"], "description": "Pinned verifier release. Historical reports retain their original version." }, "type": { "const": "coordinate_completion" }, "projectId": { "type": "string", "format": "uuid" }, "profileId": { "type": "string", "format": "uuid" }, "inputHash": { "type": "string" }, "policyHash": { "type": "string" }, "reportHash": { "type": "string" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "executionStatus": { "const": "completed" }, "conclusion": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "decision": { "type": "object", "properties": { "status": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "reason": { "enum": [ "WITHIN_CERTIFIED_BUDGET", "PROFILE_EXPIRED", "ASSESSMENT_TOO_EARLY", "DELIVERY_BUDGET_EXCEEDED" ] }, "profileHash": { "type": "string" }, "certificateHash": { "type": "string" }, "distance": { "type": "integer" }, "missingDomains": { "type": "array", "items": { "type": "string" } }, "disagreeingDomains": { "type": "array", "items": { "type": "string" } }, "conflictingDomains": { "type": "array", "items": { "type": "string" } }, "admittedObservations": { "type": "integer" }, "rejectedObservations": { "type": "integer" }, "limitations": { "type": "string" } } }, "policy": { "type": "object", "properties": { "kind": { "const": "workspace-admin-approved-profile" }, "approvalId": { "type": "string" }, "approvedBy": { "type": "string" }, "approvedAt": { "type": "string", "format": "date-time" }, "profileHash": { "type": "string" }, "falseReports": { "type": "integer" }, "omissions": { "type": "integer" }, "networkUsed": { "const": false }, "externalReadback": { "const": "NOT_REQUESTED" } } }, "certificate": { "type": "object" }, "checks": { "type": "object" }, "requiredMaterials": { "type": "array", "items": { "type": "string" } }, "timings": { "type": "object", "properties": { "kernelDurationMs": { "type": "integer", "minimum": 0 }, "queueDurationMs": { "const": 0 } } } } }, { "type": "object", "required": [ "type", "schemaVersion", "protocolVersion", "verifierVersion", "verificationId", "projectId", "profileId", "inputHash", "policyHash", "policy", "evaluatedAt", "executionStatus", "conclusion", "dimensions", "timings", "reportHash" ], "properties": { "verificationId": { "type": "string" }, "schemaVersion": { "const": "choiceproof.cloud.report.v1" }, "protocolVersion": { "enum": ["0.1.0", "2.5.0"] }, "verifierVersion": { "type": "string", "examples": ["cloud-2026-10-24.1"], "description": "Pinned verifier release. Historical reports retain their original version." }, "type": { "const": "execution_evidence" }, "projectId": { "type": "string", "format": "uuid" }, "profileId": { "type": "string", "format": "uuid" }, "inputHash": { "type": "string" }, "policyHash": { "type": "string" }, "reportHash": { "type": "string" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "executionStatus": { "const": "completed" }, "conclusion": { "enum": ["PASS", "FAIL", "INDETERMINATE"] }, "decision": { "type": "object", "properties": { "status": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "reason": { "enum": [ "WITHIN_CERTIFIED_BUDGET", "PROFILE_EXPIRED", "ASSESSMENT_TOO_EARLY", "DELIVERY_BUDGET_EXCEEDED" ] }, "profileHash": { "type": "string" }, "certificateHash": { "type": "string" }, "distance": { "type": "integer" }, "missingDomains": { "type": "array", "items": { "type": "string" } }, "disagreeingDomains": { "type": "array", "items": { "type": "string" } }, "conflictingDomains": { "type": "array", "items": { "type": "string" } }, "admittedObservations": { "type": "integer" }, "rejectedObservations": { "type": "integer" }, "limitations": { "type": "string" } } }, "policy": { "type": "object", "properties": { "kind": { "const": "workspace-admin-approved-evidence-policy" }, "scope": { "const": "public-checkpoint-signatures-inclusion-and-finality-statements" }, "profileHash": { "type": "string" }, "approvedBy": { "type": "string" }, "approvedAt": { "type": "string", "format": "date-time" }, "networkUsed": { "const": false } } }, "certificate": { "type": "object" }, "checks": { "type": "object" }, "requiredMaterials": { "type": "array", "items": { "type": "string" } }, "timings": { "type": "object", "properties": { "kernelDurationMs": { "type": "integer", "minimum": 0 }, "queueDurationMs": { "const": 0 } } }, "dimensions": { "type": "object", "description": "Public checkpoint integrity, assembler authenticity and signed finality statement checks; private continuity and corroboration are NOT_PROVIDED." } } } ] }, "input": { "$schema": "http://json-schema.org/draft-07/schema#", "oneOf": [ { "type": "object", "properties": { "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "type": { "type": "string", "const": "coordinate_completion" }, "profileId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "observations": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.coordinate-observation.v1" }, "profileHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "taskId": { "type": "string", "minLength": 1, "maxLength": 160 }, "nonce": { "type": "string", "minLength": 1, "maxLength": 160 }, "domainId": { "type": "string", "minLength": 1, "maxLength": 160 }, "cutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "observedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "values": { "minItems": 1, "maxItems": 8, "type": "array", "items": { "type": "string", "maxLength": 20, "pattern": "^(0|[1-9][0-9]*)$" } }, "signer": { "type": "object", "properties": { "scheme": { "type": "string", "const": "ed25519-jcs" }, "keyId": { "type": "string", "minLength": 1, "maxLength": 160 }, "publicKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "scheme", "keyId", "publicKey" ], "additionalProperties": false }, "signature": { "type": "string", "pattern": "^[a-f0-9]{128}$" } }, "required": [ "schemaVersion", "profileHash", "taskId", "nonce", "domainId", "cutoff", "observedAt", "values", "signer", "signature" ], "additionalProperties": false } } }, "required": [ "projectId", "type", "profileId", "observations" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "execution_evidence" }, "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "profileId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "artifacts": { "type": "object", "properties": { "envelopes": { "default": [], "minItems": 0, "maxItems": 0, "type": "array", "items": { "not": {} } }, "checkpoints": { "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.evidenceCheckpoint.v2" }, "checkpointHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "enterpriseIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "checkpointSequence": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "previousCheckpointHash": { "anyOf": [ { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, { "type": "null" } ] }, "treeProfile": { "type": "string", "const": "choiceproof.orderedEvidenceMerkle.v2" }, "leafCount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "merkleRoot": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "streamRanges": { "minItems": 1, "maxItems": 4096, "type": "array", "items": { "type": "object", "properties": { "streamIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "trustDomainHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "epochIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "sequenceAuthority": { "type": "string", "enum": [ "source_native", "enterprise_capture_store" ] }, "completenessScope": { "type": "string", "enum": [ "upstream_stream", "capture_order_only" ] }, "firstSequence": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "lastSequence": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "attestationCount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "predecessorAttestationHash": { "anyOf": [ { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, { "type": "null" } ] }, "finalAttestationHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }, "required": [ "streamIdHash", "trustDomainHash", "epochIdHash", "sequenceAuthority", "completenessScope", "firstSequence", "lastSequence", "attestationCount", "predecessorAttestationHash", "finalAttestationHash" ], "additionalProperties": false } }, "createdAt": { "type": "string" }, "factualTruth": { "type": "string", "const": "NOT_CLAIMED" }, "signer": { "type": "object", "properties": { "scheme": { "type": "string", "const": "ed25519-jcs" }, "keyId": { "type": "string", "pattern": "^ed25519-jcs:[0-9a-f]{24}$" }, "publicKey": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "scheme", "keyId", "publicKey" ], "additionalProperties": false }, "signature": { "type": "string", "pattern": "^[0-9a-f]{128}$" } }, "required": [ "schemaVersion", "checkpointHash", "enterpriseIdHash", "checkpointSequence", "previousCheckpointHash", "treeProfile", "leafCount", "merkleRoot", "streamRanges", "createdAt", "factualTruth", "signer", "signature" ], "additionalProperties": false } }, "inclusionProofs": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.evidenceInclusionProof.v2" }, "treeProfile": { "type": "string", "const": "choiceproof.orderedEvidenceMerkle.v2" }, "checkpointHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "envelopeHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "leafIndex": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "leafCount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "siblings": { "maxItems": 64, "type": "array", "items": { "type": "object", "properties": { "level": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "position": { "type": "string", "enum": [ "left", "right", "carry" ] }, "hash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }, "required": [ "level", "position", "hash" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "treeProfile", "checkpointHash", "envelopeHash", "leafIndex", "leafCount", "siblings" ], "additionalProperties": false } }, "externalFinalityAttestations": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.externalFinalityAttestation.v2" }, "checkpointHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "commitmentTypedDataHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "finalitySystem": { "type": "string", "pattern": "^[a-z][a-z0-9_.:-]{1,127}$" }, "finalityLevel": { "type": "string", "enum": [ "service_registered", "chain_confirmed", "chain_finalized" ] }, "finalityReferenceHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "chainId": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, { "type": "null" } ] }, "blockNumber": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, { "type": "null" } ] }, "blockHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "observedAt": { "type": "string" }, "verifierIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "verifierImplementationHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "networkUsed": { "type": "boolean" }, "factualTruth": { "type": "string", "const": "NOT_CLAIMED" }, "signer": { "type": "object", "properties": { "scheme": { "type": "string", "const": "ed25519-jcs" }, "keyId": { "type": "string", "pattern": "^ed25519-jcs:[0-9a-f]{24}$" }, "publicKey": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "scheme", "keyId", "publicKey" ], "additionalProperties": false }, "signature": { "type": "string", "pattern": "^[0-9a-f]{128}$" } }, "required": [ "schemaVersion", "checkpointHash", "commitmentTypedDataHash", "finalitySystem", "finalityLevel", "finalityReferenceHash", "chainId", "blockNumber", "blockHash", "observedAt", "verifierIdHash", "verifierImplementationHash", "networkUsed", "factualTruth", "signer", "signature" ], "additionalProperties": false } } }, "required": [ "checkpoints", "inclusionProofs", "externalFinalityAttestations" ], "additionalProperties": false } }, "required": [ "type", "projectId", "profileId", "artifacts" ], "additionalProperties": false } ] }, "approval": { "type": "object" }, "created_at": { "type": "string" }, "expires_at": { "type": "string" }, "connectorTask": { "description": "Project-scoped GitHub task context, or null for a verification without a retained connector task. This navigation metadata is outside the signed report and export.", "anyOf": [ { "type": "object", "required": [ "id", "connectorId", "repository", "workflowName", "runId", "attempt", "commitSha" ], "properties": { "id": { "type": "string", "format": "uuid" }, "connectorId": { "type": "string", "format": "uuid" }, "repository": { "type": "string" }, "workflowName": { "type": ["string", "null"] }, "runId": { "type": "string" }, "attempt": { "type": "integer", "minimum": 1 }, "commitSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" } } }, { "type": "null" } ] } } } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } }, "/api/v1/verifications/{id}/export": { "get": { "operationId": "exportVerification", "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object", "properties": { "schemaVersion": { "const": "choiceproof.cloud.export.v1" }, "id": { "type": "string" }, "input": { "$schema": "http://json-schema.org/draft-07/schema#", "oneOf": [ { "type": "object", "properties": { "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "type": { "type": "string", "const": "coordinate_completion" }, "profileId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "observations": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.coordinate-observation.v1" }, "profileHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "taskId": { "type": "string", "minLength": 1, "maxLength": 160 }, "nonce": { "type": "string", "minLength": 1, "maxLength": 160 }, "domainId": { "type": "string", "minLength": 1, "maxLength": 160 }, "cutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "observedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "values": { "minItems": 1, "maxItems": 8, "type": "array", "items": { "type": "string", "maxLength": 20, "pattern": "^(0|[1-9][0-9]*)$" } }, "signer": { "type": "object", "properties": { "scheme": { "type": "string", "const": "ed25519-jcs" }, "keyId": { "type": "string", "minLength": 1, "maxLength": 160 }, "publicKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": [ "scheme", "keyId", "publicKey" ], "additionalProperties": false }, "signature": { "type": "string", "pattern": "^[a-f0-9]{128}$" } }, "required": [ "schemaVersion", "profileHash", "taskId", "nonce", "domainId", "cutoff", "observedAt", "values", "signer", "signature" ], "additionalProperties": false } } }, "required": [ "projectId", "type", "profileId", "observations" ], "additionalProperties": false }, { "type": "object", "properties": { "type": { "type": "string", "const": "execution_evidence" }, "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "profileId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "artifacts": { "type": "object", "properties": { "envelopes": { "default": [], "minItems": 0, "maxItems": 0, "type": "array", "items": { "not": {} } }, "checkpoints": { "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.evidenceCheckpoint.v2" }, "checkpointHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "enterpriseIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "checkpointSequence": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "previousCheckpointHash": { "anyOf": [ { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, { "type": "null" } ] }, "treeProfile": { "type": "string", "const": "choiceproof.orderedEvidenceMerkle.v2" }, "leafCount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "merkleRoot": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "streamRanges": { "minItems": 1, "maxItems": 4096, "type": "array", "items": { "type": "object", "properties": { "streamIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "trustDomainHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "epochIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "sequenceAuthority": { "type": "string", "enum": [ "source_native", "enterprise_capture_store" ] }, "completenessScope": { "type": "string", "enum": [ "upstream_stream", "capture_order_only" ] }, "firstSequence": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "lastSequence": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "attestationCount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "predecessorAttestationHash": { "anyOf": [ { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, { "type": "null" } ] }, "finalAttestationHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }, "required": [ "streamIdHash", "trustDomainHash", "epochIdHash", "sequenceAuthority", "completenessScope", "firstSequence", "lastSequence", "attestationCount", "predecessorAttestationHash", "finalAttestationHash" ], "additionalProperties": false } }, "createdAt": { "type": "string" }, "factualTruth": { "type": "string", "const": "NOT_CLAIMED" }, "signer": { "type": "object", "properties": { "scheme": { "type": "string", "const": "ed25519-jcs" }, "keyId": { "type": "string", "pattern": "^ed25519-jcs:[0-9a-f]{24}$" }, "publicKey": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "scheme", "keyId", "publicKey" ], "additionalProperties": false }, "signature": { "type": "string", "pattern": "^[0-9a-f]{128}$" } }, "required": [ "schemaVersion", "checkpointHash", "enterpriseIdHash", "checkpointSequence", "previousCheckpointHash", "treeProfile", "leafCount", "merkleRoot", "streamRanges", "createdAt", "factualTruth", "signer", "signature" ], "additionalProperties": false } }, "inclusionProofs": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.evidenceInclusionProof.v2" }, "treeProfile": { "type": "string", "const": "choiceproof.orderedEvidenceMerkle.v2" }, "checkpointHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "envelopeHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "leafIndex": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "leafCount": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "siblings": { "maxItems": 64, "type": "array", "items": { "type": "object", "properties": { "level": { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, "position": { "type": "string", "enum": [ "left", "right", "carry" ] }, "hash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" } }, "required": [ "level", "position", "hash" ], "additionalProperties": false } } }, "required": [ "schemaVersion", "treeProfile", "checkpointHash", "envelopeHash", "leafIndex", "leafCount", "siblings" ], "additionalProperties": false } }, "externalFinalityAttestations": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.externalFinalityAttestation.v2" }, "checkpointHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "commitmentTypedDataHash": { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, "finalitySystem": { "type": "string", "pattern": "^[a-z][a-z0-9_.:-]{1,127}$" }, "finalityLevel": { "type": "string", "enum": [ "service_registered", "chain_confirmed", "chain_finalized" ] }, "finalityReferenceHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "chainId": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, { "type": "null" } ] }, "blockNumber": { "anyOf": [ { "type": "string", "pattern": "^(0|[1-9][0-9]*)$" }, { "type": "null" } ] }, "blockHash": { "anyOf": [ { "type": "string", "pattern": "^0x[0-9a-f]{64}$" }, { "type": "null" } ] }, "observedAt": { "type": "string" }, "verifierIdHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "verifierImplementationHash": { "type": "string", "pattern": "^sha256:[0-9a-f]{64}$" }, "networkUsed": { "type": "boolean" }, "factualTruth": { "type": "string", "const": "NOT_CLAIMED" }, "signer": { "type": "object", "properties": { "scheme": { "type": "string", "const": "ed25519-jcs" }, "keyId": { "type": "string", "pattern": "^ed25519-jcs:[0-9a-f]{24}$" }, "publicKey": { "type": "string", "pattern": "^[0-9a-f]{64}$" } }, "required": [ "scheme", "keyId", "publicKey" ], "additionalProperties": false }, "signature": { "type": "string", "pattern": "^[0-9a-f]{128}$" } }, "required": [ "schemaVersion", "checkpointHash", "commitmentTypedDataHash", "finalitySystem", "finalityLevel", "finalityReferenceHash", "chainId", "blockNumber", "blockHash", "observedAt", "verifierIdHash", "verifierImplementationHash", "networkUsed", "factualTruth", "signer", "signature" ], "additionalProperties": false } } }, "required": [ "checkpoints", "inclusionProofs", "externalFinalityAttestations" ], "additionalProperties": false } }, "required": [ "type", "projectId", "profileId", "artifacts" ], "additionalProperties": false } ] }, "approval": { "type": "object" }, "report": { "oneOf": [ { "type": "object", "required": [ "schemaVersion", "protocolVersion", "verifierVersion", "verificationId", "projectId", "profileId", "inputHash", "policyHash", "policy", "evaluatedAt", "executionStatus", "conclusion", "decision", "certificate", "checks", "requiredMaterials", "timings", "reportHash" ], "properties": { "verificationId": { "type": "string" }, "schemaVersion": { "const": "choiceproof.cloud.report.v1" }, "protocolVersion": { "enum": ["0.1.0", "2.5.0"] }, "verifierVersion": { "type": "string", "examples": ["cloud-2026-10-24.1"], "description": "Pinned verifier release. Historical reports retain their original version." }, "type": { "const": "coordinate_completion" }, "projectId": { "type": "string", "format": "uuid" }, "profileId": { "type": "string", "format": "uuid" }, "inputHash": { "type": "string" }, "policyHash": { "type": "string" }, "reportHash": { "type": "string" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "executionStatus": { "const": "completed" }, "conclusion": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "decision": { "type": "object", "properties": { "status": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "reason": { "enum": [ "WITHIN_CERTIFIED_BUDGET", "PROFILE_EXPIRED", "ASSESSMENT_TOO_EARLY", "DELIVERY_BUDGET_EXCEEDED" ] }, "profileHash": { "type": "string" }, "certificateHash": { "type": "string" }, "distance": { "type": "integer" }, "missingDomains": { "type": "array", "items": { "type": "string" } }, "disagreeingDomains": { "type": "array", "items": { "type": "string" } }, "conflictingDomains": { "type": "array", "items": { "type": "string" } }, "admittedObservations": { "type": "integer" }, "rejectedObservations": { "type": "integer" }, "limitations": { "type": "string" } } }, "policy": { "type": "object", "properties": { "kind": { "const": "workspace-admin-approved-profile" }, "approvalId": { "type": "string" }, "approvedBy": { "type": "string" }, "approvedAt": { "type": "string", "format": "date-time" }, "profileHash": { "type": "string" }, "falseReports": { "type": "integer" }, "omissions": { "type": "integer" }, "networkUsed": { "const": false }, "externalReadback": { "const": "NOT_REQUESTED" } } }, "certificate": { "type": "object" }, "checks": { "type": "object" }, "requiredMaterials": { "type": "array", "items": { "type": "string" } }, "timings": { "type": "object", "properties": { "kernelDurationMs": { "type": "integer", "minimum": 0 }, "queueDurationMs": { "const": 0 } } } } }, { "type": "object", "required": [ "type", "schemaVersion", "protocolVersion", "verifierVersion", "verificationId", "projectId", "profileId", "inputHash", "policyHash", "policy", "evaluatedAt", "executionStatus", "conclusion", "dimensions", "timings", "reportHash" ], "properties": { "verificationId": { "type": "string" }, "schemaVersion": { "const": "choiceproof.cloud.report.v1" }, "protocolVersion": { "enum": ["0.1.0", "2.5.0"] }, "verifierVersion": { "type": "string", "examples": ["cloud-2026-10-24.1"], "description": "Pinned verifier release. Historical reports retain their original version." }, "type": { "const": "execution_evidence" }, "projectId": { "type": "string", "format": "uuid" }, "profileId": { "type": "string", "format": "uuid" }, "inputHash": { "type": "string" }, "policyHash": { "type": "string" }, "reportHash": { "type": "string" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "executionStatus": { "const": "completed" }, "conclusion": { "enum": ["PASS", "FAIL", "INDETERMINATE"] }, "decision": { "type": "object", "properties": { "status": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "reason": { "enum": [ "WITHIN_CERTIFIED_BUDGET", "PROFILE_EXPIRED", "ASSESSMENT_TOO_EARLY", "DELIVERY_BUDGET_EXCEEDED" ] }, "profileHash": { "type": "string" }, "certificateHash": { "type": "string" }, "distance": { "type": "integer" }, "missingDomains": { "type": "array", "items": { "type": "string" } }, "disagreeingDomains": { "type": "array", "items": { "type": "string" } }, "conflictingDomains": { "type": "array", "items": { "type": "string" } }, "admittedObservations": { "type": "integer" }, "rejectedObservations": { "type": "integer" }, "limitations": { "type": "string" } } }, "policy": { "type": "object", "properties": { "kind": { "const": "workspace-admin-approved-evidence-policy" }, "scope": { "const": "public-checkpoint-signatures-inclusion-and-finality-statements" }, "profileHash": { "type": "string" }, "approvedBy": { "type": "string" }, "approvedAt": { "type": "string", "format": "date-time" }, "networkUsed": { "const": false } } }, "certificate": { "type": "object" }, "checks": { "type": "object" }, "requiredMaterials": { "type": "array", "items": { "type": "string" } }, "timings": { "type": "object", "properties": { "kernelDurationMs": { "type": "integer", "minimum": 0 }, "queueDurationMs": { "const": 0 } } }, "dimensions": { "type": "object", "description": "Public checkpoint integrity, assembler authenticity and signed finality statement checks; private continuity and corroboration are NOT_PROVIDED." } } } ] } } } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } }, "/api/cloud/{...path}": { "parameters": [ { "name": "...path", "in": "path", "required": true, "schema": { "enum": [ "account", "setup", "templates", "templates/revoke", "projects", "project", "profiles", "profiles/revoke", "keys", "keys/revoke", "team", "invitations", "invitations/accept", "invitations/revoke", "members", "audit", "projects/delete", "replay", "verifier", "demo", "health", "maintenance", "operations" ] } } ], "get": { "security": [{ "Session": [] }], "description": "Browser management routes: account, projects?workspaceId, project?projectId, team?workspaceId, audit?workspaceId, verifier. health is public. The verifier response is a JavaScript attachment, not a JSON envelope.", "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object" } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } }, "post": { "security": [{ "Session": [] }], "description": "Browser-only mutations require an exact same-origin header. profiles uses ProfileApproval; project, key and team forms have strict route-specific schemas. demo is public and accepts only scenario=valid|tampered|missing|conflict.", "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object" } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } }, "/api/auth/{...path}": { "parameters": [ { "name": "...path", "in": "path", "required": true, "schema": { "type": "string" } } ], "get": { "security": [], "description": "Managed Neon Auth proxy, session and Google callback.", "responses": { "200": { "description": "Managed authentication response" }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } }, "post": { "security": [], "description": "Managed Neon Auth sign-in and sign-out; upstream origin and rate restrictions apply.", "responses": { "200": { "description": "Managed authentication response" }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } }, "/api/v1/result-events": { "get": { "operationId": "resultEvent", "summary": "Read a signed continuous verification result", "security": [{ "ProjectKey": [] }], "parameters": [ { "name": "projectId", "in": "query", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "name": "taskId", "in": "query", "required": true, "schema": { "type": "string", "maxLength": 160 } }, { "name": "connectorId", "in": "query", "required": false, "schema": { "type": "string", "format": "uuid" } } ], "description": "Uses the same project read permission and request IDs as reports. 409 RESULT_PENDING means keep waiting; 410 EVIDENCE_EXPIRED requires a new run; 429 FREE_QUOTA_EXCEEDED includes retryAt. Pass connectorId when several rules monitor the same run.", "responses": { "200": { "description": "Completed operation, not necessarily confirmed business outcome.", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "data"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "data": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "payload": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.cloud.result-event.v1" }, "eventId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "connectorId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "taskId": { "type": "string", "minLength": 1, "maxLength": 160 }, "objectId": { "type": "string", "minLength": 1, "maxLength": 200 }, "version": { "type": "string", "pattern": "^[a-f0-9]{40}$" }, "conclusion": { "type": "string", "enum": ["CONFIRMED", "UNRESOLVED"] }, "executionStatus": { "type": "string", "const": "completed" }, "verificationId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "ruleVersion": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "reportHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "reportUrl": { "type": "string", "format": "uri" }, "issuedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "validUntil": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "evidenceBinding": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "nextAction": { "type": "string", "enum": [ "eligible_for_customer_entry_check", "wait_and_repair" ] }, "acceptance": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.cloud.acceptance-feedback.v1" }, "requirements": { "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "title": { "type": "string" }, "satisfied": { "type": "boolean" }, "code": { "type": "string" }, "expected": {}, "actual": {}, "evidence": { "type": "string" }, "nextAction": { "type": "string" }, "retryable": { "type": "boolean" }, "action": { "type": "string", "enum": [ "none", "change_code", "change_configuration", "new_run" ] } }, "required": [ "id", "title", "satisfied", "code", "evidence", "nextAction", "retryable", "action" ], "additionalProperties": false } }, "satisfied": { "type": "boolean" }, "satisfiedCount": { "type": "number", "minimum": 0, "multipleOf": 1 }, "requiredCount": { "type": "number", "exclusiveMinimum": 0, "multipleOf": 1 } }, "required": [ "schemaVersion", "requirements", "satisfied", "satisfiedCount", "requiredCount" ], "additionalProperties": false } }, "required": [ "schemaVersion", "eventId", "projectId", "connectorId", "taskId", "objectId", "version", "conclusion", "executionStatus", "verificationId", "ruleVersion", "reportHash", "reportUrl", "issuedAt", "validUntil", "evidenceBinding", "nextAction" ], "additionalProperties": false }, "signature": { "type": "string" }, "public_key": { "type": "string" }, "state": { "type": "string" } } } } } } } }, "400": { "description": "Invalid JSON or missing idempotency key", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "401": { "description": "Session/key required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "403": { "description": "Role or origin denied", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "404": { "description": "Resource not found for this caller", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "408": { "description": "Upload timeout; retry the same request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "409": { "description": "Idempotency key bound to different request", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "410": { "description": "Original result expired; idempotency binding retained", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "413": { "description": "Request size exceeded", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "415": { "description": "JSON required", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "422": { "description": "Schema, profile or computation constraint", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "429": { "description": "Rate or concurrency limit", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } }, "503": { "description": "Unavailable dependency; retry safely", "content": { "application/json": { "schema": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "headers": { "x-request-id": { "schema": { "type": "string" } }, "Retry-After": { "schema": { "type": "string" }, "description": "Seconds; returned on 429 and 503" } } } } } } }, "components": { "securitySchemes": { "ProjectKey": { "type": "http", "scheme": "bearer", "bearerFormat": "cp_live_…" }, "Session": { "type": "apiKey", "in": "cookie", "name": "__Secure-neon-auth.session_token" } }, "schemas": { "ProfileApproval": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "projectId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$" }, "name": { "type": "string", "minLength": 1, "maxLength": 80 }, "profile": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.coordinate-completion-profile.v1" }, "taskId": { "type": "string", "minLength": 1, "maxLength": 160 }, "nonce": { "type": "string", "minLength": 1, "maxLength": 160 }, "historyClass": { "type": "string", "const": "independent-nonnegative-counts" }, "effectScope": { "type": "string", "minLength": 1, "maxLength": 4000 }, "includesOtherEffects": { "type": "boolean", "const": true }, "coordinates": { "minItems": 1, "maxItems": 64, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 160 } }, "target": { "minItems": 1, "maxItems": 64, "type": "array", "items": { "type": "string", "maxLength": 80, "pattern": "^(0|[1-9][0-9]*)$" } }, "domains": { "minItems": 1, "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "domainId": { "type": "string", "minLength": 1, "maxLength": 160 }, "signers": { "minItems": 1, "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "scheme": { "type": "string", "const": "ed25519-jcs" }, "keyId": { "type": "string", "minLength": 1, "maxLength": 160 }, "publicKey": { "type": "string", "pattern": "^[a-f0-9]{64}$" } }, "required": ["scheme", "keyId", "publicKey"], "additionalProperties": false } }, "coordinates": { "minItems": 1, "maxItems": 64, "type": "array", "items": { "type": "integer", "minimum": 0, "maximum": 63 } }, "acquisitionScope": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "required": [ "domainId", "signers", "coordinates", "acquisitionScope" ], "additionalProperties": false } }, "falseReports": { "type": "integer", "minimum": 0, "maximum": 256 }, "omissions": { "type": "integer", "minimum": 0, "maximum": 256 }, "approvedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "cutoff": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "expiresAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" } }, "required": [ "schemaVersion", "taskId", "nonce", "historyClass", "effectScope", "includesOtherEffects", "coordinates", "target", "domains", "falseReports", "omissions", "approvedAt", "cutoff", "expiresAt" ], "additionalProperties": false } }, "required": ["projectId", "name", "profile"], "additionalProperties": false }, "DevelopmentRule": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.cloud.development-rule.v1" }, "preset": { "type": "string", "enum": ["build_test", "release", "critical_flow", "custom"] }, "requiredJobs": { "minItems": 1, "maxItems": 8, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "reports": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,49}$" }, "artifact": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_.{}-]+$" }, "path": { "type": "string", "minLength": 1, "maxLength": 240 }, "format": { "type": "string", "enum": ["junit", "vitest", "playwright"] }, "minTests": { "default": 1, "type": "integer", "minimum": 1, "maximum": 10000 }, "maxSkipped": { "default": 0, "type": "integer", "minimum": 0, "maximum": 10000 }, "requiredTests": { "default": [], "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 300 } }, "duplicateNames": { "type": "string", "const": "all_must_pass" } }, "required": ["id", "artifact", "path", "format"], "additionalProperties": false } }, "files": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,49}$" }, "artifact": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_.{}-]+$" }, "paths": { "minItems": 1, "maxItems": 16, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 } } }, "required": ["id", "artifact", "paths"], "additionalProperties": false } }, "runtime": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,49}$" }, "artifact": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_.{}-]+$" }, "path": { "type": "string", "minLength": 1, "maxLength": 240 }, "plan": { "oneOf": [ { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.runtime-plan.v1" }, "kind": { "type": "string", "const": "web" }, "entryPath": { "type": "string", "minLength": 1, "maxLength": 1024 }, "requiredResources": { "maxItems": 32, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "operations": { "maxItems": 16, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "click" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 } }, "required": ["id", "kind", "selector"], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "fill" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 }, "value": { "type": "string", "maxLength": 1000 } }, "required": ["id", "kind", "selector", "value"], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "assert_visible" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 } }, "required": ["id", "kind", "selector"], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "assert_text" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 }, "equals": { "type": "string", "maxLength": 2000 } }, "required": [ "id", "kind", "selector", "equals" ], "additionalProperties": false } ] } } }, "required": [ "schemaVersion", "kind", "entryPath", "requiredResources", "operations" ], "additionalProperties": false }, { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.runtime-plan.v1" }, "kind": { "type": "string", "const": "http" }, "request": { "type": "object", "properties": { "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "method": { "type": "string", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] }, "path": { "type": "string", "minLength": 1, "maxLength": 1024 }, "body": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 100 }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } }, "required": ["sourceId", "method", "path"], "additionalProperties": false }, "taskBinding": { "type": "object", "properties": { "readbackPointer": { "type": "string", "maxLength": 500 } }, "required": ["readbackPointer"], "additionalProperties": false }, "response": { "type": "object", "properties": { "status": { "type": "integer", "minimum": 200, "maximum": 299 }, "assertions": { "minItems": 1, "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "pointer": { "type": "string", "maxLength": 500 }, "equals": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "required": ["pointer", "equals"], "additionalProperties": false } } }, "required": ["status", "assertions"], "additionalProperties": false }, "readback": { "type": "object", "properties": { "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "path": { "type": "string", "minLength": 1, "maxLength": 1024 }, "status": { "type": "integer", "minimum": 200, "maximum": 299 }, "assertions": { "minItems": 1, "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "pointer": { "type": "string", "maxLength": 500 }, "equals": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "required": ["pointer", "equals"], "additionalProperties": false } } }, "required": [ "sourceId", "path", "status", "assertions" ], "additionalProperties": false } }, "required": [ "schemaVersion", "kind", "request", "response", "readback" ], "additionalProperties": false }, { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.runtime-plan.v1" }, "kind": { "type": "string", "const": "dataset" }, "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "objectId": { "type": "string", "minLength": 1, "maxLength": 160 }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "expectedRecords": { "minItems": 1, "maxItems": 1000, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "values": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 100 }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } }, "required": ["id", "values"], "additionalProperties": false } } }, "required": [ "schemaVersion", "kind", "sourceId", "objectId", "version", "expectedRecords" ], "additionalProperties": false } ] } }, "required": ["id", "artifact", "path", "plan"], "additionalProperties": false } }, "baseline": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.collection-baseline.v1" }, "files": { "minItems": 1, "maxItems": 128, "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 240 }, "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": ["path", "sha256"], "additionalProperties": false } } }, "required": ["schemaVersion", "files"], "additionalProperties": false } }, "required": [ "schemaVersion", "preset", "requiredJobs", "reports", "files" ], "additionalProperties": false }, "DevelopmentEvidence": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.cloud.development-evidence.v1" }, "rule": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.cloud.development-rule.v1" }, "preset": { "type": "string", "enum": ["build_test", "release", "critical_flow", "custom"] }, "requiredJobs": { "minItems": 1, "maxItems": 8, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 100 } }, "reports": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,49}$" }, "artifact": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_.{}-]+$" }, "path": { "type": "string", "minLength": 1, "maxLength": 240 }, "format": { "type": "string", "enum": ["junit", "vitest", "playwright"] }, "minTests": { "default": 1, "type": "integer", "minimum": 1, "maximum": 10000 }, "maxSkipped": { "default": 0, "type": "integer", "minimum": 0, "maximum": 10000 }, "requiredTests": { "default": [], "maxItems": 100, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 300 } }, "duplicateNames": { "type": "string", "const": "all_must_pass" } }, "required": ["id", "artifact", "path", "format"], "additionalProperties": false } }, "files": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,49}$" }, "artifact": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_.{}-]+$" }, "paths": { "minItems": 1, "maxItems": 16, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 240 } } }, "required": ["id", "artifact", "paths"], "additionalProperties": false } }, "runtime": { "minItems": 1, "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,49}$" }, "artifact": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "^[A-Za-z0-9_.{}-]+$" }, "path": { "type": "string", "minLength": 1, "maxLength": 240 }, "plan": { "oneOf": [ { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.runtime-plan.v1" }, "kind": { "type": "string", "const": "web" }, "entryPath": { "type": "string", "minLength": 1, "maxLength": 1024 }, "requiredResources": { "maxItems": 32, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "operations": { "maxItems": 16, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "click" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 } }, "required": ["id", "kind", "selector"], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "fill" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 }, "value": { "type": "string", "maxLength": 1000 } }, "required": [ "id", "kind", "selector", "value" ], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "assert_visible" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 } }, "required": ["id", "kind", "selector"], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "assert_text" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 }, "equals": { "type": "string", "maxLength": 2000 } }, "required": [ "id", "kind", "selector", "equals" ], "additionalProperties": false } ] } } }, "required": [ "schemaVersion", "kind", "entryPath", "requiredResources", "operations" ], "additionalProperties": false }, { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.runtime-plan.v1" }, "kind": { "type": "string", "const": "http" }, "request": { "type": "object", "properties": { "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "method": { "type": "string", "enum": [ "GET", "POST", "PUT", "PATCH", "DELETE" ] }, "path": { "type": "string", "minLength": 1, "maxLength": 1024 }, "body": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 100 }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } }, "required": ["sourceId", "method", "path"], "additionalProperties": false }, "taskBinding": { "type": "object", "properties": { "readbackPointer": { "type": "string", "maxLength": 500 } }, "required": ["readbackPointer"], "additionalProperties": false }, "response": { "type": "object", "properties": { "status": { "type": "integer", "minimum": 200, "maximum": 299 }, "assertions": { "minItems": 1, "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "pointer": { "type": "string", "maxLength": 500 }, "equals": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "required": ["pointer", "equals"], "additionalProperties": false } } }, "required": ["status", "assertions"], "additionalProperties": false }, "readback": { "type": "object", "properties": { "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "path": { "type": "string", "minLength": 1, "maxLength": 1024 }, "status": { "type": "integer", "minimum": 200, "maximum": 299 }, "assertions": { "minItems": 1, "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "pointer": { "type": "string", "maxLength": 500 }, "equals": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "required": ["pointer", "equals"], "additionalProperties": false } } }, "required": [ "sourceId", "path", "status", "assertions" ], "additionalProperties": false } }, "required": [ "schemaVersion", "kind", "request", "response", "readback" ], "additionalProperties": false }, { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.runtime-plan.v1" }, "kind": { "type": "string", "const": "dataset" }, "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "objectId": { "type": "string", "minLength": 1, "maxLength": 160 }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "expectedRecords": { "minItems": 1, "maxItems": 1000, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "values": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 100 }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } }, "required": ["id", "values"], "additionalProperties": false } } }, "required": [ "schemaVersion", "kind", "sourceId", "objectId", "version", "expectedRecords" ], "additionalProperties": false } ] } }, "required": ["id", "artifact", "path", "plan"], "additionalProperties": false } }, "baseline": { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.collection-baseline.v1" }, "files": { "minItems": 1, "maxItems": 128, "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 240 }, "sha256": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } }, "required": ["path", "sha256"], "additionalProperties": false } } }, "required": ["schemaVersion", "files"], "additionalProperties": false } }, "required": [ "schemaVersion", "preset", "requiredJobs", "reports", "files" ], "additionalProperties": false }, "binding": { "type": "object", "properties": { "repository": { "type": "string", "minLength": 1 }, "repositoryId": { "type": "string", "pattern": "^\\d+$" }, "runId": { "type": "string", "pattern": "^\\d+$" }, "runAttempt": { "type": "number", "exclusiveMinimum": 0, "multipleOf": 1 }, "commitSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" } }, "required": [ "repository", "repositoryId", "runId", "runAttempt", "commitSha" ], "additionalProperties": false }, "runWindow": { "type": "object", "properties": { "startedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "completedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" } }, "required": ["startedAt", "completedAt"], "additionalProperties": false }, "jobs": { "maxItems": 100, "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "status": { "type": "string" }, "conclusion": { "type": ["string", "null"] } }, "required": ["name", "status", "conclusion"], "additionalProperties": false } }, "reports": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "ruleId": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,49}$" }, "artifactId": { "type": "string" }, "archiveDigest": { "type": "string" }, "path": { "type": "string" }, "text": { "type": "string", "maxLength": 262144 }, "manifest": { "type": "object", "properties": { "repository": { "type": "string", "minLength": 1 }, "repositoryId": { "type": "string", "pattern": "^\\d+$" }, "runId": { "type": "string", "pattern": "^\\d+$" }, "runAttempt": { "type": "number", "exclusiveMinimum": 0, "multipleOf": 1 }, "commitSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" }, "schemaVersion": { "type": "string", "const": "choiceproof.cloud.run-manifest.v1" }, "files": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 240 }, "additionalProperties": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } } }, "required": [ "repository", "repositoryId", "runId", "runAttempt", "commitSha", "schemaVersion", "files" ], "additionalProperties": false }, "error": { "type": "string", "maxLength": 80 } }, "required": ["ruleId", "artifactId", "archiveDigest", "path"], "additionalProperties": false } }, "runtime": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "ruleId": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,49}$" }, "artifactId": { "type": "string" }, "archiveDigest": { "type": "string" }, "path": { "type": "string" }, "text": { "type": "string", "maxLength": 262144 }, "manifest": { "type": "object", "properties": { "repository": { "type": "string", "minLength": 1 }, "repositoryId": { "type": "string", "pattern": "^\\d+$" }, "runId": { "type": "string", "pattern": "^\\d+$" }, "runAttempt": { "type": "number", "exclusiveMinimum": 0, "multipleOf": 1 }, "commitSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" }, "schemaVersion": { "type": "string", "const": "choiceproof.cloud.run-manifest.v1" }, "files": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 240 }, "additionalProperties": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } } }, "required": [ "repository", "repositoryId", "runId", "runAttempt", "commitSha", "schemaVersion", "files" ], "additionalProperties": false }, "error": { "type": "string", "maxLength": 80 } }, "required": ["ruleId", "artifactId", "archiveDigest", "path"], "additionalProperties": false } }, "baseline": { "type": "object", "properties": { "commitSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" }, "files": { "maxItems": 128, "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 240 }, "sha256": { "anyOf": [ { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, { "type": "null" } ] } }, "required": ["path", "sha256"], "additionalProperties": false } } }, "required": ["commitSha", "files"], "additionalProperties": false }, "files": { "maxItems": 4, "type": "array", "items": { "type": "object", "properties": { "ruleId": { "type": "string", "pattern": "^[a-z][a-z0-9_-]{0,49}$" }, "artifactId": { "type": "string" }, "archiveDigest": { "type": "string" }, "manifest": { "type": "object", "properties": { "repository": { "type": "string", "minLength": 1 }, "repositoryId": { "type": "string", "pattern": "^\\d+$" }, "runId": { "type": "string", "pattern": "^\\d+$" }, "runAttempt": { "type": "number", "exclusiveMinimum": 0, "multipleOf": 1 }, "commitSha": { "type": "string", "pattern": "^[a-f0-9]{40}$" }, "schemaVersion": { "type": "string", "const": "choiceproof.cloud.run-manifest.v1" }, "files": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 240 }, "additionalProperties": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" } } }, "required": [ "repository", "repositoryId", "runId", "runAttempt", "commitSha", "schemaVersion", "files" ], "additionalProperties": false }, "entries": { "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 240 }, "sha256": { "type": "string" }, "bytes": { "type": "number", "minimum": 0, "multipleOf": 1 } }, "required": ["path", "sha256", "bytes"], "additionalProperties": false } }, "error": { "type": "string" } }, "required": ["ruleId", "artifactId", "archiveDigest", "entries"], "additionalProperties": false } } }, "required": [ "schemaVersion", "rule", "binding", "jobs", "reports", "files" ], "additionalProperties": false }, "RuntimePlan": { "$schema": "http://json-schema.org/draft-07/schema#", "oneOf": [ { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.runtime-plan.v1" }, "kind": { "type": "string", "const": "web" }, "entryPath": { "type": "string", "minLength": 1, "maxLength": 1024 }, "requiredResources": { "maxItems": 32, "type": "array", "items": { "type": "string", "minLength": 1, "maxLength": 1024 } }, "operations": { "maxItems": 16, "type": "array", "items": { "oneOf": [ { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "click" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 } }, "required": ["id", "kind", "selector"], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "fill" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 }, "value": { "type": "string", "maxLength": 1000 } }, "required": ["id", "kind", "selector", "value"], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "assert_visible" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 } }, "required": ["id", "kind", "selector"], "additionalProperties": false }, { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "const": "assert_text" }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 }, "equals": { "type": "string", "maxLength": 2000 } }, "required": ["id", "kind", "selector", "equals"], "additionalProperties": false } ] } } }, "required": [ "schemaVersion", "kind", "entryPath", "requiredResources", "operations" ], "additionalProperties": false }, { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.runtime-plan.v1" }, "kind": { "type": "string", "const": "http" }, "request": { "type": "object", "properties": { "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "method": { "type": "string", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] }, "path": { "type": "string", "minLength": 1, "maxLength": 1024 }, "body": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 100 }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } }, "required": ["sourceId", "method", "path"], "additionalProperties": false }, "taskBinding": { "type": "object", "properties": { "readbackPointer": { "type": "string", "maxLength": 500 } }, "required": ["readbackPointer"], "additionalProperties": false }, "response": { "type": "object", "properties": { "status": { "type": "integer", "minimum": 200, "maximum": 299 }, "assertions": { "minItems": 1, "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "pointer": { "type": "string", "maxLength": 500 }, "equals": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "required": ["pointer", "equals"], "additionalProperties": false } } }, "required": ["status", "assertions"], "additionalProperties": false }, "readback": { "type": "object", "properties": { "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "path": { "type": "string", "minLength": 1, "maxLength": 1024 }, "status": { "type": "integer", "minimum": 200, "maximum": 299 }, "assertions": { "minItems": 1, "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "pointer": { "type": "string", "maxLength": 500 }, "equals": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "required": ["pointer", "equals"], "additionalProperties": false } } }, "required": ["sourceId", "path", "status", "assertions"], "additionalProperties": false } }, "required": [ "schemaVersion", "kind", "request", "response", "readback" ], "additionalProperties": false }, { "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.runtime-plan.v1" }, "kind": { "type": "string", "const": "dataset" }, "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "objectId": { "type": "string", "minLength": 1, "maxLength": 160 }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "expectedRecords": { "minItems": 1, "maxItems": 1000, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "values": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 100 }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } }, "required": ["id", "values"], "additionalProperties": false } } }, "required": [ "schemaVersion", "kind", "sourceId", "objectId", "version", "expectedRecords" ], "additionalProperties": false } ] }, "RuntimeEvidence": { "$schema": "http://json-schema.org/draft-07/schema#", "type": "object", "properties": { "schemaVersion": { "type": "string", "const": "choiceproof.runtime-evidence.v1" }, "planHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "binding": { "type": "object", "properties": { "taskId": { "type": "string", "minLength": 1, "maxLength": 160 }, "objectId": { "type": "string", "minLength": 1, "maxLength": 160 }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "attempt": { "type": "integer", "exclusiveMinimum": 0, "maximum": 1000000 } }, "required": ["taskId", "objectId", "version", "attempt"], "additionalProperties": false }, "observedAt": { "type": "string", "format": "date-time", "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$" }, "observation": { "oneOf": [ { "type": "object", "properties": { "kind": { "type": "string", "const": "web" }, "browser": { "type": "string", "const": "chromium" }, "complete": { "type": "boolean" }, "navigation": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 1024 }, "status": { "type": "integer", "minimum": 100, "maximum": 599 } }, "required": ["path", "status"], "additionalProperties": false }, "resources": { "maxItems": 256, "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string", "minLength": 1, "maxLength": 1024 }, "status": { "anyOf": [ { "type": "integer", "minimum": 100, "maximum": 599 }, { "type": "null" } ] }, "error": { "type": "string", "maxLength": 200 } }, "required": ["path", "status"], "additionalProperties": false } }, "browserErrors": { "maxItems": 32, "type": "array", "items": { "type": "string", "maxLength": 200 } }, "operations": { "maxItems": 16, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "kind": { "type": "string", "enum": [ "click", "fill", "assert_visible", "assert_text" ] }, "selector": { "type": "string", "minLength": 1, "maxLength": 300 }, "completed": { "type": "boolean" }, "count": { "type": "integer", "minimum": 0, "maximum": 100000 }, "visible": { "type": "boolean" }, "text": { "type": "string", "maxLength": 2000 }, "value": { "type": "string", "maxLength": 1000 }, "error": { "type": "string", "maxLength": 200 } }, "required": [ "id", "kind", "selector", "completed", "count" ], "additionalProperties": false } } }, "required": [ "kind", "browser", "complete", "navigation", "resources", "browserErrors", "operations" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "http" }, "request": { "type": "object", "properties": { "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "method": { "type": "string", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] }, "path": { "type": "string", "minLength": 1, "maxLength": 1024 }, "status": { "type": "integer", "minimum": 100, "maximum": 599 }, "requestHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "bodyHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "values": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "pointer": { "type": "string", "maxLength": 500 }, "found": { "type": "boolean" }, "value": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "required": ["pointer", "found"], "additionalProperties": false } } }, "required": [ "sourceId", "method", "path", "status", "requestHash", "bodyHash", "values" ], "additionalProperties": false }, "readback": { "type": "object", "properties": { "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "method": { "type": "string", "enum": ["GET", "POST", "PUT", "PATCH", "DELETE"] }, "path": { "type": "string", "minLength": 1, "maxLength": 1024 }, "status": { "type": "integer", "minimum": 100, "maximum": 599 }, "requestHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "bodyHash": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" }, "values": { "maxItems": 32, "type": "array", "items": { "type": "object", "properties": { "pointer": { "type": "string", "maxLength": 500 }, "found": { "type": "boolean" }, "value": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } }, "required": ["pointer", "found"], "additionalProperties": false } } }, "required": [ "sourceId", "method", "path", "status", "requestHash", "bodyHash", "values" ], "additionalProperties": false } }, "required": ["kind", "request", "readback"], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "dataset" }, "sourceId": { "type": "string", "minLength": 1, "maxLength": 160 }, "objectId": { "type": "string", "minLength": 1, "maxLength": 160 }, "version": { "type": "string", "minLength": 1, "maxLength": 160 }, "closed": { "type": "boolean" }, "records": { "maxItems": 1000, "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "minLength": 1, "maxLength": 160 }, "values": { "type": "object", "propertyNames": { "type": "string", "minLength": 1, "maxLength": 100 }, "additionalProperties": { "anyOf": [ { "type": "string", "maxLength": 4096 }, { "type": "number" }, { "type": "boolean" }, { "type": "null" } ] } } }, "required": ["id", "values"], "additionalProperties": false } } }, "required": [ "kind", "sourceId", "objectId", "version", "closed", "records" ], "additionalProperties": false }, { "type": "object", "properties": { "kind": { "type": "string", "const": "error" }, "code": { "type": "string", "enum": [ "SOURCE_UNAVAILABLE", "TIMEOUT", "BROWSER_UNAVAILABLE", "BODY_TOO_LARGE", "RESPONSE_INVALID", "CONFIGURATION_INVALID" ] }, "message": { "type": "string", "minLength": 1, "maxLength": 300 } }, "required": ["kind", "code", "message"], "additionalProperties": false } ] } }, "required": [ "schemaVersion", "planHash", "binding", "observedAt", "observation" ], "additionalProperties": false }, "Report": { "oneOf": [ { "type": "object", "required": [ "schemaVersion", "protocolVersion", "verifierVersion", "verificationId", "projectId", "profileId", "inputHash", "policyHash", "policy", "evaluatedAt", "executionStatus", "conclusion", "decision", "certificate", "checks", "requiredMaterials", "timings", "reportHash" ], "properties": { "verificationId": { "type": "string" }, "schemaVersion": { "const": "choiceproof.cloud.report.v1" }, "protocolVersion": { "enum": ["0.1.0", "2.5.0"] }, "verifierVersion": { "type": "string", "examples": ["cloud-2026-10-24.1"], "description": "Pinned verifier release. Historical reports retain their original version." }, "type": { "const": "coordinate_completion" }, "projectId": { "type": "string", "format": "uuid" }, "profileId": { "type": "string", "format": "uuid" }, "inputHash": { "type": "string" }, "policyHash": { "type": "string" }, "reportHash": { "type": "string" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "executionStatus": { "const": "completed" }, "conclusion": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "decision": { "type": "object", "properties": { "status": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "reason": { "enum": [ "WITHIN_CERTIFIED_BUDGET", "PROFILE_EXPIRED", "ASSESSMENT_TOO_EARLY", "DELIVERY_BUDGET_EXCEEDED" ] }, "profileHash": { "type": "string" }, "certificateHash": { "type": "string" }, "distance": { "type": "integer" }, "missingDomains": { "type": "array", "items": { "type": "string" } }, "disagreeingDomains": { "type": "array", "items": { "type": "string" } }, "conflictingDomains": { "type": "array", "items": { "type": "string" } }, "admittedObservations": { "type": "integer" }, "rejectedObservations": { "type": "integer" }, "limitations": { "type": "string" } } }, "policy": { "type": "object", "properties": { "kind": { "const": "workspace-admin-approved-profile" }, "approvalId": { "type": "string" }, "approvedBy": { "type": "string" }, "approvedAt": { "type": "string", "format": "date-time" }, "profileHash": { "type": "string" }, "falseReports": { "type": "integer" }, "omissions": { "type": "integer" }, "networkUsed": { "const": false }, "externalReadback": { "const": "NOT_REQUESTED" } } }, "certificate": { "type": "object" }, "checks": { "type": "object" }, "requiredMaterials": { "type": "array", "items": { "type": "string" } }, "timings": { "type": "object", "properties": { "kernelDurationMs": { "type": "integer", "minimum": 0 }, "queueDurationMs": { "const": 0 } } } } }, { "type": "object", "required": [ "type", "schemaVersion", "protocolVersion", "verifierVersion", "verificationId", "projectId", "profileId", "inputHash", "policyHash", "policy", "evaluatedAt", "executionStatus", "conclusion", "dimensions", "timings", "reportHash" ], "properties": { "verificationId": { "type": "string" }, "schemaVersion": { "const": "choiceproof.cloud.report.v1" }, "protocolVersion": { "enum": ["0.1.0", "2.5.0"] }, "verifierVersion": { "type": "string", "examples": ["cloud-2026-10-24.1"], "description": "Pinned verifier release. Historical reports retain their original version." }, "type": { "const": "execution_evidence" }, "projectId": { "type": "string", "format": "uuid" }, "profileId": { "type": "string", "format": "uuid" }, "inputHash": { "type": "string" }, "policyHash": { "type": "string" }, "reportHash": { "type": "string" }, "evaluatedAt": { "type": "string", "format": "date-time" }, "executionStatus": { "const": "completed" }, "conclusion": { "enum": ["PASS", "FAIL", "INDETERMINATE"] }, "decision": { "type": "object", "properties": { "status": { "enum": ["CONFIRMED", "UNRESOLVED"] }, "reason": { "enum": [ "WITHIN_CERTIFIED_BUDGET", "PROFILE_EXPIRED", "ASSESSMENT_TOO_EARLY", "DELIVERY_BUDGET_EXCEEDED" ] }, "profileHash": { "type": "string" }, "certificateHash": { "type": "string" }, "distance": { "type": "integer" }, "missingDomains": { "type": "array", "items": { "type": "string" } }, "disagreeingDomains": { "type": "array", "items": { "type": "string" } }, "conflictingDomains": { "type": "array", "items": { "type": "string" } }, "admittedObservations": { "type": "integer" }, "rejectedObservations": { "type": "integer" }, "limitations": { "type": "string" } } }, "policy": { "type": "object", "properties": { "kind": { "const": "workspace-admin-approved-evidence-policy" }, "scope": { "const": "public-checkpoint-signatures-inclusion-and-finality-statements" }, "profileHash": { "type": "string" }, "approvedBy": { "type": "string" }, "approvedAt": { "type": "string", "format": "date-time" }, "networkUsed": { "const": false } } }, "certificate": { "type": "object" }, "checks": { "type": "object" }, "requiredMaterials": { "type": "array", "items": { "type": "string" } }, "timings": { "type": "object", "properties": { "kernelDurationMs": { "type": "integer", "minimum": 0 }, "queueDurationMs": { "const": 0 } } }, "dimensions": { "type": "object", "description": "Public checkpoint integrity, assembler authenticity and signed finality statement checks; private continuity and corroboration are NOT_PROVIDED." } } } ] }, "Error": { "type": "object", "required": ["requestId", "error"], "properties": { "requestId": { "type": "string", "format": "uuid" }, "error": { "type": "object", "required": ["code", "message"], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryAt": { "type": "string", "format": "date-time" }, "fields": { "type": "array", "items": { "type": "object", "properties": { "path": { "type": "string" }, "message": { "type": "string" } } } } } } } } } }, "x-limits": { "bodyBytes": 131072, "coordinates": 8, "domains": 16, "signersPerDomain": 4, "observations": 32, "countDigits": 20, "dailyVerifications": 100, "globalDailyVerifications": 10000, "liveResultsPerWorkspace": 3000, "templates": 20, "taskProfilesPerDay": 200, "requestsPerMinute": 30, "publicRequestsPerMinute": 5, "projects": 5, "profiles": 100, "outputBytes": 262144, "retentionDays": 30, "concurrentVerifications": 8, "inFlightPerInstance": 16 } }