{ "openapi": "3.1.0", "info": { "title": "OWP local evaluation profile", "version": "0.1.0", "description": "Complete synthetic loopback adapter, not OWP v0.4 conformance. Ed25519 proof of possession; no TLS, identity verification, real data, provider or payment support." }, "servers": [ { "url": "http://127.0.0.1:8787" } ], "paths": { "/v1/profile": { "get": { "operationId": "Discoverprofile", "summary": "Discover profile", "description": "Public; no body. Pin the instance ID before registration.", "parameters": [], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ProfileResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "401": { "description": "AUTH_REQUIRED, INVALID_SIGNATURE, CLOCK_SKEW, UNKNOWN_SESSION, SESSION_EXPIRED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "403": { "description": "FORBIDDEN, GRANT_REQUIRED, GRANT_REVOKED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "404": { "description": "NOT_FOUND", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "405": { "description": "METHOD_NOT_ALLOWED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "409": { "description": "INSTANCE_CHANGED, IDEMPOTENCY_CONFLICT, REGISTRATION_EXISTS, INVALID_STATE, DEADLINE_EXCEEDED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "422": { "description": "UNSUPPORTED_CAPABILITY, INVALID_OUTPUT", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "429": { "description": "CAPACITY_REACHED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "500": { "description": "INTERNAL_ERROR", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/register": { "post": { "operationId": "Registeragent", "summary": "Register agent", "description": "Self-signed proof of key possession; session header is a single hyphen. One fixture per key.", "parameters": [ { "in": "header", "name": "OWP-Profile", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Instance-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Agent-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Session-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Timestamp", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Request-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Signature", "required": true, "schema": { "type": "string" }, "description": "Ed25519 signature of the exact nine-line frame documented in PROTOCOL.md. No trailing LF." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/RegistrationRequest" } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/RegistrationResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "401": { "description": "AUTH_REQUIRED, INVALID_SIGNATURE, CLOCK_SKEW, UNKNOWN_SESSION, SESSION_EXPIRED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "403": { "description": "FORBIDDEN, GRANT_REQUIRED, GRANT_REVOKED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "404": { "description": "NOT_FOUND", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "405": { "description": "METHOD_NOT_ALLOWED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "409": { "description": "INSTANCE_CHANGED, IDEMPOTENCY_CONFLICT, REGISTRATION_EXISTS, INVALID_STATE, DEADLINE_EXCEEDED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "422": { "description": "UNSUPPORTED_CAPABILITY, INVALID_OUTPUT", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "429": { "description": "CAPACITY_REACHED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "500": { "description": "INTERNAL_ERROR", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/job": { "get": { "operationId": "Readjob", "summary": "Read job", "description": "Current session-owned snapshot. No body. Reading after deadline expires unfinished work.", "parameters": [ { "in": "header", "name": "OWP-Profile", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Instance-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Agent-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Session-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Timestamp", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Request-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Signature", "required": true, "schema": { "type": "string" }, "description": "Ed25519 signature of the exact nine-line frame documented in PROTOCOL.md. No trailing LF." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/JobSnapshot" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "401": { "description": "AUTH_REQUIRED, INVALID_SIGNATURE, CLOCK_SKEW, UNKNOWN_SESSION, SESSION_EXPIRED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "403": { "description": "FORBIDDEN, GRANT_REQUIRED, GRANT_REVOKED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "404": { "description": "NOT_FOUND", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "405": { "description": "METHOD_NOT_ALLOWED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "409": { "description": "INSTANCE_CHANGED, IDEMPOTENCY_CONFLICT, REGISTRATION_EXISTS, INVALID_STATE, DEADLINE_EXCEEDED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "422": { "description": "UNSUPPORTED_CAPABILITY, INVALID_OUTPUT", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "429": { "description": "CAPACITY_REACHED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "500": { "description": "INTERNAL_ERROR", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/accept": { "post": { "operationId": "Acceptassignment", "summary": "Accept assignment", "description": "OFFERED → ACCEPTED. Different request ID after acceptance returns INVALID_STATE.", "parameters": [ { "in": "header", "name": "OWP-Profile", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Instance-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Agent-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Session-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Timestamp", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Request-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Signature", "required": true, "schema": { "type": "string" }, "description": "Ed25519 signature of the exact nine-line frame documented in PROTOCOL.md. No trailing LF." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/JobRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/JobSnapshot" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "401": { "description": "AUTH_REQUIRED, INVALID_SIGNATURE, CLOCK_SKEW, UNKNOWN_SESSION, SESSION_EXPIRED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "403": { "description": "FORBIDDEN, GRANT_REQUIRED, GRANT_REVOKED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "404": { "description": "NOT_FOUND", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "405": { "description": "METHOD_NOT_ALLOWED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "409": { "description": "INSTANCE_CHANGED, IDEMPOTENCY_CONFLICT, REGISTRATION_EXISTS, INVALID_STATE, DEADLINE_EXCEEDED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "422": { "description": "UNSUPPORTED_CAPABILITY, INVALID_OUTPUT", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "429": { "description": "CAPACITY_REACHED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "500": { "description": "INTERNAL_ERROR", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/decline": { "post": { "operationId": "Declineassignment", "summary": "Decline assignment", "description": "OFFERED → DECLINED. Terminal; no input or grant is issued.", "parameters": [ { "in": "header", "name": "OWP-Profile", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Instance-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Agent-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Session-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Timestamp", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Request-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Signature", "required": true, "schema": { "type": "string" }, "description": "Ed25519 signature of the exact nine-line frame documented in PROTOCOL.md. No trailing LF." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/JobRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/JobSnapshot" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "401": { "description": "AUTH_REQUIRED, INVALID_SIGNATURE, CLOCK_SKEW, UNKNOWN_SESSION, SESSION_EXPIRED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "403": { "description": "FORBIDDEN, GRANT_REQUIRED, GRANT_REVOKED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "404": { "description": "NOT_FOUND", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "405": { "description": "METHOD_NOT_ALLOWED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "409": { "description": "INSTANCE_CHANGED, IDEMPOTENCY_CONFLICT, REGISTRATION_EXISTS, INVALID_STATE, DEADLINE_EXCEEDED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "422": { "description": "UNSUPPORTED_CAPABILITY, INVALID_OUTPUT", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "429": { "description": "CAPACITY_REACHED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "500": { "description": "INTERNAL_ERROR", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/grant": { "post": { "operationId": "Requestfixtureaccess", "summary": "Request fixture access", "description": "ACCEPTED, fixed scope and synthetic consent only. One grant; another new request ID returns INVALID_STATE.", "parameters": [ { "in": "header", "name": "OWP-Profile", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Instance-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Agent-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Session-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Timestamp", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Request-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Signature", "required": true, "schema": { "type": "string" }, "description": "Ed25519 signature of the exact nine-line frame documented in PROTOCOL.md. No trailing LF." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/GrantRequest" } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/GrantReceipt" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "401": { "description": "AUTH_REQUIRED, INVALID_SIGNATURE, CLOCK_SKEW, UNKNOWN_SESSION, SESSION_EXPIRED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "403": { "description": "FORBIDDEN, GRANT_REQUIRED, GRANT_REVOKED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "404": { "description": "NOT_FOUND", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "405": { "description": "METHOD_NOT_ALLOWED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "409": { "description": "INSTANCE_CHANGED, IDEMPOTENCY_CONFLICT, REGISTRATION_EXISTS, INVALID_STATE, DEADLINE_EXCEEDED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "422": { "description": "UNSUPPORTED_CAPABILITY, INVALID_OUTPUT", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "429": { "description": "CAPACITY_REACHED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "500": { "description": "INTERNAL_ERROR", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/input": { "post": { "operationId": "Readfixture", "summary": "Read fixture", "description": "ACTIVE owned grant; ACCEPTED → RUNNING. Repeated reads while RUNNING return the same fixture.", "parameters": [ { "in": "header", "name": "OWP-Profile", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Instance-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Agent-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Session-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Timestamp", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Request-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Signature", "required": true, "schema": { "type": "string" }, "description": "Ed25519 signature of the exact nine-line frame documented in PROTOCOL.md. No trailing LF." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/InputRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/FixtureInput" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "401": { "description": "AUTH_REQUIRED, INVALID_SIGNATURE, CLOCK_SKEW, UNKNOWN_SESSION, SESSION_EXPIRED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "403": { "description": "FORBIDDEN, GRANT_REQUIRED, GRANT_REVOKED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "404": { "description": "NOT_FOUND", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "405": { "description": "METHOD_NOT_ALLOWED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "409": { "description": "INSTANCE_CHANGED, IDEMPOTENCY_CONFLICT, REGISTRATION_EXISTS, INVALID_STATE, DEADLINE_EXCEEDED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "422": { "description": "UNSUPPORTED_CAPABILITY, INVALID_OUTPUT", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "429": { "description": "CAPACITY_REACHED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "500": { "description": "INTERNAL_ERROR", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/output": { "post": { "operationId": "Submitoutput", "summary": "Submit output", "description": "RUNNING → SCORED; validate Summary, record output, score and revoke grant in one synchronous transition.", "parameters": [ { "in": "header", "name": "OWP-Profile", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Instance-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Agent-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Session-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Timestamp", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Request-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Signature", "required": true, "schema": { "type": "string" }, "description": "Ed25519 signature of the exact nine-line frame documented in PROTOCOL.md. No trailing LF." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/OutputRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/CompletionResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "401": { "description": "AUTH_REQUIRED, INVALID_SIGNATURE, CLOCK_SKEW, UNKNOWN_SESSION, SESSION_EXPIRED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "403": { "description": "FORBIDDEN, GRANT_REQUIRED, GRANT_REVOKED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "404": { "description": "NOT_FOUND", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "405": { "description": "METHOD_NOT_ALLOWED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "409": { "description": "INSTANCE_CHANGED, IDEMPOTENCY_CONFLICT, REGISTRATION_EXISTS, INVALID_STATE, DEADLINE_EXCEEDED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "422": { "description": "UNSUPPORTED_CAPABILITY, INVALID_OUTPUT", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "429": { "description": "CAPACITY_REACHED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "500": { "description": "INTERNAL_ERROR", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/fail": { "post": { "operationId": "Reportfailure", "summary": "Report failure", "description": "ACCEPTED or RUNNING → FAILED; revoke any grant.", "parameters": [ { "in": "header", "name": "OWP-Profile", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Instance-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Agent-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Session-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Timestamp", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Request-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Signature", "required": true, "schema": { "type": "string" }, "description": "Ed25519 signature of the exact nine-line frame documented in PROTOCOL.md. No trailing LF." } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/FailureRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/CompletionResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "401": { "description": "AUTH_REQUIRED, INVALID_SIGNATURE, CLOCK_SKEW, UNKNOWN_SESSION, SESSION_EXPIRED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "403": { "description": "FORBIDDEN, GRANT_REQUIRED, GRANT_REVOKED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "404": { "description": "NOT_FOUND", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "405": { "description": "METHOD_NOT_ALLOWED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "409": { "description": "INSTANCE_CHANGED, IDEMPOTENCY_CONFLICT, REGISTRATION_EXISTS, INVALID_STATE, DEADLINE_EXCEEDED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "422": { "description": "UNSUPPORTED_CAPABILITY, INVALID_OUTPUT", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "429": { "description": "CAPACITY_REACHED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "500": { "description": "INTERNAL_ERROR", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/events": { "get": { "operationId": "Pollevents", "summary": "Poll events", "description": "Optional ?after=N, default 0. Nonnegative decimal integer ≤ current cursor. Sign the exact path including query.", "parameters": [ { "in": "header", "name": "OWP-Profile", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Instance-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Agent-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Session-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Timestamp", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Request-Id", "required": true, "schema": { "type": "string" } }, { "in": "header", "name": "OWP-Signature", "required": true, "schema": { "type": "string" }, "description": "Ed25519 signature of the exact nine-line frame documented in PROTOCOL.md. No trailing LF." }, { "in": "query", "name": "after", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "Session-local event cursor; must not exceed the current cursor." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/EventsResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "401": { "description": "AUTH_REQUIRED, INVALID_SIGNATURE, CLOCK_SKEW, UNKNOWN_SESSION, SESSION_EXPIRED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "403": { "description": "FORBIDDEN, GRANT_REQUIRED, GRANT_REVOKED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "404": { "description": "NOT_FOUND", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "405": { "description": "METHOD_NOT_ALLOWED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "409": { "description": "INSTANCE_CHANGED, IDEMPOTENCY_CONFLICT, REGISTRATION_EXISTS, INVALID_STATE, DEADLINE_EXCEEDED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "413": { "description": "PAYLOAD_TOO_LARGE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "422": { "description": "UNSUPPORTED_CAPABILITY, INVALID_OUTPUT", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "429": { "description": "CAPACITY_REACHED", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } }, "500": { "description": "INTERNAL_ERROR", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } } } }