{ "openapi": "3.1.0", "info": { "title": "WinLayer Public API", "version": "1.0.0", "description": "Generated v1 contract for API-key authenticated, tenant-scoped WinLayer endpoints." }, "servers": [ { "url": "https://api.winlayer.ai", "description": "Production" }, { "url": "https://7yc4qvwdr2.us-east-1.awsapprunner.com", "description": "AWS dev acceptance" } ], "paths": { "/api/v1/public/actions": { "get": { "operationId": "get_actions", "summary": "List proposed agent actions.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:read", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/actions/{id}/approve": { "post": { "operationId": "post_actions_id_approve", "summary": "Approve and execute one governed action.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 200 } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "actions:write", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/actions/{id}/reject": { "post": { "operationId": "post_actions_id_reject", "summary": "Reject one governed action.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 200 } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "actions:write", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/agencies": { "get": { "operationId": "get_agencies", "summary": "List active agency, office, and program entities.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "q", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListEnvelope" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agencies:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public.controller.ts" } }, "/api/v1/public/agents": { "get": { "operationId": "get_agents", "summary": "List runnable governed agents.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/agents/{agentId}/run": { "post": { "operationId": "post_agents_agentId_run", "summary": "Run a governed agent.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "agentId", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 200 } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:run", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/ask": { "post": { "operationId": "post_ask", "summary": "Ask a grounded workspace question.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:run", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/chat-models": { "get": { "operationId": "get_chat_models", "summary": "List supported chat models.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/contacts": { "get": { "operationId": "get_contacts", "summary": "List tenant-owned relationship contacts.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListEnvelope" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "contacts:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public.controller.ts" } }, "/api/v1/public/daily-briefing": { "get": { "operationId": "get_daily_briefing", "summary": "Read the latest daily briefing.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:read", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" }, "post": { "operationId": "post_daily_briefing", "summary": "Generate the Daily Growth Agent briefing.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:run", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/executive-brief": { "get": { "operationId": "get_executive_brief", "summary": "Read the latest executive brief.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:read", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" }, "post": { "operationId": "post_executive_brief", "summary": "Generate a grounded executive brief.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:run", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/forecasts": { "get": { "operationId": "get_forecasts", "summary": "List published forecast and recompete records.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "stage", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListEnvelope" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "forecasts:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public.controller.ts" } }, "/api/v1/public/graphql": { "post": { "operationId": "post_graphql", "summary": "Execute a bounded GraphQL query with field-level scopes.", "tags": [ "GraphQL" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "dynamic-field-scopes", "x-live-key-only": false, "x-source": "apps/api/src/public/graphql.controller.ts" } }, "/api/v1/public/graphql/schema": { "post": { "operationId": "post_graphql_schema", "summary": "Read the versioned GraphQL SDL.", "tags": [ "GraphQL" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "dynamic-field-scopes", "x-live-key-only": false, "x-source": "apps/api/src/public/graphql.controller.ts" } }, "/api/v1/public/intelligence": { "get": { "operationId": "get_intelligence", "summary": "List published canonical intelligence objects.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "module", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListEnvelope" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "intelligence:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public.controller.ts" } }, "/api/v1/public/logout": { "post": { "operationId": "post_logout", "summary": "Revoke the current CLI session.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "workspace:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/opportunities": { "get": { "operationId": "get_opportunities", "summary": "List canonical, scored opportunities for the API key workspace.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "min", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpportunityListEnvelope" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "opportunities:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public.controller.ts" } }, "/api/v1/public/opportunities/{id}": { "get": { "operationId": "get_opportunities_id", "summary": "Get one canonical OpportunityIntelligence object.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 200 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpportunityIntelligence" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "opportunities:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public.controller.ts" } }, "/api/v1/public/opportunities/{id}/brief": { "get": { "operationId": "get_opportunities_id_brief", "summary": "Read the latest grounded opportunity brief.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 200 } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:read", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" }, "post": { "operationId": "post_opportunities_id_brief", "summary": "Generate a grounded opportunity brief.", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "id", "in": "path", "required": true, "schema": { "type": "string", "maxLength": 200 } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } }, "responses": { "201": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "agents:run", "x-live-key-only": true, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/pipeline": { "get": { "operationId": "get_pipeline", "summary": "List tracked opportunities and pursuit state.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "status", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OpportunityListEnvelope" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "pipeline:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public.controller.ts" } }, "/api/v1/public/relationships": { "get": { "operationId": "get_relationships", "summary": "List current accepted graph relationships.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListEnvelope" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "relationships:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public.controller.ts" } }, "/api/v1/public/signals": { "get": { "operationId": "get_signals", "summary": "List normalized source signals and provenance.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [ { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 200 } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100 } }, { "name": "cursor", "in": "query", "required": false, "schema": { "type": "string", "maxLength": 1024 } } ], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListEnvelope" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "signals:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public.controller.ts" } }, "/api/v1/public/usage": { "get": { "operationId": "get_usage", "summary": "Read plan capacity and customer-visible usage.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "usage:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public-agent.controller.ts" } }, "/api/v1/public/whoami": { "get": { "operationId": "get_whoami", "summary": "Resolve the API key environment and workspace.", "tags": [ "Public API" ], "security": [ { "ApiKeyAuth": [] } ], "parameters": [], "responses": { "200": { "description": "Successful response.", "headers": { "X-RateLimit-Limit": { "schema": { "type": "integer" }, "description": "Per-key fixed-window request limit." }, "X-RateLimit-Remaining": { "schema": { "type": "integer" }, "description": "Requests remaining in the current window." } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiObject" } } } }, "400": { "description": "Invalid request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "401": { "description": "Missing, expired, or invalid API key.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "403": { "description": "The API key lacks the required scope, role, environment, or entitlement.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "404": { "description": "The requested resource was not found in the API key workspace.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } }, "429": { "description": "Rate limit exceeded.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } }, "headers": { "Retry-After": { "schema": { "type": "integer" }, "description": "Seconds before retry." } } }, "500": { "description": "Internal server error with a request ID.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorEnvelope" } } } } }, "x-winlayer-scope": "workspace:read", "x-live-key-only": false, "x-source": "apps/api/src/public/public-agent.controller.ts" } } }, "components": { "securitySchemes": { "ApiKeyAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "wl_live_… or wl_test_…", "description": "Use Authorization: Bearer . x-api-key is retained for compatibility." } }, "schemas": { "ApiObject": { "type": "object", "additionalProperties": true }, "Pagination": { "type": "object", "additionalProperties": false, "required": [ "limit", "hasMore", "nextCursor" ], "properties": { "limit": { "type": "integer", "minimum": 1, "maximum": 100 }, "hasMore": { "type": "boolean" }, "nextCursor": { "type": [ "string", "null" ] } } }, "ErrorEnvelope": { "type": "object", "additionalProperties": true, "required": [ "message", "requestId", "timestamp" ], "properties": { "statusCode": { "type": "integer", "minimum": 400, "maximum": 599 }, "error": { "type": "string" }, "message": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "string" } } ] }, "requestId": { "type": "string" }, "timestamp": { "type": "string", "format": "date-time" } } }, "FieldValue": { "type": "object", "additionalProperties": false, "required": [ "value", "status", "confidence", "asOf", "sourceCount", "sourceIds", "reason" ], "properties": { "value": {}, "status": { "type": "string", "enum": [ "known", "inferred", "predicted", "unknown", "conflicting", "stale", "not_applicable" ] }, "confidence": { "type": "number", "minimum": 0, "maximum": 100 }, "asOf": { "type": [ "string", "null" ], "format": "date-time" }, "sourceCount": { "type": "integer", "minimum": 0 }, "sourceIds": { "type": "array", "items": { "type": "string" } }, "reason": { "type": "string" } } }, "DecisionScore": { "type": "object", "additionalProperties": true, "required": [ "value", "status", "reason", "evidenceSignalIds" ], "properties": { "value": { "type": [ "number", "null" ] }, "status": { "type": "string", "enum": [ "SCORED", "HARD_GATE_FAILED", "INSUFFICIENT_EVIDENCE" ] }, "reason": { "type": "string" }, "evidenceSignalIds": { "type": "array", "items": { "type": "string" } } } }, "DecisionScores": { "type": "object", "additionalProperties": false, "required": [ "companyFit", "eligibility", "strategicAttractiveness", "competitivePosition", "pwin", "evidenceConfidence" ], "properties": { "companyFit": { "$ref": "#/components/schemas/DecisionScore" }, "eligibility": { "$ref": "#/components/schemas/DecisionScore" }, "strategicAttractiveness": { "$ref": "#/components/schemas/DecisionScore" }, "competitivePosition": { "$ref": "#/components/schemas/DecisionScore" }, "pwin": { "$ref": "#/components/schemas/DecisionScore" }, "evidenceConfidence": { "$ref": "#/components/schemas/DecisionScore" } } }, "EpistemicAssertion": { "type": "object", "additionalProperties": false, "required": [ "label", "producer", "sourceIds", "modelVersion", "inputRefs", "reason" ], "properties": { "label": { "type": "string", "enum": [ "Observed", "Derived", "Inferred", "Predicted", "Recommendation", "User-entered" ] }, "producer": { "type": "string" }, "sourceIds": { "type": "array", "items": { "type": "string" } }, "modelVersion": { "type": [ "string", "null" ] }, "inputRefs": { "type": "array", "items": { "type": "string" } }, "reason": { "type": "string" } } }, "OpportunityIntelligence": { "type": "object", "description": "Canonical Layer 3 OpportunityIntelligence contract. Compatibility aliases may be present in addition to these required fields.", "additionalProperties": true, "required": [ "object_type", "contract_version", "identity", "state", "fields", "evidenceSummary", "relevance", "pwin", "pricingContext", "vehiclePrediction", "incumbent", "incumbentVulnerability", "competitivePosition", "decisionScores", "epistemicLabels", "partnerGaps", "dynamicTimeline", "recommendedDecision", "recommendationLineage", "graphHooks", "confidence", "freshness", "sourceCompleteness", "opportunity_id", "opportunity_score", "confidence_score", "urgency_score", "preliminary_pwin", "preliminary_pwin_context", "user_relevance_score", "recommendation_lineage", "evidence_summary", "timeline", "related_opportunities", "pricing_context", "intent_context", "vehicle_prediction", "incumbent_vulnerability", "dynamic_timeline", "predicted_set_aside", "vehicle_access_validation", "agent_triggers", "scoring_metadata", "downstream_graph_hooks", "module_results", "data_completeness", "confidence_adjusted", "confidence_reasoning", "evidence_count", "supporting_sources", "source_system", "source_record_id", "source_url", "collected_at", "last_updated_at", "human_review_required", "review_reason", "readiness_verification", "handoff_ready" ], "properties": { "object_type": { "type": "string" }, "contract_version": { "type": "string" }, "identity": { "type": "object", "additionalProperties": true }, "state": { "type": "object", "additionalProperties": true }, "fields": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/FieldValue" } }, "evidenceSummary": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "relevance": { "type": "object", "additionalProperties": true }, "pwin": { "type": "object", "additionalProperties": true }, "pricingContext": { "type": "object", "additionalProperties": true }, "vehiclePrediction": { "type": "object", "additionalProperties": true }, "incumbent": { "type": "object", "additionalProperties": true }, "incumbentVulnerability": { "type": "object", "additionalProperties": true }, "competitivePosition": { "type": "object", "additionalProperties": true }, "decisionScores": { "$ref": "#/components/schemas/DecisionScores" }, "epistemicLabels": { "type": "object", "additionalProperties": true, "required": [ "fields", "decisionScores", "companyProfile", "predictedSetAside", "vehiclePrediction", "recommendedDecision" ], "properties": { "fields": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/EpistemicAssertion" } }, "decisionScores": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/EpistemicAssertion" } }, "companyProfile": { "$ref": "#/components/schemas/EpistemicAssertion" }, "predictedSetAside": { "$ref": "#/components/schemas/EpistemicAssertion" }, "vehiclePrediction": { "$ref": "#/components/schemas/EpistemicAssertion" }, "recommendedDecision": { "$ref": "#/components/schemas/EpistemicAssertion" } } }, "partnerGaps": { "type": "object", "additionalProperties": true }, "dynamicTimeline": { "type": "object", "additionalProperties": true }, "recommendedDecision": { "type": "object", "additionalProperties": true }, "recommendationLineage": { "type": "object", "additionalProperties": true }, "graphHooks": { "type": "object", "additionalProperties": true }, "confidence": { "type": "object", "additionalProperties": true }, "freshness": { "type": "object", "additionalProperties": true }, "sourceCompleteness": { "type": "array", "items": {} }, "opportunity_id": { "type": "string" }, "opportunity_score": { "type": "number" }, "confidence_score": { "type": "number" }, "urgency_score": { "type": "number" }, "preliminary_pwin": { "type": [ "number", "null" ] }, "preliminary_pwin_context": { "type": "object", "additionalProperties": true }, "user_relevance_score": { "type": "number" }, "recommendation_lineage": { "type": "object", "additionalProperties": true }, "evidence_summary": { "type": "array", "items": {} }, "timeline": { "type": "array", "items": {} }, "related_opportunities": { "type": "array", "items": {} }, "pricing_context": { "type": "object", "additionalProperties": true }, "intent_context": { "type": "object", "additionalProperties": true }, "vehicle_prediction": { "type": "object", "additionalProperties": true }, "incumbent_vulnerability": { "type": "object", "additionalProperties": true }, "dynamic_timeline": { "type": "object", "additionalProperties": true }, "predicted_set_aside": { "type": "object", "additionalProperties": true }, "vehicle_access_validation": { "type": "object", "additionalProperties": true }, "agent_triggers": { "type": "array", "items": {} }, "scoring_metadata": { "type": "object", "additionalProperties": true }, "downstream_graph_hooks": { "type": "object", "additionalProperties": true }, "module_results": { "type": "array", "items": {} }, "data_completeness": { "type": "number" }, "confidence_adjusted": { "type": "boolean" }, "confidence_reasoning": { "type": "string" }, "evidence_count": { "type": "number" }, "supporting_sources": { "type": "array", "items": {} }, "source_system": { "type": "string" }, "source_record_id": { "type": "string" }, "source_url": { "type": [ "string", "null" ] }, "collected_at": { "type": "string" }, "last_updated_at": { "type": "string" }, "human_review_required": { "type": "boolean" }, "review_reason": { "type": [ "string", "null" ] }, "readiness_verification": { "type": "object", "additionalProperties": true }, "handoff_ready": { "type": "boolean" } } }, "ListEnvelope": { "type": "object", "additionalProperties": true, "required": [ "count", "pagination" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "pagination": { "$ref": "#/components/schemas/Pagination" } } }, "OpportunityListEnvelope": { "type": "object", "additionalProperties": true, "required": [ "count", "opportunities", "pagination" ], "properties": { "count": { "type": "integer", "minimum": 0 }, "opportunities": { "type": "array", "items": { "$ref": "#/components/schemas/OpportunityIntelligence" } }, "pagination": { "$ref": "#/components/schemas/Pagination" } } } } } }