{ "openapi": "3.1.0", "info": { "title": "Operlance API", "version": "1.0.0-rc.9", "description": "Generowane z docs/KONTRAKT.md §9, docs/KONTRAKT-API.md §6, docs/CODES.md i schematów zod @operlance/core przez scripts/gen-openapi.mjs. Nie edytować ręcznie. Kwoty: minor units + currency; każda odpowiedź w kopercie {data, coverage, provenance_summary, fx, request_id}; zapisy wymagają Idempotency-Key i (agent) reason." }, "servers": [ { "url": "https://api-production-3516.up.railway.app", "description": "staging" }, { "url": "https://api.operlance.app", "description": "prod (docelowo, PRODUCTION.md)" } ], "tags": [ { "name": "stable" }, { "name": "experimental" }, { "name": "owner" }, { "name": "owner-and-agent" }, { "name": "public" } ], "paths": { "/v1/me": { "get": { "operationId": "getMe", "summary": "GET /v1/me", "description": "PATCH tylko Owner: {name?, timezone?, base_currency?, locale?}, §14.5 [stable]", "tags": [ "stable", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchMe", "summary": "PATCH /v1/me", "description": "PATCH tylko Owner: {name?, timezone?, base_currency?, locale?}, §14.5 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateMeInput" } } } } } }, "/v1/fx/rates": { "get": { "operationId": "getFxRates", "summary": "GET /v1/fx/rates", "description": "kursy użyte przez system; Owner i agenci z `finances:observe` [stable]", "tags": [ "stable", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/businesses": { "get": { "operationId": "getBusinesses", "summary": "GET /v1/businesses", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postBusinesses", "summary": "POST /v1/businesses", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateBusinessInput" } } } } } }, "/v1/businesses/{id}": { "get": { "operationId": "getBusinessesId", "summary": "GET /v1/businesses/:id", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchBusinessesId", "summary": "PATCH /v1/businesses/:id", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateBusinessInput" } } } } } }, "/v1/businesses/{id}/projects": { "get": { "operationId": "getBusinessesIdProjects", "summary": "GET /v1/businesses/:id/projects", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postBusinessesIdProjects", "summary": "POST /v1/businesses/:id/projects", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateProjectInput" } } } } } }, "/v1/projects/{id}": { "get": { "operationId": "getProjectsId", "summary": "GET /v1/projects/:id", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchProjectsId", "summary": "PATCH /v1/projects/:id", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateProjectInput" } } } } } }, "/v1/businesses/{id}/financial-summary": { "get": { "operationId": "getBusinessesIdFinancialSummary", "summary": "GET /v1/businesses/:id/financial-summary", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/businesses/{id}/subscriptions": { "get": { "operationId": "getBusinessesIdSubscriptions", "summary": "GET /v1/businesses/:id/subscriptions", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/businesses/{id}/forecast": { "get": { "operationId": "getBusinessesIdForecast", "summary": "GET /v1/businesses/:id/forecast", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/businesses/{id}/ads": { "get": { "operationId": "getBusinessesIdAds", "summary": "GET /v1/businesses/:id/ads", "description": "owner-level: ten sam kształt + `business_id` na każdym account [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/ads": { "get": { "operationId": "getAds", "summary": "GET /v1/ads", "description": "owner-level: ten sam kształt + `business_id` na każdym account [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/businesses/{id}/project-health": { "get": { "operationId": "getBusinessesIdProjectHealth", "summary": "GET /v1/businesses/:id/project-health", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/businesses/{id}/saas-metrics": { "get": { "operationId": "getBusinessesIdSaasMetrics", "summary": "GET /v1/businesses/:id/saas-metrics", "description": "1.0.0-rc.3: SaasMetrics z `subscription_change` klientów; Backend B7-23; scope finances:observe [stable]", "tags": [ "stable", "owner-and-agent" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] }, { "agentToken": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/businesses/{id}/context": { "get": { "operationId": "getBusinessesIdContext", "summary": "GET /v1/businesses/:id/context", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/personal/financial-summary": { "get": { "operationId": "getPersonalFinancialSummary", "summary": "GET /v1/personal/financial-summary", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/personal/forecast": { "get": { "operationId": "getPersonalForecast", "summary": "GET /v1/personal/forecast", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/personal/subscriptions": { "get": { "operationId": "getPersonalSubscriptions", "summary": "GET /v1/personal/subscriptions", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/overview": { "get": { "operationId": "getOverview", "summary": "GET /v1/overview", "description": "metryki top-level, upcoming, alerty [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/free-capital": { "get": { "operationId": "getFreeCapital", "summary": "GET /v1/free-capital", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/forecast": { "get": { "operationId": "getForecast", "summary": "GET /v1/forecast", "description": "cały owner [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/coverage": { "get": { "operationId": "getCoverage", "summary": "GET /v1/coverage", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/daily-brief": { "get": { "operationId": "getDailyBrief", "summary": "GET /v1/daily-brief", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/events": { "get": { "operationId": "getEvents", "summary": "GET /v1/events", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/events/{id}": { "get": { "operationId": "getEventsId", "summary": "GET /v1/events/:id", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/expenses": { "post": { "operationId": "postExpenses", "summary": "POST /v1/expenses", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateExpenseInput" } } } } } }, "/v1/recurring-expenses": { "post": { "operationId": "postRecurringExpenses", "summary": "POST /v1/recurring-expenses", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateRecurringExpenseInput" } } } } } }, "/v1/planned-expenses": { "post": { "operationId": "postPlannedExpenses", "summary": "POST /v1/planned-expenses", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreatePlannedExpenseInput" } } } } } }, "/v1/revenues": { "post": { "operationId": "postRevenues", "summary": "POST /v1/revenues", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateRevenueInput" } } } } } }, "/v1/subscriptions": { "get": { "operationId": "getSubscriptions", "summary": "GET /v1/subscriptions", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postSubscriptions", "summary": "POST /v1/subscriptions", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSubscriptionInput" } } } } } }, "/v1/subscriptions/{id}": { "get": { "operationId": "getSubscriptionsId", "summary": "GET /v1/subscriptions/:id", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchSubscriptionsId", "summary": "PATCH /v1/subscriptions/:id", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateSubscriptionInput" } } } } } }, "/v1/subscriptions/{id}/allocations": { "put": { "operationId": "putSubscriptionsIdAllocations", "summary": "PUT /v1/subscriptions/:id/allocations", "description": "pełna lista, Σ=10000 bps [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PutAllocationsInput" } } } } } }, "/v1/subscriptions/{id}/capacity": { "get": { "operationId": "getSubscriptionsIdCapacity", "summary": "GET /v1/subscriptions/:id/capacity", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "putSubscriptionsIdCapacity", "summary": "PUT /v1/subscriptions/:id/capacity", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PutCapacityInput" } } } } } }, "/v1/budget-reservations": { "get": { "operationId": "getBudgetReservations", "summary": "GET /v1/budget-reservations", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postBudgetReservations", "summary": "POST /v1/budget-reservations", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateReservationInput" } } } } } }, "/v1/budget-reservations/{id}/release": { "post": { "operationId": "postBudgetReservationsIdRelease", "summary": "POST /v1/budget-reservations/:id/release", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReleaseReservationInput" } } } } } }, "/v1/cash-snapshots": { "post": { "operationId": "postCashSnapshots", "summary": "POST /v1/cash-snapshots", "description": "Owner; 0.7.1: także z integracji przez `EventSink.snapshot`, patrz §9 „Salda bankowe\" [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCashSnapshotInput" } } } } } }, "/v1/agents/economics": { "get": { "operationId": "getAgentsEconomics", "summary": "GET /v1/agents/economics", "description": "0.7.1, spec §32: Owner wszystkie, agent własne [experimental]", "tags": [ "experimental", "owner-and-agent" ], "parameters": [], "security": [ { "ownerSession": [] }, { "agentToken": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/agents/{id}/economics": { "get": { "operationId": "getAgentsIdEconomics", "summary": "GET /v1/agents/:id/economics", "description": "0.7.1, spec §32: Owner wszystkie, agent własne [experimental]", "tags": [ "experimental", "owner-and-agent" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] }, { "agentToken": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/agents/me/economics": { "get": { "operationId": "getAgentsMeEconomics", "summary": "GET /v1/agents/me/economics", "description": "0.7.1, spec §32: Owner wszystkie, agent własne [experimental]", "tags": [ "experimental", "owner-and-agent" ], "parameters": [], "security": [ { "ownerSession": [] }, { "agentToken": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/agents": { "get": { "operationId": "getAgents", "summary": "GET /v1/agents", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postAgents", "summary": "POST /v1/agents", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/agents/{id}": { "get": { "operationId": "getAgentsId", "summary": "GET /v1/agents/:id", "description": "KONTRAKT §9 [experimental]", "tags": [ "experimental", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchAgentsId", "summary": "PATCH /v1/agents/:id", "description": "KONTRAKT §9 [experimental]", "tags": [ "experimental", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/agents/{id}/rotate-token": { "post": { "operationId": "postAgentsIdRotateToken", "summary": "POST /v1/agents/:id/rotate-token", "description": "KONTRAKT §9 [experimental]", "tags": [ "experimental", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/agents/{id}/revoke": { "post": { "operationId": "postAgentsIdRevoke", "summary": "POST /v1/agents/:id/revoke", "description": "KONTRAKT §9 [experimental]", "tags": [ "experimental", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/agents/{id}/passport": { "get": { "operationId": "getAgentsIdPassport", "summary": "GET /v1/agents/:id/passport", "description": "KONTRAKT §9 [experimental]", "tags": [ "experimental", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "put": { "operationId": "putAgentsIdPassport", "summary": "PUT /v1/agents/:id/passport", "description": "KONTRAKT §9 [experimental]", "tags": [ "experimental", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/approvals": { "get": { "operationId": "getApprovals", "summary": "GET /v1/approvals", "description": "tylko Owner; approve body: {decision_note?, params_override?}; `?kind=request|write` na liście [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/approvals/{id}": { "get": { "operationId": "getApprovalsId", "summary": "GET /v1/approvals/:id", "description": "tylko Owner; approve body: {decision_note?, params_override?}; `?kind=request|write` na liście [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/approvals/{id}/approve": { "post": { "operationId": "postApprovalsIdApprove", "summary": "POST /v1/approvals/:id/approve", "description": "tylko Owner; approve body: {decision_note?, params_override?}; `?kind=request|write` na liście [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/approvals/{id}/reject": { "post": { "operationId": "postApprovalsIdReject", "summary": "POST /v1/approvals/:id/reject", "description": "tylko Owner; approve body: {decision_note?, params_override?}; `?kind=request|write` na liście [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/approvals/{id}/dismiss": { "post": { "operationId": "postApprovalsIdDismiss", "summary": "POST /v1/approvals/:id/dismiss", "description": "tylko Owner; approve body: {decision_note?, params_override?}; `?kind=request|write` na liście [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/agent-decisions": { "post": { "operationId": "postAgentDecisions", "summary": "POST /v1/agent-decisions", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/ad-budget-changes": { "post": { "operationId": "postAdBudgetChanges", "summary": "POST /v1/ad-budget-changes", "description": "= propose_ad_budget_change; scope `ads`, min. `recommend`; przy `execute` w limitach: zapis planu + Approval auto-approved z `approval_id` w `limit_checked` [stable]", "tags": [ "stable", "owner-and-agent" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] }, { "agentToken": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAdBudgetChangeInput" } } } } } }, "/v1/goals": { "get": { "operationId": "getGoals", "summary": "GET /v1/goals", "description": "MVP: zawsze `[]` [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postGoals", "summary": "POST /v1/goals", "description": "§2.17-2.18 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/permission-requests": { "post": { "operationId": "postPermissionRequests", "summary": "POST /v1/permission-requests", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/audit": { "get": { "operationId": "getAudit", "summary": "GET /v1/audit", "description": "KONTRAKT §9 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/integrations": { "get": { "operationId": "getIntegrations", "summary": "GET /v1/integrations", "description": "bez auth, 0.8.1 [stable]", "tags": [ "stable", "public" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/integrations/{provider}/connect": { "post": { "operationId": "postIntegrationsProviderConnect", "summary": "POST /v1/integrations/:provider/connect", "description": "bez auth, 0.8.1 [stable]", "tags": [ "stable", "public" ], "parameters": [ { "name": "provider", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/integrations/{provider}/sync": { "post": { "operationId": "postIntegrationsProviderSync", "summary": "POST /v1/integrations/:provider/sync", "description": "bez auth, 0.8.1 [stable]", "tags": [ "stable", "public" ], "parameters": [ { "name": "provider", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/integrations/catalog": { "get": { "operationId": "getIntegrationsCatalog", "summary": "GET /v1/integrations/catalog", "description": "bez auth, 0.8.1 [stable]", "tags": [ "stable", "public" ], "parameters": [], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/public/integrations": { "get": { "operationId": "getPublicIntegrations", "summary": "GET /v1/public/integrations", "description": "bez auth, 0.8.1 [stable]", "tags": [ "stable", "public" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/webhooks/{provider}": { "post": { "operationId": "postWebhooksProvider", "summary": "POST /v1/webhooks/:provider", "description": "podpis weryfikowany; bez Idempotency-Key, dedup po external_id; provider ∈ stripe (Stripe-Signature) | meta_ads (X-Hub-Signature-256) | google_ads (relay HMAC) | paddle (Paddle-Signature) | lemonsqueezy (X-Signature, HMAC-SHA256) [stable]", "tags": [ "stable", "public" ], "parameters": [ { "name": "provider", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/webhooks/generic/{integration_id}": { "post": { "operationId": "postWebhooksGenericIntegration_id", "summary": "POST /v1/webhooks/generic/:integration_id", "description": "1.0.0-rc.8, R-129; PUBLICZNY co do Bearer, autoryzacja przez podpis: `X-Operlance-Signature: sha256=` + `X-Operlance-Timestamp` (tolerancja 5 min, jak Google Ads relay); `integration_id` = integracja `provider=\"generic\"` utworzona przez Ownera (`POST /v1/integrations/generic/connect` → `{integration_id, secret}`, sekret pokazany raz, przechowywany jak inne `credentials_enc`, §2.20); body `{ events?: NormalizedEvent[], signals?: IntegrationSignal[] }` (co najmniej jedno niepuste, oba zod z core, max 500 elementów łącznie); trafia przez `EventSink.ingest`/`.signal` jak każdy adapter, z wymuszonym `source.type=IMPORT` i `source.integration_id=:integration_id` niezależnie od tego, co przyśle klient; odpowiedź jak `ingest`/`signal` połączona: `{ inserted, deduped, rejected[], signals_accepted, signals_deduped }`; zły podpis lub nieznane `integration_id` → 401, bez zapisu [stable]", "tags": [ "stable", "public" ], "parameters": [ { "name": "integration_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/integrations/generic/connect`": { "post": { "operationId": "postIntegrationsGenericConnect`", "summary": "POST /v1/integrations/generic/connect`", "description": "1.0.0-rc.8, R-129; PUBLICZNY co do Bearer, autoryzacja przez podpis: `X-Operlance-Signature: sha256=` + `X-Operlance-Timestamp` (tolerancja 5 min, jak Google Ads relay); `integration_id` = integracja `provider=\"generic\"` utworzona przez Ownera (`POST /v1/integrations/generic/connect` → `{integration_id, secret}`, sekret pokazany raz, przechowywany jak inne `credentials_enc`, §2.20); body `{ events?: NormalizedEvent[], signals?: IntegrationSignal[] }` (co najmniej jedno niepuste, oba zod z core, max 500 elementów łącznie); trafia przez `EventSink.ingest`/`.signal` jak każdy adapter, z wymuszonym `source.type=IMPORT` i `source.integration_id=:integration_id` niezależnie od tego, co przyśle klient; odpowiedź jak `ingest`/`signal` połączona: `{ inserted, deduped, rejected[], signals_accepted, signals_deduped }`; zły podpis lub nieznane `integration_id` → 401, bez zapisu [stable]", "tags": [ "stable", "public" ], "parameters": [], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/waitlist": { "post": { "operationId": "postWaitlist", "summary": "POST /v1/waitlist", "description": "PUBLICZNY, patrz „Waitlist\" [stable]", "tags": [ "stable", "public" ], "parameters": [], "security": [], "responses": { "202": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } }, "get": { "operationId": "getWaitlist", "summary": "GET /v1/waitlist", "description": "tylko Owner; paginacja jak wszędzie, csv = całość [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/notifications": { "get": { "operationId": "getNotifications", "summary": "GET /v1/notifications", "description": "Owner; §2.15 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/notifications/{id}": { "patch": { "operationId": "patchNotificationsId", "summary": "PATCH /v1/notifications/:id", "description": "Owner; §2.15 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/notifications/read-all": { "post": { "operationId": "postNotificationsReadAll", "summary": "POST /v1/notifications/read-all", "description": "Owner; §2.15 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/me/notification-preferences": { "get": { "operationId": "getMeNotificationPreferences", "summary": "GET /v1/me/notification-preferences", "description": "Owner; §2.15 [stable]", "tags": [ "stable", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchMeNotificationPreferences", "summary": "PATCH /v1/me/notification-preferences", "description": "Owner; §2.15 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/me/notification-webhook": { "put": { "operationId": "putMeNotificationWebhook", "summary": "PUT /v1/me/notification-webhook", "description": "Owner; §2.15 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/plan": { "get": { "operationId": "getPlan", "summary": "GET /v1/plan", "description": "Owner; §2.16; checkout/webhook billing, miejsce, bez implementacji [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/DisplayCurrency" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "post": { "operationId": "postPlan", "summary": "POST /v1/plan", "description": "Owner; §2.16; checkout/webhook billing, miejsce, bez implementacji [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/plan/upgrade-preview": { "get": { "operationId": "getPlanUpgradePreview", "summary": "GET /v1/plan/upgrade-preview", "description": "Owner; §2.16; checkout/webhook billing, miejsce, bez implementacji [stable]", "tags": [ "stable", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/goals/{id}": { "get": { "operationId": "getGoalsId", "summary": "GET /v1/goals/:id", "description": "§2.17-2.18 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/Limit" }, { "$ref": "#/components/parameters/Cursor" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "patch": { "operationId": "patchGoalsId", "summary": "PATCH /v1/goals/:id", "description": "§2.17-2.18 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } }, "delete": { "operationId": "deleteGoalsId", "summary": "DELETE /v1/goals/:id", "description": "§2.17-2.18 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/goal-proposals": { "post": { "operationId": "postGoalProposals", "summary": "POST /v1/goal-proposals", "description": "§2.17-2.18 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/decision-outcomes": { "get": { "operationId": "getDecisionOutcomes", "summary": "GET /v1/decision-outcomes", "description": "§2.17-2.18 [stable]", "tags": [ "stable", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/agents/me": { "get": { "operationId": "getAgentsMe", "summary": "GET /v1/agents/me", "description": "0.6.1; §2.7-2.8 [experimental]", "tags": [ "experimental", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/passport-templates": { "get": { "operationId": "getPassportTemplates", "summary": "GET /v1/passport-templates", "description": "0.6.1; §2.7-2.8 [stable]", "tags": [ "stable", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/agents/{id}/passport/from-template": { "post": { "operationId": "postAgentsIdPassportFromTemplate", "summary": "POST /v1/agents/:id/passport/from-template", "description": "0.6.1; §2.7-2.8 [experimental]", "tags": [ "experimental", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/simulations": { "post": { "operationId": "postSimulations", "summary": "POST /v1/simulations", "description": "0.7.0; bez Idempotency-Key, `finances:observe`+`forecast:observe`; body = SimulationInput; koperta z coverage [experimental]", "tags": [ "experimental", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/data-requests": { "post": { "operationId": "postDataRequests", "summary": "POST /v1/data-requests", "description": "0.7.0; agent; → Approval 202, action connect_integration|provide_data [experimental]", "tags": [ "experimental", "owner-and-agent" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] }, { "agentToken": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/decisions/{id}/review": { "get": { "operationId": "getDecisionsIdReview", "summary": "GET /v1/decisions/:id/review", "description": "0.7.0; DecisionOutcome; Owner i agent-autor [experimental]", "tags": [ "experimental", "owner-and-agent" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] }, { "agentToken": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/imports": { "post": { "operationId": "postImports", "summary": "POST /v1/imports", "description": "0.6.1; §9 „Importy\" [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/imports/{id}": { "get": { "operationId": "getImportsId", "summary": "GET /v1/imports/:id", "description": "0.6.1; §9 „Importy\" [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/imports/{id}/confirm": { "post": { "operationId": "postImportsIdConfirm", "summary": "POST /v1/imports/:id/confirm", "description": "0.6.1; §9 „Importy\" [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "201": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/imports/presets": { "get": { "operationId": "getImportsPresets", "summary": "GET /v1/imports/presets", "description": "0.6.1; §9 „Importy\" [stable]", "tags": [ "stable", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/integrations/google_ads/callback": { "get": { "operationId": "getIntegrationsGoogle_adsCallback", "summary": "GET /v1/integrations/google_ads/callback", "description": "0.6.1; OAuth redirect; bez Bearer, state podpisany HMAC, 302 do panelu [experimental]", "tags": [ "experimental", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/auth/magic-link": { "post": { "operationId": "postAuthMagicLink", "summary": "POST /v1/auth/magic-link", "description": "§2.19; magic-link PUBLICZNY [stable]", "tags": [ "stable", "public" ], "parameters": [], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/auth/verify": { "post": { "operationId": "postAuthVerify", "summary": "POST /v1/auth/verify", "description": "§2.19; magic-link PUBLICZNY [stable]", "tags": [ "stable", "public" ], "parameters": [], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/auth/logout": { "post": { "operationId": "postAuthLogout", "summary": "POST /v1/auth/logout", "description": "§2.19; magic-link PUBLICZNY [stable]", "tags": [ "stable", "public" ], "parameters": [], "security": [], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/me/sessions": { "get": { "operationId": "getMeSessions", "summary": "GET /v1/me/sessions", "description": "Owner; §2.19 [stable]", "tags": [ "stable", "owner" ], "parameters": [], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } } }, "/v1/me/sessions/{id}/revoke": { "post": { "operationId": "postMeSessionsIdRevoke", "summary": "POST /v1/me/sessions/:id/revoke", "description": "Owner; §2.19 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } }, "/v1/me/sessions/revoke-others": { "post": { "operationId": "postMeSessionsRevokeOthers", "summary": "POST /v1/me/sessions/revoke-others", "description": "Owner; §2.19 [stable]", "tags": [ "stable", "owner" ], "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "security": [ { "ownerSession": [] } ], "responses": { "200": { "description": "OK (koperta KONTRAKT-API §1)", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-Operlance-Contract": { "$ref": "#/components/headers/X-Operlance-Contract" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "202": { "description": "Approval utworzony (poziom recommend lub ponad limit per akcja): { approval: {id, status: pending} }", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Envelope" } } } }, "400": { "description": "validation_error, missing_idempotency_key, missing_reason", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "401": { "description": "unauthenticated, token_revoked, token_expired, session_expired, session_revoked, login_token_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "403": { "description": "scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "404": { "description": "not_found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "409": { "description": "idempotency_conflict, state_conflict", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "413": { "description": "payload_too_large", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "415": { "description": "unsupported_media_type", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "422": { "description": "allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "426": { "description": "contract_too_old", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "429": { "description": "rate_limited", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "500": { "description": "internal_error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } }, "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "description": "kształt w KONTRAKT §9/§11 (brak schematu zod w core dla tej trasy)" } } } } } } }, "components": { "schemas": { "CreateBusinessInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "stage": { "type": "string", "enum": [ "development", "pre_launch", "live", "profitable" ] } }, "required": [ "name" ] }, "UpdateBusinessInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "status": { "type": "string", "enum": [ "active", "archived" ] }, "stage": { "type": "string", "enum": [ "development", "pre_launch", "live", "profitable" ] }, "limits": { "type": "object", "properties": { "max_experimental_budget": { "anyOf": [ { "type": "object", "properties": { "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount_minor", "currency" ], "additionalProperties": false }, { "type": "null" } ] }, "max_days_without_revenue": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "expected_break_even_on": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "min_target_revenue_monthly": { "anyOf": [ { "type": "object", "properties": { "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount_minor", "currency" ], "additionalProperties": false }, { "type": "null" } ] }, "max_cac": { "anyOf": [ { "type": "object", "properties": { "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount_minor", "currency" ], "additionalProperties": false }, { "type": "null" } ] } }, "additionalProperties": false } }, "additionalProperties": false }, "CreateProjectInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "slug": { "type": "string", "pattern": "^[a-z0-9-]+$" } }, "required": [ "name" ] }, "UpdateProjectInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "status": { "type": "string", "enum": [ "active", "archived" ] }, "limits": { "type": "object", "properties": { "max_experimental_budget": { "anyOf": [ { "type": "object", "properties": { "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount_minor", "currency" ], "additionalProperties": false }, { "type": "null" } ] }, "max_days_without_revenue": { "anyOf": [ { "type": "integer", "minimum": 0 }, { "type": "null" } ] }, "expected_break_even_on": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "min_target_revenue_monthly": { "anyOf": [ { "type": "object", "properties": { "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount_minor", "currency" ], "additionalProperties": false }, { "type": "null" } ] }, "max_cac": { "anyOf": [ { "type": "object", "properties": { "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount_minor", "currency" ], "additionalProperties": false }, { "type": "null" } ] } }, "additionalProperties": false } }, "additionalProperties": false }, "UpdateMeInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "timezone": { "type": "string", "minLength": 1 }, "base_currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "additionalProperties": false }, "CreateExpenseInput": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "occurred_on": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "category": { "type": "string", "enum": [ "saas", "ads", "infrastructure", "payroll", "fees", "tax", "living", "other", "agent_runtime" ] }, "description": { "type": "string", "minLength": 1 }, "reservation_id": { "type": "string", "format": "uuid" }, "fulfills_event_id": { "type": "string", "format": "uuid" }, "supersedes_event_id": { "type": "string", "format": "uuid" }, "reason": { "type": "string", "minLength": 3 } }, "required": [ "amount_minor", "currency", "occurred_on", "category", "description" ] }, "CreateRevenueInput": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "occurred_on": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "state": { "type": "string", "enum": [ "actual", "planned" ], "default": "actual" }, "category": { "type": "string" }, "description": { "type": "string", "minLength": 1 }, "reason": { "type": "string", "minLength": 3 } }, "required": [ "amount_minor", "currency", "occurred_on", "description" ] }, "CreatePlannedExpenseInput": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "expected_on": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "category": { "type": "string", "enum": [ "saas", "ads", "infrastructure", "payroll", "fees", "tax", "living", "other", "agent_runtime" ] }, "description": { "type": "string", "minLength": 1 }, "reservation_id": { "type": "string", "format": "uuid" }, "reason": { "type": "string", "minLength": 3 } }, "required": [ "amount_minor", "currency", "expected_on", "category", "description" ] }, "CreateRecurringExpenseInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 }, "plan": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "billing_interval": { "type": "string", "enum": [ "weekly", "monthly", "quarterly", "yearly" ] }, "interval_count": { "type": "integer", "minimum": 0, "default": 1 }, "started_on": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "next_charge_on": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "auto_renew": { "type": "boolean", "default": true }, "status": { "type": "string", "enum": [ "active", "trial", "paused", "cancelled" ], "default": "active" }, "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "allocations": { "type": "array", "items": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "method": { "type": "string", "enum": [ "percent", "usage", "seats" ], "default": "percent" }, "share_bps": { "type": "integer", "minimum": 0, "maximum": 10000 } } }, "minItems": 1 }, "capacity": { "type": "array", "items": { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "users", "seats", "social_profiles", "projects", "domains", "servers", "storage_gb", "api_credits", "token_limit", "workspaces", "email_accounts", "automation_runs" ] }, "total": { "type": "integer", "minimum": 0 }, "usages": { "type": "array", "items": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "used": { "type": "integer", "minimum": 0 } }, "required": [ "used" ] }, "default": [] } }, "required": [ "unit", "total" ] } }, "charged_on": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "reason": { "type": "string", "minLength": 3 } }, "required": [ "name", "vendor", "amount_minor", "currency", "billing_interval", "next_charge_on" ] }, "CreateSubscriptionInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 }, "plan": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "billing_interval": { "type": "string", "enum": [ "weekly", "monthly", "quarterly", "yearly" ] }, "interval_count": { "type": "integer", "minimum": 0, "default": 1 }, "started_on": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "next_charge_on": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "auto_renew": { "type": "boolean", "default": true }, "status": { "type": "string", "enum": [ "active", "trial", "paused", "cancelled" ], "default": "active" }, "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "allocations": { "type": "array", "items": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "method": { "type": "string", "enum": [ "percent", "usage", "seats" ], "default": "percent" }, "share_bps": { "type": "integer", "minimum": 0, "maximum": 10000 } } }, "minItems": 1 }, "capacity": { "type": "array", "items": { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "users", "seats", "social_profiles", "projects", "domains", "servers", "storage_gb", "api_credits", "token_limit", "workspaces", "email_accounts", "automation_runs" ] }, "total": { "type": "integer", "minimum": 0 }, "usages": { "type": "array", "items": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "used": { "type": "integer", "minimum": 0 } }, "required": [ "used" ] }, "default": [] } }, "required": [ "unit", "total" ] } }, "reason": { "type": "string", "minLength": 3 } }, "required": [ "name", "vendor", "amount_minor", "currency", "billing_interval", "next_charge_on" ] }, "UpdateSubscriptionInput": { "type": "object", "properties": { "name": { "type": "string", "minLength": 1 }, "vendor": { "type": "string", "minLength": 1 }, "plan": { "anyOf": [ { "type": "string" }, { "type": "null" } ] }, "price_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "billing_interval": { "type": "string", "enum": [ "weekly", "monthly", "quarterly", "yearly" ] }, "interval_count": { "type": "integer", "minimum": 0 }, "next_charge_on": { "anyOf": [ { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, { "type": "null" } ] }, "auto_renew": { "type": "boolean" }, "status": { "type": "string", "enum": [ "active", "trial", "paused", "cancelled" ] }, "reason": { "type": "string", "minLength": 3 } }, "additionalProperties": false }, "PutAllocationsInput": { "type": "object", "properties": { "allocations": { "type": "array", "items": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "method": { "type": "string", "enum": [ "percent", "usage", "seats" ], "default": "percent" }, "share_bps": { "type": "integer", "minimum": 0, "maximum": 10000 } } }, "minItems": 1 }, "reason": { "type": "string", "minLength": 3 } }, "required": [ "allocations" ] }, "PutCapacityInput": { "type": "object", "properties": { "capacities": { "type": "array", "items": { "type": "object", "properties": { "unit": { "type": "string", "enum": [ "users", "seats", "social_profiles", "projects", "domains", "servers", "storage_gb", "api_credits", "token_limit", "workspaces", "email_accounts", "automation_runs" ] }, "total": { "type": "integer", "minimum": 0 }, "usages": { "type": "array", "items": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "used": { "type": "integer", "minimum": 0 } }, "required": [ "used" ] }, "default": [] } }, "required": [ "unit", "total" ] } }, "reason": { "type": "string", "minLength": 3 } }, "required": [ "capacities" ] }, "CreateReservationInput": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "project_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "purpose": { "type": "string", "minLength": 1 }, "category": { "type": "string", "enum": [ "saas", "ads", "infrastructure", "payroll", "fees", "tax", "living", "other", "agent_runtime" ] }, "period_start": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "period_end": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "platform": { "type": "string", "enum": [ "google_ads", "meta_ads", "stripe", "other" ] }, "reason": { "type": "string", "minLength": 3 } }, "required": [ "amount_minor", "currency", "purpose", "category", "period_start", "period_end" ] }, "ReleaseReservationInput": { "type": "object", "properties": { "reason": { "type": "string", "minLength": 3 } }, "default": {} }, "CreateCashSnapshotInput": { "type": "object", "properties": { "business_id": { "anyOf": [ { "type": "string", "format": "uuid" }, { "type": "null" } ] }, "personal": { "type": "boolean" }, "amount_minor": { "type": "integer" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" }, "as_of": { "type": "string", "format": "date-time" }, "reason": { "type": "string", "minLength": 3 } }, "required": [ "amount_minor", "currency" ] }, "CreateAdBudgetChangeInput": { "type": "object", "properties": { "business_id": { "type": "string", "format": "uuid" }, "project_id": { "type": "string", "format": "uuid" }, "platform": { "type": "string", "enum": [ "google_ads", "meta_ads" ] }, "campaign_id": { "type": "string", "minLength": 1 }, "current": { "type": "object", "properties": { "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount_minor", "currency" ], "additionalProperties": false }, "proposed": { "type": "object", "properties": { "amount_minor": { "type": "integer", "minimum": 0, "maximum": 9007199254740991 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } }, "required": [ "amount_minor", "currency" ], "additionalProperties": false }, "effective_on": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$" }, "reason": { "type": "string", "minLength": 3 } }, "required": [ "business_id", "platform", "current", "proposed" ] }, "Money": { "type": "object", "required": [ "amount_minor", "currency" ], "properties": { "amount_minor": { "type": "integer", "description": "minor units (grosze/centy), zawsze ≥ 0; kierunek w direction" }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$" } } }, "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "code", "message", "request_id" ], "properties": { "code": { "type": "string", "enum": [ "validation_error", "missing_idempotency_key", "missing_reason", "unauthenticated", "token_revoked", "token_expired", "scope_denied", "limit_exceeded", "agent_suspended", "not_found", "idempotency_conflict", "state_conflict", "allocation_sum_invalid", "capacity_exceeded", "currency_mismatch", "currency_unsupported", "fx_unavailable", "rate_limited", "internal_error", "not_implemented", "plan_limit_exceeded", "trial_expired", "plan_expired", "ip_not_allowed", "signature_invalid", "not_available", "session_expired", "session_revoked", "contract_too_old" ] }, "message": { "type": "string", "description": "diagnostyczne, EN, nie do wyświetlania (KONTRAKT §1 i18n)" }, "details": {}, "request_id": { "type": "string" } } } } }, "Envelope": { "type": "object", "required": [ "data", "request_id" ], "properties": { "data": { "description": "kształt wg KONTRAKT-API (nazwa w description operacji)" }, "coverage": { "$ref": "#/components/schemas/Coverage" }, "provenance_summary": { "type": "object" }, "fx": { "type": "object", "description": "FxSummary (KONTRAKT-API §1)" }, "page": { "type": "object", "properties": { "next_cursor": { "type": [ "string", "null" ] }, "has_more": { "type": "boolean" } } }, "request_id": { "type": "string" } } }, "Coverage": { "type": "object", "properties": { "coverage_pct": { "type": "number", "minimum": 0, "maximum": 1 }, "domains": { "type": "object", "additionalProperties": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "accurate", "mostly_covered", "incomplete", "missing" ] }, "sources": { "type": "array", "items": { "type": "string" } }, "last_sync_at": { "type": [ "string", "null" ] } } } } } } }, "securitySchemes": { "ownerSession": { "type": "http", "scheme": "bearer", "bearerFormat": "ses_… (magic-link session) lub OPERLANCE_OWNER_TOKEN w AUTH_MODE=static", "description": "Owner (KONTRAKT §2.19)" }, "agentToken": { "type": "http", "scheme": "bearer", "bearerFormat": "agt_…", "description": "Agent z Passportem (KONTRAKT §2.7, §10)" } }, "headers": { "X-Request-Id": { "schema": { "type": "string" }, "description": "Identyfikator żądania (w błędach jako error.request_id)" }, "X-Operlance-Contract": { "schema": { "type": "string", "example": "1.0.0-rc.9" }, "description": "Wersja kontraktu (KONTRAKT §9 wersjonowanie)" }, "X-RateLimit-Limit": { "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "schema": { "type": "integer" } }, "Idempotent-Replayed": { "schema": { "type": "boolean" }, "description": "true, gdy odpowiedź odtworzona z Idempotency-Key" } }, "parameters": { "IdempotencyKey": { "name": "Idempotency-Key", "in": "header", "required": true, "schema": { "type": "string", "maxLength": 128 }, "description": "Wymagany na POST/PUT/PATCH/DELETE (KONTRAKT §9); powtórka z tym samym body = ta sama odpowiedź" }, "Limit": { "name": "limit", "in": "query", "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 } }, "Cursor": { "name": "cursor", "in": "query", "schema": { "type": "string" } }, "DisplayCurrency": { "name": "display_currency", "in": "query", "schema": { "type": "string", "pattern": "^[A-Z]{3}$" }, "description": "Przeliczenie agregatu po kursie bieżącym (KONTRAKT §14)" } } } }