{ "openapi": "3.0.3", "info": { "title": "VaultCrux API", "version": "0.1.0" }, "components": { "schemas": { "ProblemDetails": { "type": "object", "required": [ "type", "title", "status" ], "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer" }, "detail": { "type": "string" }, "instance": { "type": "string" }, "request_id": { "type": "string" }, "code": { "type": "string" }, "retryable": { "type": "boolean" } } }, "def-0": { "type": "object", "additionalProperties": true, "properties": { "x-tenant-id": { "type": "string", "minLength": 1 }, "x-api-key": { "type": "string", "minLength": 8 } }, "title": "AuthHeaders" }, "def-1": { "type": "object", "additionalProperties": true, "properties": { "x-tenant-id": { "type": "string", "minLength": 1 }, "x-api-key": { "type": "string", "minLength": 8 }, "x-idempotency-key": { "type": "string", "minLength": 8 }, "x-shield-approval-token": { "type": "string", "minLength": 8 } }, "title": "MutationAuthHeaders" }, "def-2": { "type": "object", "additionalProperties": true, "required": [ "type" ], "properties": { "type": { "type": "string" }, "message": { "type": "string" }, "retryAfterSec": { "type": "number" }, "issues": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "details": { "type": "string" }, "idempotencyKey": { "type": "string" }, "upstream": { "type": "string" }, "creditBalance": { "type": "number" }, "dailyRemaining": { "type": "number" }, "upgradeUrl": { "type": "string" }, "agentPrincipalId": { "type": "string", "format": "uuid" }, "feature": { "type": "string" }, "policy": { "type": "string" }, "expected": { "type": "string" }, "available": { "type": "array", "items": { "type": "string" } } }, "title": "ApiError" }, "def-3": { "type": "object", "required": [ "service", "version", "commit", "builtAt" ], "properties": { "service": { "type": "string" }, "version": { "type": "string" }, "commit": { "type": [ "null", "string" ] }, "builtAt": { "type": "string", "format": "date-time" }, "tag": { "type": [ "null", "string" ] }, "tagUrl": { "type": [ "null", "string" ], "format": "uri" } }, "title": "BuildInfo" }, "def-4": { "type": "object", "required": [ "status" ], "properties": { "status": { "type": "string" }, "reason": { "type": "string" } }, "title": "HealthStatus" }, "def-5": { "type": "object", "required": [ "service", "status", "checks" ], "properties": { "service": { "type": "string" }, "status": { "type": "string", "enum": [ "healthy", "degraded" ] }, "checks": { "type": "object", "required": [ "livez", "readyz" ], "properties": { "livez": { "$ref": "#/components/schemas/def-4" }, "readyz": { "$ref": "#/components/schemas/def-4" } } } }, "title": "HealthSummary" }, "def-6": { "type": "object", "required": [ "tenantId", "corpusId", "docId", "title", "url", "content" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "corpusId": { "type": "string", "minLength": 1 }, "docId": { "type": "string", "minLength": 1 }, "title": { "type": "string", "minLength": 1 }, "url": { "type": "string", "format": "uri" }, "content": { "type": "string", "minLength": 1 }, "shareability": { "type": "string", "enum": [ "owner_only", "entitled_only", "public_safe" ] }, "sourceSuggestionId": { "type": "string", "format": "uuid" }, "metadata": { "type": "object", "additionalProperties": true } }, "title": "IngestRequest" }, "def-7": { "type": "object", "required": [ "tenantId", "apiKey" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "apiKey": { "type": "string", "minLength": 8 } }, "title": "FrontdoorAuthConnectRequest" }, "def-8": { "type": "object", "required": [ "tenantId", "authType", "expiresAt" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "authType": { "type": "string", "enum": [ "api_key", "seat" ] }, "apiKeyPrefix": { "type": "string", "minLength": 1 }, "seatId": { "type": "string", "format": "uuid" }, "seatRole": { "type": "string", "enum": [ "owner", "admin", "member", "viewer" ] }, "seatEmail": { "type": "string", "format": "email" }, "expiresAt": { "type": "string", "format": "date-time" } }, "title": "FrontdoorAuthSession" }, "def-9": { "type": "object", "required": [ "proof", "watch", "team" ], "properties": { "proof": { "type": "object", "required": [ "enabled", "canCreateJob", "canReadJob", "canReadChunks", "canReadReceipt" ], "properties": { "enabled": { "type": "boolean" }, "canCreateJob": { "type": "boolean" }, "canReadJob": { "type": "boolean" }, "canReadChunks": { "type": "boolean" }, "canReadReceipt": { "type": "boolean" } } }, "watch": { "type": "object", "required": [ "enabled", "canCreate", "canList", "canRevoke", "canListAlerts" ], "properties": { "enabled": { "type": "boolean" }, "canCreate": { "type": "boolean" }, "canList": { "type": "boolean" }, "canRevoke": { "type": "boolean" }, "canListAlerts": { "type": "boolean" } } }, "team": { "type": "object", "required": [ "enabled", "canListSeats", "canInviteSeat", "canChangeSeatRole", "canRevokeSeat", "canBootstrapOwner" ], "properties": { "enabled": { "type": "boolean" }, "canListSeats": { "type": "boolean" }, "canInviteSeat": { "type": "boolean" }, "canChangeSeatRole": { "type": "boolean" }, "canRevokeSeat": { "type": "boolean" }, "canBootstrapOwner": { "type": "boolean" } } } }, "title": "FrontdoorSessionCapabilities" }, "def-10": { "type": "object", "required": [ "audience", "requesterEmail" ], "properties": { "audience": { "type": "string", "enum": [ "agent", "human" ] }, "requesterName": { "type": "string", "minLength": 1, "maxLength": 120 }, "requesterEmail": { "type": "string", "format": "email", "maxLength": 254 }, "companyName": { "type": "string", "minLength": 1, "maxLength": 160 }, "tenantId": { "type": "string", "minLength": 1, "maxLength": 120 }, "defaultAgentId": { "type": "string", "minLength": 1, "maxLength": 120 }, "apiKeyProvided": { "type": "boolean", "default": false }, "requestedUserLevel": { "type": "string", "enum": [ "free", "starter", "pro", "team" ] }, "useCase": { "type": "string", "minLength": 1, "maxLength": 2000 }, "notes": { "type": "string", "minLength": 1, "maxLength": 2000 } }, "title": "FrontdoorAccessRequestCreate" }, "def-11": { "type": "object", "required": [ "requestId", "status", "submittedAt" ], "properties": { "requestId": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "submitted", "reviewing", "approved", "rejected", "provisioned", "spam" ] }, "submittedAt": { "type": "string", "format": "date-time" } }, "title": "FrontdoorAccessRequestReceipt" }, "def-12": { "type": "object", "required": [ "id", "tenantId", "userEmail", "role", "status", "invitedAt", "acceptedAt", "revokedAt" ], "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string", "minLength": 1 }, "userEmail": { "type": "string", "format": "email" }, "role": { "type": "string", "enum": [ "owner", "admin", "member", "viewer" ] }, "status": { "type": "string", "enum": [ "pending", "active", "revoked" ] }, "invitedAt": { "type": "string", "format": "date-time" }, "acceptedAt": { "type": [ "null", "string" ], "format": "date-time" }, "revokedAt": { "type": [ "null", "string" ], "format": "date-time" }, "invitedBy": { "type": [ "null", "string" ], "format": "uuid" } }, "title": "OrgSeat" }, "def-13": { "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "format": "email" } }, "title": "OrgBootstrapOwnerRequest" }, "def-14": { "type": "object", "required": [ "email" ], "properties": { "email": { "type": "string", "format": "email" }, "role": { "type": "string", "enum": [ "admin", "member", "viewer" ], "default": "member" } }, "title": "OrgInviteRequest" }, "def-15": { "type": "object", "required": [ "role" ], "properties": { "role": { "type": "string", "enum": [ "owner", "admin", "member", "viewer" ] } }, "title": "OrgSeatRoleUpdateRequest" }, "def-16": { "type": "object", "required": [ "token" ], "properties": { "token": { "type": "string", "minLength": 16 } }, "title": "OrgAcceptInviteRequest" }, "def-17": { "type": "object", "required": [ "seat", "inviteToken", "inviteUrl", "expiresAt" ], "properties": { "seat": { "$ref": "#/components/schemas/def-12" }, "inviteToken": { "type": "string", "minLength": 16 }, "inviteUrl": { "type": "string", "minLength": 1 }, "expiresAt": { "type": "string", "format": "date-time" } }, "title": "OrgInviteResponse" }, "def-18": { "type": "object", "required": [ "provider", "includedSeats", "activeSeats", "overageSeats", "overageGbp" ], "properties": { "provider": { "type": "string", "minLength": 1 }, "includedSeats": { "type": "integer", "minimum": 0 }, "activeSeats": { "type": "integer", "minimum": 0 }, "overageSeats": { "type": "integer", "minimum": 0 }, "overageGbp": { "type": "number", "minimum": 0 } }, "title": "OrgSeatsBillingSummary" }, "def-19": { "type": "object", "required": [ "seats", "billing" ], "properties": { "seats": { "type": "array", "items": { "$ref": "#/components/schemas/def-12" } }, "billing": { "$ref": "#/components/schemas/def-18" } }, "title": "OrgSeatsResponse" }, "def-20": { "type": "object", "required": [ "agentFramework" ], "properties": { "registrationType": { "type": "string", "enum": [ "self_signup" ], "default": "self_signup" }, "agentFramework": { "type": "string", "minLength": 1, "maxLength": 64 }, "agentDisplayName": { "type": "string", "minLength": 1, "maxLength": 120 }, "callbackUrl": { "type": "string", "format": "uri", "maxLength": 2000 }, "frameworkFingerprint": { "type": "string", "minLength": 8, "maxLength": 256 } }, "title": "AgentRegisterRequest" }, "def-21": { "type": "object", "required": [ "registrationType", "agentPrincipalId", "discoveryTenantId", "sessionToken", "expiresAt", "creditsRemaining", "dailyQueryLimit", "dailyQueryRemaining", "sponsorRequired", "upgradeUrl" ], "properties": { "registrationType": { "type": "string", "enum": [ "self_signup", "sponsored" ] }, "agentPrincipalId": { "type": "string", "format": "uuid" }, "discoveryTenantId": { "type": "string", "minLength": 1 }, "sessionToken": { "type": "string", "minLength": 16 }, "expiresAt": { "type": "string", "format": "date-time" }, "creditsRemaining": { "type": "integer", "minimum": 0 }, "dailyQueryLimit": { "type": "integer", "minimum": 1 }, "dailyQueryRemaining": { "type": "integer", "minimum": 0 }, "sponsorRequired": { "type": "boolean" }, "upgradeUrl": { "type": "string", "minLength": 1 } }, "title": "AgentRegisterResponse" }, "def-22": { "type": "object", "required": [ "registrationType", "agentPrincipalId", "discoveryTenantId", "sponsorTenantId", "sponsoredAt", "creditsRemaining", "dailyQueryLimit", "dailyQueryRemaining", "sponsorRequired", "upgradeUrl" ], "properties": { "registrationType": { "type": "string", "enum": [ "self_signup", "sponsored" ] }, "agentPrincipalId": { "type": "string", "format": "uuid" }, "discoveryTenantId": { "type": "string", "minLength": 1 }, "sponsorTenantId": { "type": [ "null", "string" ], "minLength": 1 }, "sponsoredAt": { "type": [ "null", "string" ], "format": "date-time" }, "creditsRemaining": { "type": "integer", "minimum": 0 }, "dailyQueryLimit": { "type": "integer", "minimum": 1 }, "dailyQueryRemaining": { "type": "integer", "minimum": 0 }, "sponsorRequired": { "type": "boolean" }, "upgradeUrl": { "type": "string", "minLength": 1 } }, "title": "AgentSponsorRequestSummary" }, "def-23": { "type": "object", "required": [], "properties": { "tier": { "type": "string", "enum": [ "starter", "pro", "team" ], "default": "starter" } }, "title": "AgentSponsorClaimRequest" }, "def-24": { "type": "object", "required": [ "accepted", "agentPrincipalId", "sponsorTenantId", "tier", "registrationType", "sponsoredAt" ], "properties": { "accepted": { "type": "boolean" }, "agentPrincipalId": { "type": "string", "format": "uuid" }, "sponsorTenantId": { "type": "string", "minLength": 1 }, "tier": { "type": "string", "enum": [ "starter", "pro", "team" ] }, "registrationType": { "type": "string", "enum": [ "self_signup", "sponsored" ] }, "sponsoredAt": { "type": "string", "format": "date-time" } }, "title": "AgentSponsorClaimResponse" }, "def-25": { "type": "object", "required": [ "ingestId", "status" ], "properties": { "ingestId": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "queued", "processing", "completed", "failed" ] }, "receiptId": { "type": "string", "format": "uuid" } }, "title": "IngestAccepted" }, "def-26": { "type": "object", "required": [ "ingestId", "status" ], "properties": { "ingestId": { "type": "string", "format": "uuid" }, "status": { "type": "string", "enum": [ "queued", "processing", "completed", "failed" ] }, "error": { "type": [ "null", "string" ] } }, "title": "IngestStatus" }, "def-27": { "type": "object", "required": [ "query" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1, "default": "default-agent" }, "query": { "type": "string", "minLength": 2 }, "corpusIds": { "type": "array", "items": { "type": "string" }, "default": [] }, "limit": { "type": "integer", "minimum": 1, "maximum": 50, "default": 8 }, "lane": { "type": "string", "enum": [ "light", "verified", "audit" ], "default": "light" }, "includeCommons": { "type": "boolean", "default": true } }, "title": "RetrievalRequest" }, "def-28": { "type": "object", "required": [ "chunkId", "docId", "tenantId", "corpusId", "content", "title", "url", "score", "scoreComponents", "source" ], "properties": { "chunkId": { "type": "string" }, "docId": { "type": "string" }, "tenantId": { "type": [ "null", "string" ] }, "corpusId": { "type": "string" }, "content": { "type": "string" }, "title": { "type": [ "null", "string" ] }, "url": { "type": [ "null", "string" ] }, "score": { "type": "number" }, "scoreComponents": { "type": "object", "required": [ "vector", "lexical", "recency", "laneWeight" ], "properties": { "vector": { "type": "number" }, "lexical": { "type": "number" }, "recency": { "type": "number" }, "laneWeight": { "type": "number" } } }, "source": { "type": "string", "enum": [ "tenant", "commons" ] } }, "title": "RetrievalResult" }, "def-29": { "type": "object", "required": [ "results", "credit_cost", "cost_reason", "meta" ], "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/def-28" } }, "credit_cost": { "type": "integer", "minimum": 0 }, "cost_reason": { "type": "string", "enum": [ "tenant_only_query", "paid_tier_commons_query", "free_tier_commons_rate" ] }, "meta": { "type": "object", "required": [ "lane", "vectorBackend", "tookMs" ], "properties": { "lane": { "type": "string" }, "vectorBackend": { "type": "string" }, "tookMs": { "type": "number" } } } }, "title": "RetrievalResponse" }, "def-30": { "type": "string", "enum": [ "light", "verified", "audit" ], "title": "ProofMode" }, "def-31": { "type": "object", "additionalProperties": true, "required": [ "agentId", "mode" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1, "default": "default-agent" }, "artefact_id": { "type": "string", "minLength": 1 }, "mode": { "$ref": "#/components/schemas/def-30" }, "idempotencyKey": { "type": "string", "minLength": 8 }, "metadata": { "type": "object", "additionalProperties": true } }, "title": "ProofJobCreateRequest" }, "def-32": { "type": "object", "additionalProperties": true, "required": [ "ok" ], "properties": { "ok": { "type": "boolean" } }, "title": "ProofBridgePassthrough" }, "def-33": { "type": "object", "additionalProperties": true, "required": [ "type", "message", "upstream" ], "properties": { "type": { "enum": [ "UpstreamContractDrift" ] }, "message": { "type": "string" }, "upstream": { "type": "string" }, "expected": { "type": "string" }, "available": { "type": "array", "items": { "type": "string" } } }, "title": "ProofCompatibilityError" }, "def-34": { "type": "object", "required": [ "agentId", "answerId", "idempotencyKey", "citations" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "answerId": { "type": "string", "format": "uuid" }, "idempotencyKey": { "type": "string", "minLength": 8 }, "citations": { "type": "array", "minItems": 1, "items": { "type": "object", "required": [ "contributionId", "chunkId", "corpusId", "weight" ], "properties": { "contributionId": { "type": "string", "format": "uuid" }, "chunkId": { "type": "string" }, "corpusId": { "type": "string" }, "weight": { "type": "number", "minimum": 0.000001 } } } } }, "title": "CitationIntent" }, "def-35": { "type": "object", "required": [ "accepted", "duplicate" ], "properties": { "accepted": { "type": "boolean" }, "duplicate": { "type": "boolean" }, "receiptId": { "type": "string", "format": "uuid" }, "citationId": { "type": "string", "format": "uuid" } }, "title": "CitationAccepted" }, "def-36": { "type": "object", "required": [ "id", "tenantId", "agentId", "direction", "amount", "reason", "createdAt" ], "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string" }, "agentId": { "type": "string" }, "direction": { "type": "string", "enum": [ "credit", "debit", "reversal" ] }, "amount": { "type": "number" }, "reason": { "type": "string" }, "counterpartyTenantId": { "type": [ "null", "string" ] }, "counterpartyAgentId": { "type": [ "null", "string" ] }, "createdAt": { "type": "string", "format": "date-time" } }, "title": "CreditLedgerItem" }, "def-37": { "type": "object", "required": [ "agentId", "tier", "balance", "escrow_balance", "conversion_eligible", "conversion_value_gbp", "ledger" ], "properties": { "agentId": { "type": "string" }, "tier": { "type": "string", "enum": [ "free", "starter", "pro", "team" ] }, "balance": { "type": "number" }, "escrow_balance": { "type": "number" }, "conversion_eligible": { "type": "boolean" }, "conversion_value_gbp": { "type": "number" }, "ledger": { "type": "array", "items": { "$ref": "#/components/schemas/def-36" } } }, "title": "CreditResponse" }, "def-38": { "type": "object", "required": [ "agentId", "cap", "escrow_balance", "releasable_now" ], "properties": { "agentId": { "type": "string" }, "cap": { "type": "integer" }, "escrow_balance": { "type": "integer" }, "releasable_now": { "type": "integer" } }, "title": "CreditEscrowResponse" }, "def-39": { "type": "object", "required": [ "tenantId", "amount" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "amount": { "type": "number", "minimum": 1 }, "reason": { "type": "string" }, "direction": { "type": "string", "enum": [ "credit", "debit", "reversal" ] }, "tier": { "type": "string", "enum": [ "free", "starter", "pro", "team" ] } }, "title": "CreditAdjustRequest" }, "def-40": { "type": "object", "required": [ "tenantId", "agentId", "credits" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "credits": { "type": "integer", "minimum": 1 }, "idempotencyKey": { "type": "string", "minLength": 8 } }, "title": "ConversionRequest" }, "def-41": { "type": "object", "required": [ "tenantId", "agentId" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "credits": { "type": "integer", "minimum": 1 } }, "title": "ConversionPreviewRequest" }, "def-42": { "type": "object", "required": [ "ok", "credits", "discount_gbp", "max_discount_gbp", "billing_cycle", "conversion_eligible" ], "properties": { "ok": { "type": "boolean" }, "credits": { "type": "integer" }, "discount_gbp": { "type": "number" }, "max_discount_gbp": { "type": "number" }, "billing_cycle": { "type": "string" }, "conversion_eligible": { "type": "boolean" } }, "title": "ConversionPreviewResponse" }, "def-43": { "type": "object", "required": [ "ok", "conversion_id", "credits_converted", "discount_gbp", "billing_cycle", "paddle_reference" ], "properties": { "ok": { "type": "boolean" }, "conversion_id": { "type": "string", "format": "uuid" }, "credits_converted": { "type": "integer" }, "discount_gbp": { "type": "number" }, "billing_cycle": { "type": "string" }, "paddle_reference": { "type": "string" } }, "title": "ConversionResponse" }, "def-44": { "type": "object", "required": [ "tenantId", "agentId", "amount" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "amount": { "type": "integer", "minimum": 1 }, "reason": { "type": "string", "enum": [ "saved_time", "quality", "reliability", "support_project", "other" ] }, "idempotencyKey": { "type": "string", "minLength": 8 } }, "title": "TipPlatformRequest" }, "def-45": { "type": "object", "required": [ "ok", "tip_id", "new_balance", "sink_account" ], "properties": { "ok": { "type": "boolean" }, "tip_id": { "type": "string", "format": "uuid" }, "new_balance": { "type": "integer" }, "sink_account": { "type": "string" } }, "title": "TipPlatformResponse" }, "def-46": { "type": "object", "required": [ "agentId", "tier", "balance", "escrow_balance", "tip_history", "conversion_history" ], "properties": { "agentId": { "type": "string" }, "tier": { "type": "string", "enum": [ "free", "starter", "pro", "team" ] }, "balance": { "type": "integer" }, "escrow_balance": { "type": "integer" }, "tip_history": { "type": "array", "items": { "type": "object", "required": [ "tip_id", "amount", "reason", "created_at" ], "properties": { "tip_id": { "type": "string", "format": "uuid" }, "amount": { "type": "integer" }, "reason": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" } } } }, "conversion_history": { "type": "array", "items": { "type": "object", "required": [ "conversion_id", "credits", "discount_gbp", "status", "created_at" ], "properties": { "conversion_id": { "type": "string", "format": "uuid" }, "credits": { "type": "integer" }, "discount_gbp": { "type": "number" }, "status": { "type": "string" }, "created_at": { "type": "string", "format": "date-time" } } } } }, "title": "EconomyDashboard" }, "def-47": { "type": "object", "required": [ "bundle_id", "bundle_key", "title", "description", "price_credits", "seller_alias", "schema_version" ], "properties": { "bundle_id": { "type": "string", "format": "uuid" }, "bundle_key": { "type": "string" }, "title": { "type": "string" }, "description": { "type": "string" }, "price_credits": { "type": "integer" }, "seller_alias": { "type": "string" }, "schema_version": { "type": "string" } }, "title": "BundleListing" }, "def-48": { "type": "object", "required": [ "bundles" ], "properties": { "bundles": { "type": "array", "items": { "$ref": "#/components/schemas/def-47" } } }, "title": "BrowseBundlesResponse" }, "def-49": { "type": "object", "required": [ "tenantId", "agentId", "bundle_id", "idempotencyKey" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "bundle_id": { "type": "string", "format": "uuid" }, "idempotencyKey": { "type": "string", "minLength": 8 } }, "title": "PurchaseBundleRequest" }, "def-50": { "type": "object", "required": [ "ok", "purchase_id", "bundle_id", "price_credits", "receipt_hash", "anomaly_flagged" ], "properties": { "ok": { "type": "boolean" }, "purchase_id": { "type": "string", "format": "uuid" }, "bundle_id": { "type": "string", "format": "uuid" }, "price_credits": { "type": "integer" }, "receipt_hash": { "type": "string" }, "anomaly_flagged": { "type": "boolean" } }, "title": "PurchaseBundleResponse" }, "def-51": { "type": "object", "required": [ "id", "tenantId", "agentId", "primitive_type", "payload", "created_at", "updated_at" ], "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string" }, "agentId": { "type": "string" }, "primitive_type": { "type": "string", "enum": [ "journal_entry", "pin", "structured_object", "delegation_note" ] }, "payload": { "type": "object", "additionalProperties": true }, "created_at": { "type": "string", "format": "date-time" }, "updated_at": { "type": "string", "format": "date-time" } }, "title": "HomePrimitive" }, "def-52": { "type": "object", "required": [ "tenantId", "agentId", "primitive_type", "payload" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "primitive_type": { "type": "string", "enum": [ "journal_entry", "pin", "structured_object", "delegation_note" ] }, "payload": { "type": "object", "additionalProperties": true } }, "title": "HomePrimitiveUpsertRequest" }, "def-53": { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/def-51" } } }, "title": "HomePrimitiveList" }, "def-54": { "type": "string", "enum": [ "citation_earned", "credit_earned", "credit_spent", "credit_overflow", "credit_released", "pin_stale", "watch_alert", "proof_completed", "contribution_ingested", "schema_adopted", "bundle_sold", "tier_upgraded" ], "title": "JournalEventType" }, "def-55": { "type": "object", "required": [ "id", "tenantId", "agentId", "eventType", "eventTs", "source", "payload" ], "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "eventType": { "$ref": "#/components/schemas/def-54" }, "eventTs": { "type": "string", "format": "date-time" }, "source": { "type": "string", "minLength": 1 }, "payload": { "type": "object", "additionalProperties": true } }, "title": "JournalEvent" }, "def-56": { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/def-55" } } }, "title": "JournalListResponse" }, "def-57": { "type": "object", "required": [ "pinPrimitiveId", "tenantId", "agentId", "status", "pressureScore", "reason", "staleSince", "lastCheckedAt" ], "properties": { "pinPrimitiveId": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "artifactId": { "type": [ "null", "string" ] }, "chunkId": { "type": [ "null", "string" ] }, "status": { "type": "string", "enum": [ "fresh", "stale", "unknown" ] }, "pressureScore": { "type": [ "null", "number" ] }, "reason": { "type": [ "null", "string" ] }, "staleSince": { "type": [ "null", "string" ], "format": "date-time" }, "lastCheckedAt": { "type": "string", "format": "date-time" }, "pinPayload": { "type": "object", "additionalProperties": true } }, "title": "StalePin" }, "def-58": { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/def-57" } } }, "title": "StalePinListResponse" }, "def-59": { "type": "object", "required": [ "query", "lane", "meta", "createdAt" ], "properties": { "query": { "type": "string", "minLength": 1 }, "lane": { "type": "string", "minLength": 1 }, "meta": { "type": "object", "additionalProperties": true }, "createdAt": { "type": "string", "format": "date-time" } }, "title": "SessionRecentQuery" }, "def-60": { "type": "object", "required": [ "tenantId", "agentId", "last_active", "credit_balance", "escrow_balance", "journal_since_last", "stale_pins", "recent_queries", "reputation_tier", "total_contributions", "total_citations" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "last_active": { "type": [ "null", "string" ], "format": "date-time" }, "credit_balance": { "type": "integer", "minimum": 0 }, "escrow_balance": { "type": "integer", "minimum": 0 }, "journal_since_last": { "type": "array", "items": { "$ref": "#/components/schemas/def-55" } }, "stale_pins": { "type": "array", "items": { "$ref": "#/components/schemas/def-57" } }, "recent_queries": { "type": "array", "items": { "$ref": "#/components/schemas/def-59" } }, "reputation_tier": { "type": "string", "minLength": 1 }, "total_contributions": { "type": "integer", "minimum": 0 }, "total_citations": { "type": "integer", "minimum": 0 } }, "title": "SessionContext" }, "def-61": { "type": "object", "required": [ "eventType" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "eventType": { "type": "string", "enum": [ "watch_alert", "proof_completed", "schema_adopted" ] }, "source": { "type": "string", "minLength": 1 }, "idempotencyKey": { "type": "string", "minLength": 8 }, "eventTs": { "type": "string", "format": "date-time" }, "payload": { "type": "object", "additionalProperties": true } }, "title": "JournalAdapterEventRequest" }, "def-62": { "type": "string", "enum": [ "daily", "weekly", "on_change" ], "title": "WatchFrequency" }, "def-63": { "type": "string", "enum": [ "answer", "artifact" ], "title": "WatchTargetType" }, "def-64": { "type": "object", "required": [ "targetType", "targetId" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1, "default": "default-agent" }, "targetType": { "type": "string", "enum": [ "answer", "artifact", "artefact" ] }, "targetId": { "type": "string", "minLength": 1 }, "frequency": { "$ref": "#/components/schemas/def-62" } }, "title": "WatchCreateRequest" }, "def-65": { "type": "object", "required": [ "id", "tenantId", "agentId", "targetType", "targetId", "frequency", "baselineReceiptId", "baselineFingerprint", "lastCheckedAt", "nextCheckAt", "lastAlertAt", "lastError", "revokedAt", "createdAt", "updatedAt" ], "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "targetType": { "$ref": "#/components/schemas/def-63" }, "targetId": { "type": "string", "minLength": 1 }, "frequency": { "$ref": "#/components/schemas/def-62" }, "baselineReceiptId": { "type": [ "null", "string" ] }, "baselineFingerprint": { "type": [ "null", "string" ] }, "lastCheckedAt": { "type": [ "null", "string" ], "format": "date-time" }, "nextCheckAt": { "type": "string", "format": "date-time" }, "lastAlertAt": { "type": [ "null", "string" ], "format": "date-time" }, "lastError": { "type": [ "null", "string" ] }, "revokedAt": { "type": [ "null", "string" ], "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "title": "Watch" }, "def-66": { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/def-65" } } }, "title": "WatchListResponse" }, "def-67": { "type": "object", "required": [ "id", "tenantId", "agentId", "watchId", "targetType", "targetId", "changeType", "eventTs", "previousFingerprint", "currentFingerprint", "payload", "createdAt" ], "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "watchId": { "type": "string", "format": "uuid" }, "targetType": { "$ref": "#/components/schemas/def-63" }, "targetId": { "type": "string", "minLength": 1 }, "changeType": { "type": "string", "minLength": 1 }, "eventTs": { "type": "string", "format": "date-time" }, "previousFingerprint": { "type": [ "null", "string" ] }, "currentFingerprint": { "type": "string", "minLength": 1 }, "payload": { "type": "object", "additionalProperties": true }, "createdAt": { "type": "string", "format": "date-time" } }, "title": "WatchAlert" }, "def-68": { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/def-67" } } }, "title": "WatchAlertListResponse" }, "def-69": { "type": "string", "enum": [ "retrieval_quality", "proof_and_compliance", "watch_and_monitoring", "integrations", "pricing_and_billing", "developer_experience", "other" ], "title": "FeedbackCategory" }, "def-70": { "type": "string", "enum": [ "submitted", "acknowledged", "shipped", "archived" ], "title": "FeedbackRequestStatus" }, "def-71": { "type": "string", "enum": [ "approved", "pending_review", "quarantined", "rejected" ], "title": "FeedbackReviewState" }, "def-72": { "type": "object", "required": [ "category", "title", "description" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1, "default": "default-agent" }, "category": { "$ref": "#/components/schemas/def-69" }, "title": { "type": "string", "minLength": 3, "maxLength": 160 }, "description": { "type": "string", "minLength": 8, "maxLength": 4000 }, "metadata": { "type": "object", "additionalProperties": true }, "idempotencyKey": { "type": "string", "minLength": 8 } }, "title": "FeedbackRequestCreate" }, "def-73": { "type": "object", "required": [ "id", "tenantId", "agentId", "category", "title", "description", "status", "reviewState", "taintReasons", "voteCount", "weightedVoteScore", "lastVotedAt", "acknowledgedAt", "shippedAt", "archivedAt", "createdAt", "updatedAt" ], "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "category": { "$ref": "#/components/schemas/def-69" }, "title": { "type": "string", "minLength": 1 }, "description": { "type": "string", "minLength": 1 }, "status": { "$ref": "#/components/schemas/def-70" }, "reviewState": { "$ref": "#/components/schemas/def-71" }, "taintReasons": { "type": "array", "items": { "type": "string" } }, "voteCount": { "type": "integer", "minimum": 0 }, "weightedVoteScore": { "type": "number", "minimum": 0 }, "lastVotedAt": { "type": [ "null", "string" ], "format": "date-time" }, "acknowledgedAt": { "type": [ "null", "string" ], "format": "date-time" }, "shippedAt": { "type": [ "null", "string" ], "format": "date-time" }, "archivedAt": { "type": [ "null", "string" ], "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "title": "FeedbackRequest" }, "def-74": { "type": "object", "required": [ "items" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/def-73" } } }, "title": "FeedbackRequestListResponse" }, "def-75": { "type": "object", "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1, "default": "default-agent" }, "metadata": { "type": "object", "additionalProperties": true }, "idempotencyKey": { "type": "string", "minLength": 8 } }, "title": "FeedbackVoteRequest" }, "def-76": { "type": "object", "required": [ "requestId", "voteCount", "weightedVoteScore", "aggregated" ], "properties": { "requestId": { "type": "string", "format": "uuid" }, "voteCount": { "type": "integer", "minimum": 0 }, "weightedVoteScore": { "type": "number", "minimum": 0 }, "aggregated": { "type": "boolean" } }, "title": "FeedbackVoteResponse" }, "def-77": { "type": "object", "required": [ "id", "status", "reviewState", "updatedAt" ], "properties": { "id": { "type": "string", "format": "uuid" }, "status": { "$ref": "#/components/schemas/def-70" }, "reviewState": { "$ref": "#/components/schemas/def-71" }, "updatedAt": { "type": "string", "format": "date-time" } }, "title": "FeedbackRequestTransitionResponse" }, "def-78": { "type": "object", "required": [ "category", "willingnessBand" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1, "default": "default-agent" }, "requestId": { "type": "string", "format": "uuid" }, "category": { "$ref": "#/components/schemas/def-69" }, "willingnessBand": { "type": "string", "enum": [ "lt_100", "100_500", "500_2k", "2k_10k", "gt_10k" ] }, "billingCycle": { "type": "string", "enum": [ "monthly", "annual" ], "default": "monthly" }, "confidence": { "type": "string", "enum": [ "low", "medium", "high" ], "default": "medium" }, "notes": { "type": "string", "minLength": 1, "maxLength": 2000 }, "metadata": { "type": "object", "additionalProperties": true }, "idempotencyKey": { "type": "string", "minLength": 8 } }, "title": "FeedbackRevenueDeclarationRequest" }, "def-79": { "type": "object", "required": [ "id", "tenantId", "requestId", "agentId", "category", "willingnessBand", "billingCycle", "confidence", "notes", "reviewState", "taintReasons", "reviewedAt", "createdAt", "updatedAt" ], "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string", "minLength": 1 }, "requestId": { "type": [ "null", "string" ], "format": "uuid" }, "agentId": { "type": "string", "minLength": 1 }, "category": { "$ref": "#/components/schemas/def-69" }, "willingnessBand": { "type": "string", "enum": [ "lt_100", "100_500", "500_2k", "2k_10k", "gt_10k" ] }, "billingCycle": { "type": "string", "enum": [ "monthly", "annual" ] }, "confidence": { "type": "string", "enum": [ "low", "medium", "high" ] }, "notes": { "type": [ "null", "string" ] }, "reviewState": { "$ref": "#/components/schemas/def-71" }, "taintReasons": { "type": "array", "items": { "type": "string" } }, "reviewedAt": { "type": [ "null", "string" ], "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "title": "FeedbackRevenueDeclaration" }, "def-80": { "type": "object", "required": [ "category", "declarations", "weightedIntent" ], "properties": { "category": { "$ref": "#/components/schemas/def-69" }, "declarations": { "type": "integer", "minimum": 0 }, "weightedIntent": { "type": "number", "minimum": 0 } }, "title": "FeedbackRevenueSummaryCategory" }, "def-81": { "type": "object", "required": [ "categories", "generatedAt" ], "properties": { "categories": { "type": "array", "items": { "$ref": "#/components/schemas/def-80" } }, "generatedAt": { "type": "string", "format": "date-time" } }, "title": "FeedbackRevenueSummaryResponse" }, "def-82": { "type": "object", "required": [ "version", "categories", "satisfactionScale" ], "properties": { "version": { "type": "string", "minLength": 4, "maxLength": 32 }, "categories": { "type": "array", "items": { "$ref": "#/components/schemas/def-69" } }, "satisfactionScale": { "type": "object", "required": [ "min", "max", "labels" ], "properties": { "min": { "enum": [ 1 ] }, "max": { "enum": [ 5 ] }, "labels": { "type": "array", "items": { "type": "string", "minLength": 1 }, "minItems": 5, "maxItems": 5 } } } }, "title": "FeedbackSurveyCurrentResponse" }, "def-83": { "type": "object", "required": [ "category", "satisfactionScore", "recommendation", "outcome" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1, "default": "default-agent" }, "category": { "$ref": "#/components/schemas/def-69" }, "satisfactionScore": { "type": "integer", "minimum": 1, "maximum": 5 }, "recommendation": { "type": "string", "enum": [ "yes", "no", "unsure" ] }, "outcome": { "type": "string", "enum": [ "worse", "same", "better" ] }, "freeformFeedback": { "type": "string", "minLength": 1, "maxLength": 2000 }, "metadata": { "type": "object", "additionalProperties": true }, "idempotencyKey": { "type": "string", "minLength": 8 } }, "title": "FeedbackSurveyResponseRequest" }, "def-84": { "type": "object", "required": [ "id", "tenantId", "agentId", "surveyVersion", "category", "satisfactionScore", "recommendation", "outcome", "freeformFeedback", "rewardCredits", "reviewState", "taintReasons", "createdAt", "updatedAt" ], "properties": { "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "surveyVersion": { "type": "string", "minLength": 4, "maxLength": 32 }, "category": { "$ref": "#/components/schemas/def-69" }, "satisfactionScore": { "type": "integer", "minimum": 1, "maximum": 5 }, "recommendation": { "type": "string", "enum": [ "yes", "no", "unsure" ] }, "outcome": { "type": "string", "enum": [ "worse", "same", "better" ] }, "freeformFeedback": { "type": [ "null", "string" ] }, "rewardCredits": { "type": "integer", "minimum": 0 }, "reviewState": { "$ref": "#/components/schemas/def-71" }, "taintReasons": { "type": "array", "items": { "type": "string" } }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "title": "FeedbackSurveyResponse" }, "def-85": { "type": "object", "required": [ "id", "reviewState", "updatedAt" ], "properties": { "id": { "type": "string", "format": "uuid" }, "reviewState": { "$ref": "#/components/schemas/def-71" }, "updatedAt": { "type": "string", "format": "date-time" } }, "title": "FeedbackReviewDecisionResponse" }, "def-86": { "type": "object", "required": [ "category", "requests", "openRequests", "voteCount", "weightedVoteScore" ], "properties": { "category": { "$ref": "#/components/schemas/def-69" }, "requests": { "type": "integer", "minimum": 0 }, "openRequests": { "type": "integer", "minimum": 0 }, "voteCount": { "type": "integer", "minimum": 0 }, "weightedVoteScore": { "type": "number", "minimum": 0 } }, "title": "FeedbackDemandCategoryAggregate" }, "def-87": { "type": "object", "required": [ "day", "responses", "averageSatisfaction" ], "properties": { "day": { "type": "string", "minLength": 10, "maxLength": 10 }, "responses": { "type": "integer", "minimum": 0 }, "averageSatisfaction": { "type": [ "number", "null" ] } }, "title": "FeedbackSatisfactionTrendPoint" }, "def-88": { "type": "object", "required": [ "quarantinedRequests", "quarantinedVotes", "quarantinedDeclarations", "quarantinedSurveyResponses" ], "properties": { "quarantinedRequests": { "type": "integer", "minimum": 0 }, "quarantinedVotes": { "type": "integer", "minimum": 0 }, "quarantinedDeclarations": { "type": "integer", "minimum": 0 }, "quarantinedSurveyResponses": { "type": "integer", "minimum": 0 } }, "title": "FeedbackSuspiciousActivitySummary" }, "def-89": { "type": "object", "required": [ "demandHeatmap", "revenueSignal", "satisfactionTrend", "suspiciousActivity", "generatedAt" ], "properties": { "demandHeatmap": { "type": "array", "items": { "$ref": "#/components/schemas/def-86" } }, "revenueSignal": { "type": "array", "items": { "$ref": "#/components/schemas/def-80" } }, "satisfactionTrend": { "type": "array", "items": { "$ref": "#/components/schemas/def-87" } }, "suspiciousActivity": { "$ref": "#/components/schemas/def-88" }, "generatedAt": { "type": "string", "format": "date-time" } }, "title": "FeedbackOverviewResponse" }, "def-90": { "type": "object", "required": [ "kind", "id", "tenantId", "agentId", "category", "reviewState", "taintReasons", "status", "createdAt" ], "properties": { "kind": { "type": "string", "enum": [ "request", "declaration", "survey" ] }, "id": { "type": "string", "format": "uuid" }, "tenantId": { "type": "string", "minLength": 1 }, "agentId": { "type": "string", "minLength": 1 }, "category": { "$ref": "#/components/schemas/def-69" }, "reviewState": { "$ref": "#/components/schemas/def-71" }, "taintReasons": { "type": "array", "items": { "type": "string" } }, "status": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time" } }, "title": "FeedbackReviewQueueItem" }, "def-91": { "type": "object", "required": [ "items", "generatedAt" ], "properties": { "items": { "type": "array", "items": { "$ref": "#/components/schemas/def-90" } }, "generatedAt": { "type": "string", "format": "date-time" } }, "title": "FeedbackReviewQueueResponse" }, "def-92": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-25" } }, "title": "EnvelopeOkIngestAccepted" }, "def-93": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-26" } }, "title": "EnvelopeOkIngestStatus" }, "def-94": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-29" } }, "title": "EnvelopeOkRetrieval" }, "def-95": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-35" } }, "title": "EnvelopeOkCitationAccepted" }, "def-96": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-37" } }, "title": "EnvelopeOkCreditResponse" }, "def-97": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-38" } }, "title": "EnvelopeOkCreditEscrowResponse" }, "def-98": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "type": "object", "required": [ "accepted" ], "properties": { "accepted": { "type": "boolean" } } } }, "title": "EnvelopeOkAccepted" }, "def-99": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "type": "object", "required": [ "session", "capabilities" ], "properties": { "session": { "$ref": "#/components/schemas/def-8" }, "capabilities": { "$ref": "#/components/schemas/def-9" } } } }, "title": "EnvelopeOkFrontdoorAuthSession" }, "def-100": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-11" } }, "title": "EnvelopeOkFrontdoorAccessRequestReceipt" }, "def-101": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "type": "object", "required": [ "seat" ], "properties": { "seat": { "$ref": "#/components/schemas/def-12" } } } }, "title": "EnvelopeOkOrgSeat" }, "def-102": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-17" } }, "title": "EnvelopeOkOrgInvite" }, "def-103": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-19" } }, "title": "EnvelopeOkOrgSeats" }, "def-104": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-21" } }, "title": "EnvelopeOkAgentRegisterResponse" }, "def-105": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-22" } }, "title": "EnvelopeOkAgentSponsorRequestSummary" }, "def-106": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-24" } }, "title": "EnvelopeOkAgentSponsorClaimResponse" }, "def-107": { "type": "object", "required": [ "mode", "manifests" ], "properties": { "mode": { "type": "string", "enum": [ "observe", "enforce" ] }, "manifests": { "type": "array", "items": { "type": "object", "required": [ "name", "summary", "capability_class", "risk_tier", "requires_approval", "taint_policy" ], "properties": { "name": { "type": "string" }, "summary": { "type": "string" }, "capability_class": { "type": "string" }, "risk_tier": { "type": "string" }, "requires_approval": { "type": "boolean" }, "taint_policy": { "type": "object", "required": [ "block_tainted", "require_user_confirmed" ], "properties": { "block_tainted": { "type": "boolean" }, "require_user_confirmed": { "type": "boolean" } } } } } } }, "title": "ShieldCapabilitiesResponse" }, "def-108": { "type": "object", "required": [ "publishers" ], "properties": { "publishers": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "title": "ShieldTrustedPublishersResponse" }, "def-109": { "type": "object", "required": [ "digests" ], "properties": { "digests": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "title": "ShieldTrustedDigestsResponse" }, "def-110": { "type": "object", "required": [ "servers" ], "properties": { "servers": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "title": "ShieldManagedServersResponse" }, "def-111": { "type": "object", "required": [ "approval" ], "properties": { "approval": { "type": "object", "additionalProperties": true } }, "title": "ShieldApprovalRequestResponse" }, "def-112": { "type": "object", "required": [ "switches" ], "properties": { "switches": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "title": "ShieldKillSwitchesResponse" }, "def-113": { "type": "object", "required": [ "killSwitch" ], "properties": { "killSwitch": { "type": "object", "additionalProperties": true } }, "title": "ShieldKillSwitchResponse" }, "def-114": { "type": "object", "required": [ "policies" ], "properties": { "policies": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "title": "ShieldSamplingPoliciesResponse" }, "def-115": { "type": "object", "required": [ "policy" ], "properties": { "policy": { "type": "object", "additionalProperties": true } }, "title": "ShieldSamplingPolicyResponse" }, "def-116": { "type": "object", "required": [ "sessions" ], "properties": { "sessions": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "title": "ShieldUiIntegritySessionsResponse" }, "def-117": { "type": "object", "required": [ "session" ], "properties": { "session": { "type": "object", "additionalProperties": true } }, "title": "ShieldUiIntegritySessionResponse" }, "def-118": { "type": "object", "required": [ "drills" ], "properties": { "drills": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "title": "ShieldIncidentDrillsResponse" }, "def-119": { "type": "object", "required": [ "drill" ], "properties": { "drill": { "type": "object", "additionalProperties": true } }, "title": "ShieldIncidentDrillResponse" }, "def-120": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-42" } }, "title": "EnvelopeOkConversionPreviewResponse" }, "def-121": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-43" } }, "title": "EnvelopeOkConversionResponse" }, "def-122": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-45" } }, "title": "EnvelopeOkTipPlatformResponse" }, "def-123": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-46" } }, "title": "EnvelopeOkEconomyDashboard" }, "def-124": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-48" } }, "title": "EnvelopeOkBrowseBundlesResponse" }, "def-125": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-50" } }, "title": "EnvelopeOkPurchaseBundleResponse" }, "def-126": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-51" } }, "title": "EnvelopeOkHomePrimitive" }, "def-127": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-53" } }, "title": "EnvelopeOkHomePrimitiveList" }, "def-128": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-56" } }, "title": "EnvelopeOkJournalListResponse" }, "def-129": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-58" } }, "title": "EnvelopeOkStalePinListResponse" }, "def-130": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-60" } }, "title": "EnvelopeOkSessionContext" }, "def-131": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-65" } }, "title": "EnvelopeOkWatch" }, "def-132": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-66" } }, "title": "EnvelopeOkWatchListResponse" }, "def-133": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-68" } }, "title": "EnvelopeOkWatchAlertListResponse" }, "def-134": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-73" } }, "title": "EnvelopeOkFeedbackRequest" }, "def-135": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-74" } }, "title": "EnvelopeOkFeedbackRequestListResponse" }, "def-136": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-76" } }, "title": "EnvelopeOkFeedbackVoteResponse" }, "def-137": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-77" } }, "title": "EnvelopeOkFeedbackRequestTransition" }, "def-138": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-79" } }, "title": "EnvelopeOkFeedbackRevenueDeclaration" }, "def-139": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-81" } }, "title": "EnvelopeOkFeedbackRevenueSummaryResponse" }, "def-140": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-82" } }, "title": "EnvelopeOkFeedbackSurveyCurrentResponse" }, "def-141": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-84" } }, "title": "EnvelopeOkFeedbackSurveyResponse" }, "def-142": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-85" } }, "title": "EnvelopeOkFeedbackReviewDecisionResponse" }, "def-143": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-89" } }, "title": "EnvelopeOkFeedbackOverviewResponse" }, "def-144": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-91" } }, "title": "EnvelopeOkFeedbackReviewQueueResponse" }, "def-145": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-107" } }, "title": "EnvelopeOkShieldCapabilitiesResponse" }, "def-146": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-108" } }, "title": "EnvelopeOkShieldTrustedPublishers" }, "def-147": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "type": "object", "required": [ "publisher" ], "properties": { "publisher": { "type": "object", "additionalProperties": true } } } }, "title": "EnvelopeOkShieldTrustedPublisher" }, "def-148": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-109" } }, "title": "EnvelopeOkShieldTrustedDigests" }, "def-149": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "type": "object", "required": [ "digest" ], "properties": { "digest": { "type": "object", "additionalProperties": true } } } }, "title": "EnvelopeOkShieldTrustedDigest" }, "def-150": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-110" } }, "title": "EnvelopeOkShieldManagedServers" }, "def-151": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "type": "object", "required": [ "server" ], "properties": { "server": { "type": "object", "additionalProperties": true } } } }, "title": "EnvelopeOkShieldManagedServer" }, "def-152": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-111" } }, "title": "EnvelopeOkShieldApprovalRequest" }, "def-153": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-112" } }, "title": "EnvelopeOkShieldKillSwitches" }, "def-154": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-113" } }, "title": "EnvelopeOkShieldKillSwitch" }, "def-155": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-114" } }, "title": "EnvelopeOkShieldSamplingPolicies" }, "def-156": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-115" } }, "title": "EnvelopeOkShieldSamplingPolicy" }, "def-157": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-116" } }, "title": "EnvelopeOkShieldUiIntegritySessions" }, "def-158": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-117" } }, "title": "EnvelopeOkShieldUiIntegritySession" }, "def-159": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-118" } }, "title": "EnvelopeOkShieldIncidentDrills" }, "def-160": { "type": "object", "required": [ "ok", "data" ], "properties": { "ok": { "enum": [ true ] }, "data": { "$ref": "#/components/schemas/def-119" } }, "title": "EnvelopeOkShieldIncidentDrill" }, "def-161": { "type": "object", "required": [ "ok", "error" ], "properties": { "ok": { "enum": [ false ] }, "error": { "$ref": "#/components/schemas/def-33" } }, "title": "EnvelopeErrProofCompatibility" }, "def-162": { "type": "object", "required": [ "ok", "error" ], "properties": { "ok": { "enum": [ false ] }, "error": { "$ref": "#/components/schemas/def-2" } }, "title": "EnvelopeErr" }, "def-163": { "type": "object", "required": [ "type", "title", "status" ], "additionalProperties": true, "properties": { "type": { "type": "string" }, "title": { "type": "string" }, "status": { "type": "integer", "minimum": 400, "maximum": 599 }, "detail": { "type": "string" }, "instance": { "type": "string" }, "request_id": { "type": "string" }, "code": { "type": "string" }, "retryable": { "type": "boolean" } }, "title": "ProblemDetails" } }, "securitySchemes": { "ApiKeyAuth": { "type": "apiKey", "in": "header", "name": "x-api-key" }, "TenantHeader": { "type": "apiKey", "in": "header", "name": "x-tenant-id" } } }, "paths": { "/docs/reference/openapi.json": { "get": { "responses": { "200": { "description": "Default Response" } } } }, "/metrics": { "get": { "tags": [ "System" ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "type": "string" } } } } } } }, "/livez": { "get": { "tags": [ "System" ], "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-4" } } } } } } }, "/healthz": { "get": { "tags": [ "System" ], "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-4" } } } } } } }, "/readyz": { "get": { "tags": [ "System" ], "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-4" } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-4" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/health": { "get": { "tags": [ "System" ], "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-5" } } } } } } }, "/build-info": { "get": { "tags": [ "System" ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-3" } } } } } } }, "/v1/agents/register": { "post": { "summary": "Register autonomous agent for constrained self-signup", "tags": [ "Agents" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-20" } } } }, "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-104" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/agents/me/sponsor-request": { "get": { "summary": "Get sponsor request summary for current self-signup session", "tags": [ "Agents" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-105" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/agents/{agentPrincipalId}/sponsor": { "post": { "summary": "Claim and sponsor a self-signup principal", "tags": [ "Agents" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-23" } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "agentPrincipalId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-106" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/ingest": { "post": { "summary": "Submit an ingest job", "tags": [ "Ingest" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-6" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "202": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-92" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/ingest/{id}": { "get": { "summary": "Fetch ingest job status", "tags": [ "Ingest" ], "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-93" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/retrieve": { "post": { "summary": "Hybrid retrieval", "tags": [ "Retrieval" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-27" } } } }, "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-94" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/citations": { "post": { "summary": "Submit citation intent", "tags": [ "Citations" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-34" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "202": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-95" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/credits/{agentId}": { "get": { "summary": "Read credit balances and ledger entries", "tags": [ "Credits" ], "parameters": [ { "schema": { "type": "string" }, "in": "query", "name": "tenantId", "required": false }, { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "agentId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-96" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/credits/{agentId}/escrow": { "get": { "summary": "Read escrow cap/release state", "tags": [ "Credits" ], "parameters": [ { "schema": { "type": "string" }, "in": "query", "name": "tenantId", "required": false }, { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "agentId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-97" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/credits/{agentId}/adjust": { "post": { "summary": "Adjust credit ledger manually", "tags": [ "Credits" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-39" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "agentId", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-98" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/webhooks/paddle/conversions": { "post": { "summary": "Apply Paddle conversion callback (signature-verified)", "tags": [ "Economy" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "required": [ "conversion_id", "billing_reference", "event_id" ], "properties": { "conversion_id": { "type": "string", "format": "uuid" }, "billing_reference": { "type": "string", "minLength": 1 }, "event_id": { "type": "string", "minLength": 1 } } } } } }, "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-98" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/economy/dashboard/{agentId}": { "get": { "summary": "Read economy dashboard by agent", "tags": [ "Economy" ], "parameters": [ { "schema": { "type": "string" }, "in": "query", "name": "tenantId", "required": false }, { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "agentId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-123" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/economy/convert/preview": { "post": { "summary": "Preview credit to discount conversion", "tags": [ "Economy" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-41" } } } }, "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-120" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/economy/convert": { "post": { "summary": "Convert credits to Paddle subscription discount", "tags": [ "Economy" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-40" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-121" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/economy/tip-platform": { "post": { "summary": "Tip platform sink account", "tags": [ "Economy" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-44" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-122" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/bundles": { "get": { "summary": "Browse cross-tenant bundle catalog", "tags": [ "Marketplace" ], "parameters": [ { "schema": { "type": "string" }, "in": "query", "name": "tenantId", "required": false }, { "schema": { "type": "integer", "minimum": 1, "maximum": 500 }, "in": "query", "name": "limit", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-124" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/bundles/purchase": { "post": { "summary": "Purchase bundle across tenants with atomic transfer", "tags": [ "Marketplace" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-49" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-125" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/home/{agentId}/primitives": { "get": { "summary": "List structured home primitives for an agent", "tags": [ "Home" ], "parameters": [ { "schema": { "type": "string" }, "in": "query", "name": "tenantId", "required": false }, { "schema": { "type": "string", "enum": [ "journal_entry", "pin", "structured_object", "delegation_note" ] }, "in": "query", "name": "type", "required": false }, { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "agentId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-127" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "post": { "summary": "Add a home primitive for an agent", "tags": [ "Home" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-52" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "agentId", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-126" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/home/{agentId}/journal": { "get": { "summary": "List agent continuity journal entries", "tags": [ "Home" ], "parameters": [ { "schema": { "type": "string", "format": "date-time" }, "in": "query", "name": "since", "required": false }, { "schema": { "type": "integer", "minimum": 1, "maximum": 500 }, "in": "query", "name": "limit", "required": false }, { "schema": { "type": "string" }, "in": "query", "name": "types", "required": false }, { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "agentId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-128" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/home/{agentId}/stale-pins": { "get": { "summary": "List stale/unknown pin freshness records", "tags": [ "Home" ], "parameters": [ { "schema": { "type": "integer", "minimum": 1, "maximum": 500 }, "in": "query", "name": "limit", "required": false }, { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "agentId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-129" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/home/{agentId}/session-context": { "get": { "summary": "Get continuity welcome-back session context", "tags": [ "Home" ], "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "agentId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-130" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/home/{agentId}/journal/events": { "post": { "summary": "Append adapter-ingress continuity journal event", "tags": [ "Home" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-61" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "agentId", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-98" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/watches": { "post": { "summary": "Create or reactivate a watch", "tags": [ "Watch" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-64" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-131" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "get": { "summary": "List active watches for an agent", "tags": [ "Watch" ], "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "query", "name": "tenantId", "required": false }, { "schema": { "type": "string", "minLength": 1 }, "in": "query", "name": "agentId", "required": false }, { "schema": { "type": "integer", "minimum": 1, "maximum": 500 }, "in": "query", "name": "limit", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-132" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/watches/{id}/alerts": { "get": { "summary": "List alerts for a watch", "tags": [ "Watch" ], "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "query", "name": "tenantId", "required": false }, { "schema": { "type": "string", "minLength": 1 }, "in": "query", "name": "agentId", "required": false }, { "schema": { "type": "string", "format": "date-time" }, "in": "query", "name": "since", "required": false }, { "schema": { "type": "integer", "minimum": 1, "maximum": 500 }, "in": "query", "name": "limit", "required": false }, { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-133" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/watches/{id}": { "delete": { "summary": "Delete (revoke) a watch", "tags": [ "Watch" ], "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "query", "name": "tenantId", "required": false }, { "schema": { "type": "string", "minLength": 1 }, "in": "query", "name": "agentId", "required": false }, { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-131" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/requests": { "post": { "summary": "Submit feedback request", "tags": [ "Feedback" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-72" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-134" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "get": { "summary": "List feedback requests", "tags": [ "Feedback" ], "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "query", "name": "tenantId", "required": false }, { "schema": { "$ref": "#/components/schemas/def-69" }, "in": "query", "name": "category", "required": false }, { "schema": { "$ref": "#/components/schemas/def-70" }, "in": "query", "name": "status", "required": false }, { "schema": { "type": "integer", "minimum": 1, "maximum": 500 }, "in": "query", "name": "limit", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-135" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/requests/{id}/vote": { "post": { "summary": "Vote for a feedback request", "tags": [ "Feedback" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-75" } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-136" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/requests/{id}/acknowledge": { "post": { "summary": "Acknowledge a feedback request", "tags": [ "Feedback" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "tenantId": { "type": "string", "minLength": 1 } } } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-137" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/requests/{id}/archive": { "post": { "summary": "Archive a feedback request", "tags": [ "Feedback" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "tenantId": { "type": "string", "minLength": 1 } } } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-137" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/requests/{id}/ship": { "post": { "summary": "Mark a feedback request as shipped", "tags": [ "Feedback" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "additionalProperties": false, "properties": { "tenantId": { "type": "string", "minLength": 1 } } } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-137" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/revenue/declarations": { "post": { "summary": "Declare revenue willingness", "tags": [ "Feedback" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-78" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-138" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/revenue/summary": { "get": { "summary": "Get feedback revenue summary (aggregate only)", "tags": [ "Feedback" ], "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "query", "name": "tenantId", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-139" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/surveys/current": { "get": { "summary": "Get current feedback survey", "tags": [ "Feedback" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-140" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/surveys/current/responses": { "post": { "summary": "Submit current survey response", "tags": [ "Feedback" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-83" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-141" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/review/requests/{id}": { "post": { "summary": "Review feedback request", "tags": [ "Feedback" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "decision" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "decision": { "type": "string", "enum": [ "approve", "reject" ] }, "reason": { "type": "string", "minLength": 1, "maxLength": 512 } } } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-142" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/feedback/review/declarations/{id}": { "post": { "summary": "Review revenue declaration", "tags": [ "Feedback" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "decision" ], "properties": { "tenantId": { "type": "string", "minLength": 1 }, "decision": { "type": "string", "enum": [ "approve", "reject" ] }, "reason": { "type": "string", "minLength": 1, "maxLength": 512 } } } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-142" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/proof/answers/{answerId}/receipt": { "get": { "summary": "Proxy proof receipt by answer id", "tags": [ "Proof" ], "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "answerId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-32" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "502": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/proof/receipts/{receiptId}/proofpack": { "get": { "summary": "Proxy proofpack by receipt id", "tags": [ "Proof" ], "parameters": [ { "schema": "object", "in": "query", "name": "type" }, { "schema": true, "in": "query", "name": "additionalProperties" }, { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "receiptId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-32" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "502": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/proof/jobs": { "post": { "summary": "Create proof job", "tags": [ "Proof" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-31" } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-32" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "402": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "501": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-161" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "502": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/proof/jobs/{id}": { "get": { "summary": "Get proof job status", "tags": [ "Proof" ], "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "id", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-32" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "501": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-161" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "502": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/proof/jobs/{id}/chunks": { "get": { "summary": "Get proof job chunks", "tags": [ "Proof" ], "parameters": [ { "schema": { "type": "string" }, "in": "query", "name": "cursor", "required": false }, { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "id", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-32" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "501": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-161" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "502": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/proof/jobs/{id}/receipt": { "get": { "summary": "Get proof job receipt", "tags": [ "Proof" ], "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "in": "path", "name": "id", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-32" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "501": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-161" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "502": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/capabilities": { "get": { "summary": "List first-party shield manifests and current mode", "tags": [ "Shield" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-145" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/trust/publishers": { "get": { "summary": "List trusted publishers", "tags": [ "Shield" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-146" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "post": { "summary": "Create or update trusted publisher", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "displayName", "identityType", "identityRef" ], "properties": { "tenantId": { "type": "string" }, "displayName": { "type": "string", "minLength": 1 }, "identityType": { "type": "string", "enum": [ "sigstore", "gpg", "org_domain", "manual" ] }, "identityRef": { "type": "string", "minLength": 1 }, "trustLevel": { "type": "string", "enum": [ "low", "medium", "high" ] }, "metadata": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-147" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/trust/digests": { "get": { "summary": "List trusted server digests", "tags": [ "Shield" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-148" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "post": { "summary": "Create or update trusted server digest", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "publisherId", "serverName", "digest" ], "properties": { "tenantId": { "type": "string" }, "publisherId": { "type": "string", "format": "uuid" }, "serverName": { "type": "string", "minLength": 1 }, "digest": { "type": "string", "minLength": 3 }, "riskTier": { "type": "string", "enum": [ "low", "med", "high", "extreme" ] }, "capabilities": { "type": "array", "items": { "type": "string" } }, "samplingAllowed": { "type": "boolean" }, "uiAppsAllowed": { "type": "boolean" }, "provenance": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-149" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/trust/digests/revoke": { "post": { "summary": "Revoke a digest", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "digest", "reason" ], "properties": { "tenantId": { "type": "string" }, "digest": { "type": "string", "minLength": 3 }, "reason": { "type": "string", "minLength": 1 }, "revokedBy": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-98" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/servers": { "get": { "summary": "List managed MCP servers", "tags": [ "Shield" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-150" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "post": { "summary": "Install or update managed MCP server lifecycle state", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "serverName" ], "properties": { "tenantId": { "type": "string" }, "serverName": { "type": "string", "minLength": 1 }, "publisherId": { "type": "string", "format": "uuid" }, "activeDigest": { "type": "string" }, "requestedDigest": { "type": "string" }, "status": { "type": "string", "enum": [ "installed", "upgrading", "quarantined", "revoked", "disabled" ] }, "lifecycleMetadata": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-151" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/servers/{serverId}/status": { "post": { "summary": "Update managed server status", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "status" ], "properties": { "tenantId": { "type": "string" }, "status": { "type": "string", "enum": [ "installed", "upgrading", "quarantined", "revoked", "disabled" ] }, "metadata": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "serverId", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-98" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/approvals/propose": { "post": { "summary": "Create approval proposal", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "toolName" ], "properties": { "tenantId": { "type": "string" }, "toolName": { "type": "string", "minLength": 1 }, "capabilityClass": { "type": "string" }, "riskTier": { "type": "string" }, "taintLabel": { "type": "string" }, "proposer": { "type": "string" }, "requestId": { "type": "string" }, "payload": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-152" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/approvals/{approvalRequestId}/resolve": { "post": { "summary": "Resolve approval proposal", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "decision" ], "properties": { "tenantId": { "type": "string" }, "decision": { "type": "string", "enum": [ "approved", "denied", "expired" ] }, "resolver": { "type": "string" }, "reason": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "approvalRequestId", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-152" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/approvals/{approvalRequestId}": { "get": { "summary": "Read approval request", "tags": [ "Shield" ], "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "approvalRequestId", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-152" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/kill-switches": { "get": { "summary": "List kill switches", "tags": [ "Shield" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-153" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "post": { "summary": "Enable or update kill switch", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "targetType", "targetRef" ], "properties": { "tenantId": { "type": "string" }, "targetType": { "type": "string", "enum": [ "agent_key", "tool", "server_digest", "sampling_global", "cross_tenant_purchase" ] }, "targetRef": { "type": "string", "minLength": 1 }, "reason": { "type": "string" }, "actor": { "type": "string" }, "expiresAt": { "type": "string", "format": "date-time" }, "metadata": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-154" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/kill-switches/{killSwitchId}": { "delete": { "summary": "Disable kill switch", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "tenantId": { "type": "string" }, "actor": { "type": "string" }, "reason": { "type": "string" }, "metadata": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "killSwitchId", "required": true }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-98" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/sampling-policies": { "get": { "summary": "List sampling policies", "tags": [ "Shield" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-155" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "post": { "summary": "Create or update sampling policy", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "serverDigest", "enabled", "tokenBudget", "requiresApproval" ], "properties": { "tenantId": { "type": "string" }, "serverDigest": { "type": "string", "minLength": 3 }, "publisherId": { "type": "string", "format": "uuid" }, "enabled": { "type": "boolean" }, "tokenBudget": { "type": "integer", "minimum": 0 }, "requiresApproval": { "type": "boolean" }, "redactionPolicy": { "type": "object", "additionalProperties": true }, "metadata": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-156" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/ui-integrity-sessions": { "get": { "summary": "List UI integrity sessions", "tags": [ "Shield" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-157" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "post": { "summary": "Create or refresh UI integrity session", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "requestId", "payloadHash" ], "properties": { "tenantId": { "type": "string" }, "requestId": { "type": "string", "minLength": 1 }, "payloadHash": { "type": "string", "minLength": 8 }, "serverDigest": { "type": "string" }, "expiresAt": { "type": "string", "format": "date-time" }, "metadata": { "type": "object", "additionalProperties": true } } } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-158" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/shield/incident-drills": { "get": { "summary": "List incident drills", "tags": [ "Shield" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-159" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "post": { "summary": "Record incident drill", "tags": [ "Shield" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": [ "drillType", "status" ], "properties": { "tenantId": { "type": "string" }, "drillType": { "type": "string", "minLength": 1 }, "status": { "type": "string", "enum": [ "planned", "running", "completed", "failed" ] }, "summary": { "type": "string" }, "findings": { "type": "object", "additionalProperties": true }, "startedAt": { "type": "string", "format": "date-time" }, "completedAt": { "type": "string", "format": "date-time" } } } } } }, "parameters": [ { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-idempotency-key", "required": false }, { "schema": { "type": "string", "minLength": 8 }, "in": "header", "name": "x-shield-approval-token", "required": false } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-160" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "429": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/org/bootstrap-owner": { "post": { "summary": "Bootstrap first owner seat for tenant", "tags": [ "Organization" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-13" } } } }, "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-101" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/org/invite": { "post": { "summary": "Invite tenant seat", "tags": [ "Organization" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-14" } } } }, "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-102" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "409": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/org/seats": { "get": { "summary": "List tenant seats and billing summary", "tags": [ "Organization" ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-103" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/org/seats/{id}": { "put": { "summary": "Update seat role", "tags": [ "Organization" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-15" } } } }, "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-101" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } }, "delete": { "summary": "Revoke seat", "tags": [ "Organization" ], "parameters": [ { "schema": { "type": "string", "format": "uuid" }, "in": "path", "name": "id", "required": true } ], "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-101" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/v1/org/accept-invite": { "post": { "summary": "Accept seat invite and issue seat session cookie", "tags": [ "Organization" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-16" } } } }, "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-99" } } } }, "404": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "412": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/frontdoor/auth/connect": { "post": { "summary": "Connect frontdoor using tenant API key and issue HttpOnly session cookie", "tags": [ "Frontdoor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-7" } } } }, "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-99" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "403": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/frontdoor/auth/session": { "get": { "summary": "Get current frontdoor session", "tags": [ "Frontdoor" ], "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-99" } } } }, "401": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } }, "/frontdoor/auth/logout": { "post": { "summary": "Logout frontdoor session", "tags": [ "Frontdoor" ], "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-98" } } } } } } }, "/frontdoor/access-requests": { "post": { "summary": "Submit a manual provisioning request from Frontdoor", "tags": [ "Frontdoor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-10" } } } }, "security": [], "responses": { "200": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-100" } } } }, "422": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } }, "503": { "description": "Default Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/def-162" } }, "application/problem+json": { "schema": { "$ref": "#/components/schemas/ProblemDetails" } } } } } } } }, "security": [ { "ApiKeyAuth": [], "TenantHeader": [] } ] }