{ "openapi": "3.1.0", "info": { "title": "Who Is John Galt API", "version": "current", "description": "Three customer jobs over one governed workspace service: do bounded work, research and decide with evidence, and continue with customer-controlled context. Every durable result exposes progress and a completion receipt. Proprietary compatibility routes are intentionally outside this specification." }, "servers": [ { "url": "https://api.whoisjohngalt.ai" } ], "paths": { "/health": { "get": { "operationId": "getHealth", "security": [], "responses": { "200": { "description": "Service health", "content": { "application/json": { "schema": { "type": "object", "required": [ "status", "service" ], "properties": { "status": { "const": "ok" }, "service": { "type": "string" }, "build_date": { "type": "string" } } } } } }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Getting started" ], "summary": "Get Health", "description": "Service health This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/jobs": { "get": { "operationId": "listCustomerJobs", "security": [], "responses": { "200": { "description": "Three customer jobs and bounded trial recipes", "content": { "application/json": { "schema": { "type": "object", "properties": { "jobs": { "type": "array", "items": { "$ref": "#/components/schemas/CustomerJob" } } } } } } }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Getting started" ], "summary": "List Customer Jobs", "description": "Three customer jobs and bounded trial recipes This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/trial": { "post": { "operationId": "createBoundedTrial", "security": [], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrialRequest" } } } }, "responses": { "200": { "description": "No-side-effect result with completion receipt", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TrialRun" } } } }, "400": { "description": "Invalid trial request", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "description": "Trial rate limit reached", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Getting started" ], "summary": "Create Bounded Trial", "description": "No-side-effect result with completion receipt This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "durable_objective_retention": false, "memory_written": false } } }, "/v1/models": { "get": { "operationId": "listModels", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Model catalog" }, "401": { "description": "Authentication failed", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "List Models", "description": "Model catalog This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/providers": { "get": { "operationId": "listProviders", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Provider catalog and credential boundary" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "List Providers", "description": "Provider catalog and credential boundary This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/adapters": { "get": { "operationId": "listAdapters", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Provider-independent adapter capabilities" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "List Adapters", "description": "Provider-independent adapter capabilities This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/account-free-adapters": { "get": { "operationId": "listAccountFreeAdapters", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Account-free local adapter packs and verification states" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "List Account Free Adapters", "description": "Account-free local adapter packs and verification states This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/adapters/conformance": { "get": { "operationId": "getAdapterConformance", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Adapter conformance contract" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Get Adapter Conformance", "description": "Adapter conformance contract This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/adapters/conformance/validate": { "post": { "operationId": "validateAdapterConformance", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Descriptor admitted" }, "400": { "description": "Descriptor is not conformant", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Validate Adapter Conformance", "description": "Descriptor admitted This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/sandbox-profiles": { "get": { "operationId": "listSandboxProfiles", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sandbox policy and profile catalog" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "List Sandbox Profiles", "description": "Sandbox policy and profile catalog This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/sandbox-capabilities": { "get": { "operationId": "getSandboxCapabilities", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Sandbox lifecycle, network, secret, and artifact boundaries" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Get Sandbox Capabilities", "description": "Sandbox lifecycle, network, secret, and artifact boundaries This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/control-plane": { "get": { "operationId": "getControlPlaneCapabilities", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Tenant control-plane capability status" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Get Control Plane Capabilities", "description": "Tenant control-plane capability status This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/enterprise/readiness": { "get": { "operationId": "getEnterpriseReadiness", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Enterprise integration readiness and connection requirements" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Get Enterprise Readiness", "description": "Enterprise integration readiness and connection requirements This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/onboarding": { "get": { "operationId": "getOnboardingGuide", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Self-service integration guide and connection requirements" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Getting started" ], "summary": "Get Onboarding Guide", "description": "Self-service integration guide and connection requirements This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/onboarding/validate": { "post": { "operationId": "validateOnboardingProfile", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Credential-safe setup readiness checklist" }, "400": { "description": "Invalid setup profile", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Getting started" ], "summary": "Validate Onboarding Profile", "description": "Credential-safe setup readiness checklist This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/usage": { "get": { "operationId": "getUsage", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Usage and billing readiness state" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Get Usage", "description": "Usage and billing readiness state This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/usage/estimate": { "post": { "operationId": "estimateUsage", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Byte-count based token estimate" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Estimate Usage", "description": "Byte-count based token estimate This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/budgets": { "get": { "operationId": "listBudgets", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Tenant budget policy records" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "List Budgets", "description": "Tenant budget policy records This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } }, "post": { "operationId": "upsertBudget", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "201": { "description": "Budget policy recorded" }, "400": { "description": "Invalid policy", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Upsert Budget", "description": "Budget policy recorded This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/routing-policies": { "get": { "operationId": "listRoutingPolicies", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Tenant routing policy records" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "List Routing Policies", "description": "Tenant routing policy records This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } }, "post": { "operationId": "upsertRoutingPolicy", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "201": { "description": "Routing policy recorded" }, "400": { "description": "Invalid policy", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Upsert Routing Policy", "description": "Routing policy recorded This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/audit-events": { "get": { "operationId": "listAuditEvents", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Bounded tenant control receipt metadata" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Trust and evidence" ], "summary": "List Audit Events", "description": "Bounded tenant control receipt metadata This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/journey-events": { "get": { "operationId": "listCustomerJourneyEvents", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } } ], "responses": { "200": { "description": "Tenant-scoped, content-free lifecycle history", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/JourneyEventList" } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "description": "Journey history unavailable", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } } }, "tags": [ "Trust and evidence" ], "summary": "List Customer Journey Events", "description": "Tenant-scoped, content-free lifecycle history This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "tenant_scoped": true, "retention_bounded": true } } }, "/v1/traces": { "get": { "operationId": "listTraces", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Privacy-preserving tenant trace metadata" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Trust and evidence" ], "summary": "List Traces", "description": "Privacy-preserving tenant trace metadata This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } }, "post": { "operationId": "recordTrace", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "201": { "description": "Metadata-only trace recorded" }, "400": { "description": "Invalid trace", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Trust and evidence" ], "summary": "Record Trace", "description": "Metadata-only trace recorded This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/trace-exports": { "get": { "operationId": "listTraceExportDescriptors", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Trace export connection descriptors" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "List Trace Export Descriptors", "description": "Trace export connection descriptors This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } }, "post": { "operationId": "upsertTraceExportDescriptor", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "201": { "description": "Export descriptor recorded without credential value or delivery activation" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Upsert Trace Export Descriptor", "description": "Export descriptor recorded without credential value or delivery activation This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/evaluation-runs": { "get": { "operationId": "listEvaluationRuns", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Digest-bound evaluation run records" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Trust and evidence" ], "summary": "List Evaluation Runs", "description": "Digest-bound evaluation run records This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } }, "post": { "operationId": "createEvaluationRun", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "201": { "description": "Evaluation record created for customer or connected execution" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Trust and evidence" ], "summary": "Create Evaluation Run", "description": "Evaluation record created for customer or connected execution This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/evaluations": { "get": { "operationId": "listEvaluationSuites", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Evaluation suite catalog" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Trust and evidence" ], "summary": "List Evaluation Suites", "description": "Evaluation suite catalog This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/evaluations/validate": { "post": { "operationId": "validateEvaluationDescriptor", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Digest-bound evaluation descriptor admitted" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Trust and evidence" ], "summary": "Validate Evaluation Descriptor", "description": "Digest-bound evaluation descriptor admitted This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/evaluations/patch-candidate": { "post": { "operationId": "generatePublicPatchCandidate", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Untrusted public benchmark patch candidate" }, "400": { "description": "Packet not admissible" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "description": "Candidate unavailable" } }, "tags": [ "Trust and evidence" ], "summary": "Generate Public Patch Candidate", "description": "Untrusted public benchmark patch candidate This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/routing/preview": { "post": { "operationId": "previewRouting", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Non-executing routing plan" }, "400": { "description": "Invalid routing policy", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Preview Routing", "description": "Non-executing routing plan This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/provider-credentials/validate": { "post": { "operationId": "validateProviderCredentialReference", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Customer-managed credential reference admitted without receiving a credential value" }, "400": { "description": "Invalid reference", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Validate Provider Credential Reference", "description": "Customer-managed credential reference admitted without receiving a credential value This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/tools": { "get": { "operationId": "listTools", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Server-managed tool catalog" }, "401": { "description": "Authentication failed", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "List Tools", "description": "Server-managed tool catalog This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/skills": { "get": { "operationId": "listSkills", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Composable skill types, limits, and privacy boundary" }, "401": { "description": "Authentication failed", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "List Skills", "description": "Composable skill types, limits, and privacy boundary This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/skills/validate": { "post": { "operationId": "validateSkillComposition", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Composition admitted for customer-local execution" }, "400": { "description": "Invalid composition", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "description": "Authentication failed", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Platform setup" ], "summary": "Validate Skill Composition", "description": "Composition admitted for customer-local execution This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/chat/completions": { "post": { "operationId": "createChatCompletion", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "model", "messages" ], "properties": { "model": { "type": "string", "enum": [ "galt-workspace", "galt-workspace-fast", "galt-workspace-quality" ] }, "messages": { "type": "array", "minItems": 1, "maxItems": 64 }, "stream": { "type": "boolean", "default": false }, "context_url": { "type": "string", "format": "uri" }, "memory": { "oneOf": [ { "type": "boolean" }, { "type": "object", "properties": { "recall": { "type": "boolean" }, "remember": { "type": "boolean" }, "limit": { "type": "integer", "minimum": 1, "maximum": 10 }, "subject": { "type": "string" }, "expires_at": { "type": "string", "format": "date-time" } } } ] }, "response_format": { "type": "object", "required": [ "type", "json_schema" ], "properties": { "type": { "const": "json_schema" }, "json_schema": { "type": "object", "description": "Bounded JSON Schema using the documented supported subset." } } } } } } } }, "responses": { "200": { "description": "Chat completion or server-sent event stream" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "description": "Authentication failed", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "description": "Rate limited", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "502": { "description": "The model did not satisfy the declared output contract", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Do work" ], "summary": "Create Chat Completion", "description": "Chat completion or server-sent event stream This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/responses": { "post": { "operationId": "createResponse", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Completed response" }, "400": { "description": "Invalid response request", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "description": "Selected provider is not configured", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } } }, "tags": [ "Do work" ], "summary": "Create Response", "description": "Completed response This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/messages": { "post": { "operationId": "createMessage", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Messages-compatible response" }, "400": { "description": "Invalid request", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Do work" ], "summary": "Create Message", "description": "Messages-compatible response This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/agent-runs": { "post": { "operationId": "createAgentRun", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentRunCreate" } } } }, "responses": { "201": { "description": "Durable managed agent run" }, "400": { "description": "Invalid agent-run request", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "description": "Provider or durable-run service is not configured", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } } }, "x-idempotency": { "supported": true, "field": "idempotency_key", "scope": "tenant" }, "tags": [ "Do work" ], "summary": "Create Agent Run", "description": "Durable managed agent run This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/agent-runs/{run_id}": { "get": { "operationId": "getAgentRun", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Durable agent run" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "404": { "description": "Run not found", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Do work" ], "summary": "Get Agent Run", "description": "Durable agent run This GET operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/agent-runs/{run_id}/cancel": { "post": { "operationId": "cancelAgentRun", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Cancelled agent run" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Do work" ], "summary": "Cancel Agent Run", "description": "Cancelled agent run This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/mission-templates": { "get": { "operationId": "listMissionTemplates", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Customer-owned mission template catalog" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Research and decide" ], "summary": "List Mission Templates", "description": "Customer-owned mission template catalog This GET operation belongs to the research and decide job.", "x-customer-job": "research_and_decide", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/mission-runs": { "post": { "operationId": "createMissionRun", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MissionRunCreate" } } } }, "responses": { "201": { "description": "Durable mission plan awaiting customer approval" }, "400": { "description": "Invalid mission request", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "x-idempotency": { "supported": true, "field": "idempotency_key", "scope": "tenant" }, "tags": [ "Research and decide" ], "summary": "Create Mission Run", "description": "Durable mission plan awaiting customer approval This POST operation belongs to the research and decide job.", "x-customer-job": "research_and_decide", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/mission-runs/{mission_id}": { "get": { "operationId": "getMissionRun", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "mission_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Durable mission plan" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "404": { "description": "Mission not found", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Research and decide" ], "summary": "Get Mission Run", "description": "Durable mission plan This GET operation belongs to the research and decide job.", "x-customer-job": "research_and_decide", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/mission-runs/{mission_id}/approve": { "post": { "operationId": "approveMissionRun", "security": [ { "bearerAuth": [] } ], "parameters": [ { "name": "mission_id", "in": "path", "required": true, "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MissionApproval" } } } }, "responses": { "200": { "description": "Mission ready for customer-local execution" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "403": { "description": "Approval required", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Research and decide" ], "summary": "Approve Mission Run", "description": "Mission ready for customer-local execution This POST operation belongs to the research and decide job.", "x-customer-job": "research_and_decide", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/sandbox-jobs": { "post": { "operationId": "createSandboxJob", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "202": { "description": "Admitted isolated workspace job" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "403": { "description": "Workspace admission required" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "description": "Sandbox service unavailable" } }, "tags": [ "Do work" ], "summary": "Create Sandbox Job", "description": "Admitted isolated workspace job This POST operation belongs to the do work job.", "x-customer-job": "do_work", "x-privacy": { "content_analytics": false, "credential_values_accepted": false } } }, "/v1/memory": { "get": { "operationId": "listMemory", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Customer-owned context records" }, "401": { "description": "Authentication failed", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "List Memory", "description": "Customer-owned context records This GET operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } }, "post": { "operationId": "remember", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemoryInput" } } } }, "responses": { "201": { "description": "Context stored" }, "400": { "description": "Content not admitted", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Remember", "description": "Context stored This POST operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/memory/search": { "post": { "operationId": "searchMemory", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Relevant customer-owned context" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MemorySearch" } } } }, "tags": [ "Continue with context" ], "summary": "Search Memory", "description": "Relevant customer-owned context This POST operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/memory/correct": { "post": { "operationId": "correctMemory", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Correction stored and prior record superseded" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Correct Memory", "description": "Correction stored and prior record superseded This POST operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/memory/forget": { "post": { "operationId": "forgetMemory", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Record irreversibly erased" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "403": { "description": "Explicit authorization required" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Forget Memory", "description": "Record irreversibly erased This POST operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/memory/relate": { "post": { "operationId": "relateMemory", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Two active records related" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Relate Memory", "description": "Two active records related This POST operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/memory/integrity": { "get": { "operationId": "checkMemoryIntegrity", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Tenant memory integrity status" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Check Memory Integrity", "description": "Tenant memory integrity status This GET operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/memory/controls": { "get": { "operationId": "getMemoryControls", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Customer-visible ownership, save, retrieval, correction, forgetting, and policy controls" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Get Memory Controls", "description": "Customer-visible ownership, save, retrieval, correction, forgetting, and policy controls This GET operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/memory/quarantine": { "get": { "operationId": "listQuarantinedMemory", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Suspicious records excluded from retrieval pending customer resolution" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "List Quarantined Memory", "description": "Suspicious records excluded from retrieval pending customer resolution This GET operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/memory/quarantine/resolve": { "post": { "operationId": "resolveQuarantinedMemory", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuarantineResolution" } } } }, "responses": { "200": { "description": "Approved quarantined record forgotten or safely replaced" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "403": { "description": "Explicit approval required", "content": { "application/json": { "schema": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } } } } }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Resolve Quarantined Memory", "description": "Approved quarantined record forgotten or safely replaced This POST operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/brain": { "get": { "operationId": "getCustomerBrain", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Tenant learned-brain status and local pack contract" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Get Customer Brain", "description": "Tenant learned-brain status and local pack contract This GET operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/brain/policy": { "get": { "operationId": "getMemoryPolicy", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Current explicit-feedback reranking policy" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Get Memory Policy", "description": "Current explicit-feedback reranking policy This GET operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/brain/feedback": { "post": { "operationId": "learnMemoryRelevance", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Approved relevance feedback learned after snapshot" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "403": { "description": "Explicit approval required" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Learn Memory Relevance", "description": "Approved relevance feedback learned after snapshot This POST operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/brain/consolidate": { "post": { "operationId": "consolidateMemory", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Approved exact duplicates consolidated" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "403": { "description": "Explicit approval required" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Consolidate Memory", "description": "Approved exact duplicates consolidated This POST operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/brain/policy/snapshot": { "post": { "operationId": "snapshotMemoryPolicy", "security": [ { "bearerAuth": [] } ], "responses": { "201": { "description": "Policy snapshot retained" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Snapshot Memory Policy", "description": "Policy snapshot retained This POST operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/brain/policy/rollback": { "post": { "operationId": "rollbackMemoryPolicy", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true }, "responses": { "200": { "description": "Policy restored with rollback receipt" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "403": { "description": "Explicit approval required" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Rollback Memory Policy", "description": "Policy restored with rollback receipt This POST operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/brain/integrity": { "get": { "operationId": "checkBrainIntegrity", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Memory and learned-policy integrity status" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Check Brain Integrity", "description": "Memory and learned-policy integrity status This GET operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } }, "/v1/brain/evaluate": { "get": { "operationId": "evaluateCustomerBrain", "security": [ { "bearerAuth": [] } ], "responses": { "200": { "description": "Customer-data-free learned-brain evaluation" }, "401": { "$ref": "#/components/responses/AuthenticationFailed" }, "429": { "$ref": "#/components/responses/RateLimited" }, "503": { "$ref": "#/components/responses/ServiceUnavailable" } }, "tags": [ "Continue with context" ], "summary": "Evaluate Customer Brain", "description": "Customer-data-free learned-brain evaluation This GET operation belongs to the continue with context job.", "x-customer-job": "continue_with_context", "x-privacy": { "tenant_scoped": true, "customer_owned": true, "action_authority": false } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "workspace access key" } }, "schemas": { "Error": { "type": "object", "required": [ "error" ], "properties": { "error": { "type": "object", "required": [ "message", "type", "code" ], "properties": { "message": { "type": "string" }, "type": { "type": "string" }, "param": { "type": [ "string", "null" ] }, "code": { "type": "string" } } } } }, "MemoryInput": { "type": "object", "required": [ "subject", "content" ], "properties": { "category": { "type": "string", "enum": [ "note", "fact", "method", "follow_up", "relationship" ] }, "subject": { "type": "string", "maxLength": 240 }, "content": { "type": "string", "maxLength": 16384 }, "tags": { "type": "array", "maxItems": 24, "items": { "type": "string" } }, "expires_at": { "type": "string", "format": "date-time" }, "confidence": { "type": "number", "minimum": 0, "maximum": 1 }, "salience": { "type": "number", "minimum": 0, "maximum": 1 }, "provenance": { "type": "object", "properties": { "source_kind": { "type": "string", "enum": [ "customer_statement", "direct_source", "imported_record", "conversation", "system_generated" ] }, "source_label": { "type": "string", "maxLength": 160 }, "source_ref": { "type": "string", "maxLength": 512 } } } } }, "ProgressState": { "type": "object", "required": [ "phase", "percent" ], "properties": { "phase": { "type": "string" }, "percent": { "type": "integer", "minimum": 0, "maximum": 100 } } }, "ActivityStep": { "type": "object", "required": [ "index", "type", "status", "detail" ], "properties": { "index": { "type": "integer", "minimum": 0 }, "type": { "type": "string" }, "status": { "type": "string" }, "detail": { "type": "string" } } }, "CompletionReceipt": { "type": "object", "required": [ "schema_version", "receipt_id", "status", "verification", "input", "output", "actions" ], "properties": { "schema_version": { "const": "customer_completion_receipt.v1" }, "receipt_id": { "type": "string" }, "status": { "type": "string", "enum": [ "planned", "completed", "cancelled", "failed_safely" ] }, "verification": { "type": "string" }, "input": { "type": "object", "additionalProperties": false, "properties": { "sha256": { "type": "string" }, "bytes": { "type": "integer" }, "retained": { "type": "boolean" } } }, "output": { "type": "object", "additionalProperties": true }, "evidence": { "type": "object", "additionalProperties": true }, "actions": { "type": "object", "additionalProperties": false, "properties": { "external_effects": { "type": "boolean" }, "memory_written": { "type": "boolean" }, "credentials_received": { "type": "boolean" } } }, "uncertainty": { "type": "array", "items": { "type": "string" } }, "completed_on": { "type": "string", "format": "date" } } }, "CustomerJob": { "type": "object", "required": [ "id", "label", "promise", "starts_at" ], "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "promise": { "type": "string" }, "starts_at": { "type": "string" }, "trial_available": { "type": "boolean" }, "approval_boundary": { "type": "string" }, "evidence_returned": { "type": "array", "items": { "type": "string" } } } }, "TrialRequest": { "type": "object", "additionalProperties": false, "required": [ "recipe_id", "objective", "consent_to_process" ], "properties": { "recipe_id": { "type": "string", "enum": [ "bounded_work_plan", "decision_brief_outline", "research_question_map" ] }, "objective": { "type": "string", "minLength": 12, "maxLength": 1000 }, "consent_to_process": { "const": true } } }, "TrialRun": { "type": "object", "required": [ "object", "trial_id", "status", "work_state", "activity_steps", "output", "receipt", "privacy" ], "properties": { "object": { "const": "trial.run" }, "trial_id": { "type": "string" }, "status": { "const": "completed" }, "work_state": { "$ref": "#/components/schemas/ProgressState" }, "activity_steps": { "type": "array", "items": { "$ref": "#/components/schemas/ActivityStep" } }, "output": { "type": "array", "items": { "type": "object" } }, "receipt": { "$ref": "#/components/schemas/CompletionReceipt" }, "privacy": { "type": "object" } } }, "MemoryProvenance": { "type": "object", "required": [ "source_kind", "source_ref", "save_approval", "retrieval_screen" ], "properties": { "source_kind": { "type": "string" }, "source_label": { "type": "string" }, "source_ref": { "type": "string" }, "save_approval": { "type": "string" }, "retrieval_screen": { "type": "string" } } }, "MemoryRecord": { "type": "object", "required": [ "id", "subject", "content", "provenance", "action_authority", "untrusted" ], "properties": { "id": { "type": "string" }, "subject": { "type": "string" }, "content": { "type": "string" }, "provenance": { "$ref": "#/components/schemas/MemoryProvenance" }, "action_authority": { "const": false }, "untrusted": { "const": true } } }, "JourneyEvent": { "type": "object", "required": [ "event_id", "event_name", "journey", "job_type", "route", "status_code", "outcome", "observed_at" ], "properties": { "event_id": { "type": "string" }, "event_name": { "type": "string" }, "journey": { "type": "string" }, "job_type": { "type": "string" }, "route": { "type": "string" }, "status_code": { "type": "integer" }, "outcome": { "type": "string" }, "duration_bucket_ms": { "type": "integer" }, "observed_at": { "type": "string", "format": "date-time" } } }, "AgentRunCreate": { "type": "object", "additionalProperties": false, "required": [ "input" ], "properties": { "input": { "oneOf": [ { "type": "string" }, { "type": "array", "items": { "type": "object" } } ] }, "model": { "type": "string", "default": "galt-workspace" }, "provider": { "type": "string", "default": "managed" }, "memory": { "oneOf": [ { "type": "boolean" }, { "type": "object" } ] }, "idempotency_key": { "type": "string", "maxLength": 96 }, "sandbox": { "oneOf": [ { "const": false }, { "type": "object", "properties": { "profile": { "type": "string" } } } ] } }, "examples": [ { "input": "Prepare a checked launch plan.", "idempotency_key": "launch-plan-001", "memory": false } ] }, "MissionRunCreate": { "type": "object", "additionalProperties": false, "required": [ "template_id", "objective" ], "properties": { "template_id": { "type": "string" }, "objective": { "type": "string", "maxLength": 4096 }, "local_adapter_refs": { "type": "array", "maxItems": 8, "items": { "type": "string" } }, "idempotency_key": { "type": "string", "maxLength": 96 } }, "examples": [ { "template_id": "research_brief", "objective": "Assess the evidence for a bounded product decision.", "idempotency_key": "research-001" } ] }, "MissionApproval": { "type": "object", "additionalProperties": false, "required": [ "approved", "approval_digest" ], "properties": { "approved": { "const": true }, "approval_digest": { "type": "string", "minLength": 16, "maxLength": 128 } } }, "MemorySearch": { "type": "object", "additionalProperties": false, "required": [ "query" ], "properties": { "query": { "type": "string", "maxLength": 1000 }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 20 } } }, "QuarantineResolution": { "type": "object", "additionalProperties": false, "required": [ "id", "action", "approved" ], "properties": { "id": { "type": "string" }, "action": { "type": "string", "enum": [ "forget", "replace" ] }, "approved": { "const": true }, "subject": { "type": "string", "maxLength": 240 }, "content": { "type": "string", "maxLength": 16384 }, "provenance": { "$ref": "#/components/schemas/MemoryProvenance" } } }, "JourneyEventList": { "type": "object", "required": [ "object", "data", "privacy" ], "properties": { "object": { "const": "customer_journey_event.list" }, "data": { "type": "array", "items": { "$ref": "#/components/schemas/JourneyEvent" } }, "privacy": { "type": "object" } } } }, "responses": { "AuthenticationFailed": { "description": "Authentication failed", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "RateLimited": { "description": "Rate limit reached", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } }, "ServiceUnavailable": { "description": "The bounded service dependency is unavailable", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Error" } } } } } }, "tags": [ { "name": "Getting started", "description": "Discover the three customer jobs, run a bounded trial, and complete setup." }, { "name": "Do work", "description": "Create checked responses, durable agent runs, and isolated workspace jobs." }, { "name": "Research and decide", "description": "Plan evidence-first research and approval-gated missions." }, { "name": "Continue with context", "description": "Use customer-owned memory with provenance, correction, quarantine, and forgetting." }, { "name": "Trust and evidence", "description": "Inspect progress, lifecycle metadata, traces, evaluations, and receipts." }, { "name": "Platform setup", "description": "Configure models, providers, adapters, routing, budgets, and sandboxes." } ], "externalDocs": { "description": "Customer job guide", "url": "https://api.whoisjohngalt.ai/docs" }, "x-customer-jobs": [ { "id": "do_work", "label": "Do work", "promise": "Turn a bounded objective into a checked result with visible progress and a completion receipt.", "starts_at": "/v1/agent-runs" }, { "id": "research_and_decide", "label": "Research and decide", "promise": "Scope a question, preserve source coverage, distinguish evidence from inference, and produce a decision-ready brief.", "starts_at": "/v1/mission-runs" }, { "id": "continue_with_context", "label": "Continue with context", "promise": "Recall approved context without granting it action authority, then let the customer correct, quarantine, or forget it.", "starts_at": "/v1/memory/controls" } ] }