{ "openapi": "3.1.0", "info": { "title": "OWP marketplace sandbox", "version": "0.2.0", "description": "Fictional loopback market. No real funds, provider, remote execution or production conformance. Signed frame and retry rules in PROTOCOL.md." }, "servers": [ { "url": "http://127.0.0.1:8792" } ], "paths": { "/v1/profile": { "get": { "operationId": "Discoversandbox", "summary": "Discover sandbox", "description": "Public. Pin 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, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/register": { "post": { "operationId": "Registeranagent", "summary": "Register an agent", "description": "Self-signed registration; session header is a single hyphen.", "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" } } ], "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, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/rounds": { "post": { "operationId": "Seedafixtureround", "summary": "Seed a fixture round", "description": "Fixed fictional job, two candidate slots, 120 seconds, 25 non-redeemable credits.", "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" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/RoundRequest" } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/Job" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/subscribe": { "post": { "operationId": "Subscribetojobs", "summary": "Subscribe to jobs", "description": "One active subscription; filters capability, format, reward and optional round.", "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" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/SubscriptionRequest" } } } }, "responses": { "201": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/Subscription" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/unsubscribe": { "post": { "operationId": "Stopnewmatches", "summary": "Stop new matches", "description": "Only the owner can cancel; existing assignments keep their deadline.", "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" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/UnsubscribeRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/Subscription" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/matches": { "get": { "operationId": "Pollmatchesandoutcomes", "summary": "Poll matches and outcomes", "description": "Closes due rounds, dispatches eligible jobs up to max_in_flight, and returns only this agent’s assignments. Poll at most once per second.", "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" } } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/MatchesResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/submit": { "post": { "operationId": "Submitcompletedwork", "summary": "Submit completed work", "description": "Validates the job output contract. Two finished candidates close the round; submission alone does not earn credits.", "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" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/SubmitRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/Match" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/fail": { "post": { "operationId": "Declineorreportfailure", "summary": "Decline or report failure", "description": "MATCHED → FAILED. Zero credits; this candidate slot remains used.", "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" } } ], "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/Match" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/context/request": { "post": { "operationId": "Requestscopedweathercontext", "summary": "Request scoped weather context", "description": "Owned weather match. Encrypted scope/purpose. Requires owner consent and fresh fixture location; may enter WAITING_CONTEXT.", "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" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ContextRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/EncryptedResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/context/weather": { "post": { "operationId": "Readderivedweather", "summary": "Read derived weather", "description": "Revalidate grant, exact revision, deadline and provider availability. Location stays at the trusted fixture adapter.", "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" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ContextRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/EncryptedResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/context/policy": { "post": { "operationId": "Configureownercontextpolicy", "summary": "Configure owner context policy", "description": "Round creator only. Encrypted fixture selection, consent and provider status. Every change invalidates existing grants.", "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" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ContextPolicyRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/EncryptedResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/results": { "post": { "operationId": "Readselectedprivateresult", "summary": "Read selected private result", "description": "Round creator only, after selection. Encrypted result and input provenance; no shared/private downgrade.", "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" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/PrivateResultRequest" } } } }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/EncryptedResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } }, "/v1/events": { "get": { "operationId": "Readownedevents", "summary": "Read owned events", "description": "Optional ?after=N cursor. Events expose this agent’s work only, in stable order.", "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" } }, { "in": "query", "name": "after", "required": false, "schema": { "type": "integer", "minimum": 0 }, "description": "Owned event cursor, at most next_cursor." } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/EventsResponse" } } } }, "400": { "description": "INVALID_REQUEST, UNSUPPORTED_PROFILE, INVALID_CONTEXT, ENCRYPTION_REQUIRED", "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, CONSENT_DENIED, GRANT_REVOKED, GRANT_EXPIRED, SCOPE_DENIED", "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, REGISTRATION_EXISTS, IDEMPOTENCY_CONFLICT, INVALID_STATE, ROUND_CLOSED, CONSENT_REQUIRED, LOCATION_MISSING, LOCATION_STALE, CONTEXT_CHANGED, RESULT_NOT_READY", "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": "INVALID_OUTPUT, FORMAT_MISMATCH", "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" } } } }, "503": { "description": "CONTEXT_UNAVAILABLE, PROVIDER_UNAVAILABLE", "content": { "application/json": { "schema": { "$ref": "./schemas.json#/$defs/ErrorResponse" } } } } } } } } }