{ "components": { "schemas": { "ActionDescriptorV1": { "additionalProperties": false, "description": "Canonical policy input for one tool call.", "properties": { "arguments": { "additionalProperties": true, "title": "Arguments", "type": "object" }, "capability_refs": { "default": [], "items": { "type": "string" }, "title": "Capability Refs", "type": "array" }, "contract_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Contract Ref" }, "fingerprint": { "minLength": 1, "title": "Fingerprint", "type": "string" }, "identity_configuration": { "default": [], "items": { "type": "string" }, "title": "Identity Configuration", "type": "array" }, "name": { "minLength": 1, "title": "Name", "type": "string" }, "requires_approval": { "default": false, "title": "Requires Approval", "type": "boolean" }, "side_effect": { "$ref": "#/components/schemas/SideEffectClass", "default": "unknown" }, "tool_call_id": { "anyOf": [ { "maxLength": 256, "minLength": 1, "pattern": "^\\S(?:.*\\S)?$", "type": "string" }, { "type": "null" } ], "title": "Tool Call Id" } }, "required": [ "name", "fingerprint" ], "title": "ActionDescriptorV1", "type": "object" }, "ActorIdentity": { "additionalProperties": false, "description": "Stable actor identity recorded on runs, approvals, and audits.", "properties": { "auth_method": { "$ref": "#/components/schemas/AuthMethod" }, "roles": { "items": { "$ref": "#/components/schemas/ServiceRole" }, "title": "Roles", "type": "array" }, "subject": { "title": "Subject", "type": "string" }, "tenant_id": { "default": "default", "title": "Tenant Id", "type": "string" }, "workspace_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workspace Id" } }, "required": [ "subject", "auth_method" ], "title": "ActorIdentity", "type": "object" }, "AdminRunListResponse": { "additionalProperties": false, "description": "Response for the admin run list endpoint.", "properties": { "runs": { "items": { "$ref": "#/components/schemas/RunStatusResponse" }, "title": "Runs", "type": "array" }, "total": { "title": "Total", "type": "integer" } }, "required": [ "runs", "total" ], "title": "AdminRunListResponse", "type": "object" }, "ApprovalActionRecord": { "additionalProperties": false, "description": "A record of an approval-related action (e.g. requested, approved, denied).\n\nUsed when a node requires human or system approval before proceeding.\nTracks who took the action and when it happened.", "properties": { "action": { "title": "Action", "type": "string" }, "actor": { "anyOf": [ { "$ref": "#/components/schemas/ActorIdentity" }, { "type": "null" } ] }, "approval_id": { "title": "Approval Id", "type": "string" }, "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "occurred_at": { "format": "date-time", "title": "Occurred At", "type": "string" } }, "required": [ "approval_id", "action" ], "title": "ApprovalActionRecord", "type": "object" }, "ApprovalDecision": { "description": "The possible choices a human reviewer can make on an approval request.\n\nAPPROVE \u2014 accept as-is. REJECT \u2014 deny the action. EDIT_AND_APPROVE \u2014 modify\nthe proposed payload and then accept it.", "enum": [ "approve", "reject", "edit_and_approve" ], "title": "ApprovalDecision", "type": "string" }, "ApprovalPausedState": { "additionalProperties": false, "description": "Public state for a run paused on human approval.", "properties": { "approval_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Approval Id" }, "input_payload": { "additionalProperties": true, "title": "Input Payload", "type": "object" }, "node_id": { "title": "Node Id", "type": "string" } }, "required": [ "node_id" ], "title": "ApprovalPausedState", "type": "object" }, "ApprovalRecord": { "additionalProperties": false, "description": "The main approval object that tracks a single approval request.\n\nCreated when an agent workflow hits a node that requires human sign-off.\nContains everything a reviewer needs: a summary, rationale, the proposed\npayload, which actions are allowed, and (once answered) the resolution.", "properties": { "allowed_actions": { "items": { "$ref": "#/components/schemas/ApprovalDecision" }, "title": "Allowed Actions", "type": "array" }, "approval_id": { "title": "Approval Id", "type": "string" }, "context_excerpt": { "additionalProperties": true, "title": "Context Excerpt", "type": "object" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "escalated_from_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Escalated From Id" }, "escalation_action": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Escalation Action" }, "graph_version_ref": { "title": "Graph Version Ref", "type": "string" }, "interaction_type": { "$ref": "#/components/schemas/HumanInteractionType", "default": "approval" }, "node_id": { "title": "Node Id", "type": "string" }, "proposed_payload": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Proposed Payload" }, "rationale": { "title": "Rationale", "type": "string" }, "requested_by": { "anyOf": [ { "$ref": "#/components/schemas/ActorIdentity" }, { "type": "null" } ] }, "requested_decision": { "$ref": "#/components/schemas/ApprovalDecision", "default": "approve" }, "resolution": { "anyOf": [ { "$ref": "#/components/schemas/ApprovalResolution" }, { "type": "null" } ] }, "resolution_schema_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Resolution Schema Ref" }, "run_id": { "title": "Run Id", "type": "string" }, "sla_deadline": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "title": "Sla Deadline" }, "status": { "$ref": "#/components/schemas/ApprovalStatus", "default": "pending" }, "summary": { "title": "Summary", "type": "string" }, "tenant_id": { "default": "default", "title": "Tenant Id", "type": "string" }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thread Id" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "urgency_metadata": { "additionalProperties": true, "title": "Urgency Metadata", "type": "object" }, "workspace_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workspace Id" } }, "required": [ "run_id", "node_id", "graph_version_ref", "deployment_ref", "summary", "rationale" ], "title": "ApprovalRecord", "type": "object" }, "ApprovalResolution": { "additionalProperties": false, "description": "Holds the details of how an approval was resolved.\n\nStores who made the decision, what they decided, any edits they made to\nthe payload, and when the decision happened.", "properties": { "actor": { "$ref": "#/components/schemas/ActorIdentity" }, "decision": { "$ref": "#/components/schemas/ApprovalDecision" }, "edited_payload": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Edited Payload" }, "reason": { "anyOf": [ { "maxLength": 1000, "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Reason" }, "resolved_at": { "format": "date-time", "title": "Resolved At", "type": "string" } }, "required": [ "decision", "actor" ], "title": "ApprovalResolution", "type": "object" }, "ApprovalResolutionRequest": { "additionalProperties": false, "description": "Request body for resolving a pending approval.", "properties": { "decision": { "$ref": "#/components/schemas/ApprovalDecision" }, "edited_payload": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Edited Payload" }, "reason": { "anyOf": [ { "maxLength": 1000, "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Reason" } }, "required": [ "decision" ], "title": "ApprovalResolutionRequest", "type": "object" }, "ApprovalResolutionResponse": { "additionalProperties": false, "description": "Response body returned after resolving an approval.", "properties": { "approval": { "$ref": "#/components/schemas/ApprovalRecord" }, "run": { "$ref": "#/components/schemas/RunStatusResponse" } }, "required": [ "approval", "run" ], "title": "ApprovalResolutionResponse", "type": "object" }, "ApprovalStatus": { "description": "Whether an approval request is still waiting or has been answered.\n\nPENDING means no decision yet; RESOLVED means a human has responded.", "enum": [ "pending", "resolved", "escalated" ], "title": "ApprovalStatus", "type": "string" }, "AttestationAck": { "additionalProperties": false, "description": "Whether the submitted attestation is the one now in force.\n\n``run_attestations`` is first-write-wins per ``(tenant, correlation)``, so a\nsubmission can be accepted by the transport and still not be the evidence\nthe run is judged on. :attr:`authoritative` is what distinguishes the two;\nthe digest and expiry describe the attestation actually in force, which is\nthe submitted one only when :attr:`authoritative` is true.", "properties": { "authoritative": { "title": "Authoritative", "type": "boolean" }, "correlation_id": { "title": "Correlation Id", "type": "string" }, "digest": { "title": "Digest", "type": "string" }, "expires_at": { "format": "date-time", "title": "Expires At", "type": "string" }, "status": { "title": "Status", "type": "string" } }, "required": [ "correlation_id", "authoritative", "status", "digest", "expires_at" ], "title": "AttestationAck", "type": "object" }, "AttestationSubmission": { "additionalProperties": false, "description": "Run-start claims a client asks the server to bind and record.\n\nThe client never signs: the signing key lives on the server (see\n``zeroth.platform.signing``), so the signature attributes the claim to the\nserver having accepted it from an authenticated principal. ``issued_at``\nand ``expires_at`` are likewise server-assigned -- a client-chosen validity\nwindow would let a run mint an attestation that never expires.", "properties": { "adapter_version": { "title": "Adapter Version", "type": "string" }, "claimed_level": { "title": "Claimed Level", "type": "string" }, "correlation_id": { "minLength": 1, "title": "Correlation Id", "type": "string" }, "deployment_ref": { "minLength": 1, "title": "Deployment Ref", "type": "string" }, "graph_version": { "title": "Graph Version", "type": "string" }, "inventory_fingerprint": { "title": "Inventory Fingerprint", "type": "string" } }, "required": [ "correlation_id", "deployment_ref", "graph_version", "adapter_version", "inventory_fingerprint", "claimed_level" ], "title": "AttestationSubmission", "type": "object" }, "AttestationVerificationResponse": { "additionalProperties": false, "description": "Dual-check verification result for a deployment attestation.\n\n``verified`` stays the overall pass/fail. ``digest_verified`` is the digest\nrecompute axis; ``signature_verified`` is the keyed axis (three-state, null =\nunsigned-legacy). Neither masks the other.", "properties": { "digest_verified": { "default": false, "title": "Digest Verified", "type": "boolean" }, "mismatches": { "items": { "type": "string" }, "title": "Mismatches", "type": "array" }, "signature_verified": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Signature Verified" }, "signing_key_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Signing Key Id" }, "verified": { "title": "Verified", "type": "boolean" } }, "required": [ "verified" ], "title": "AttestationVerificationResponse", "type": "object" }, "AuditDeliveryHealth": { "additionalProperties": false, "description": "The bounded audit-delivery stage's own accounting, rendered as health.\n\nRead straight off the stage's counters rather than recomputed: \"delivered\"\nis the only counter that means an event is durable, and the three loss\ncounters are reported beside it so a failing stage can never be read as a\nhealthy one. ``queue_depth`` is the backlog still waiting for the worker.", "properties": { "abandoned": { "title": "Abandoned", "type": "integer" }, "delivered": { "title": "Delivered", "type": "integer" }, "failed": { "title": "Failed", "type": "integer" }, "losing_events": { "title": "Losing Events", "type": "boolean" }, "queue_depth": { "title": "Queue Depth", "type": "integer" }, "queued": { "title": "Queued", "type": "integer" }, "rejected": { "title": "Rejected", "type": "integer" }, "retried": { "title": "Retried", "type": "integer" } }, "required": [ "queue_depth", "queued", "delivered", "retried", "rejected", "failed", "abandoned", "losing_events" ], "title": "AuditDeliveryHealth", "type": "object" }, "AuditReadinessResponse": { "additionalProperties": false, "description": "Whether this deployment may make its configured audit-integrity claim.", "properties": { "consequential_actions": { "title": "Consequential Actions", "type": "boolean" }, "deployment_mode": { "title": "Deployment Mode", "type": "string" }, "message": { "title": "Message", "type": "string" }, "ready": { "title": "Ready", "type": "boolean" }, "signer_available": { "title": "Signer Available", "type": "boolean" }, "signing_required": { "title": "Signing Required", "type": "boolean" }, "state": { "title": "State", "type": "string" } }, "required": [ "ready", "state", "deployment_mode", "signing_required", "signer_available", "consequential_actions", "message" ], "title": "AuditReadinessResponse", "type": "object" }, "AuditRecordListResponse": { "additionalProperties": false, "description": "Public response for deployment-scoped audit lookups.", "properties": { "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "records": { "items": { "$ref": "#/components/schemas/NodeAuditRecord" }, "title": "Records", "type": "array" } }, "required": [ "deployment_ref" ], "title": "AuditRecordListResponse", "type": "object" }, "AuditTimelineResponse": { "additionalProperties": false, "description": "Public response for ordered audit timelines.", "properties": { "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "entries": { "items": { "$ref": "#/components/schemas/NodeAuditRecord" }, "title": "Entries", "type": "array" }, "run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, "required": [ "deployment_ref" ], "title": "AuditTimelineResponse", "type": "object" }, "AuditVerificationResponse": { "additionalProperties": false, "description": "Result of verifying the audit chain for a scope.\n\n``verified`` is the unkeyed digest-continuity axis. ``signature_verified`` is\nthe independent WS-D keyed axis, three-state: True (all signed records\nvalid), False (a signed record failed), null (unsigned-legacy \u2014 render\nneutral, never green or red).", "properties": { "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" }, "failed_audit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Failed Audit Id" }, "record_count": { "default": 0, "title": "Record Count", "type": "integer" }, "scope": { "title": "Scope", "type": "string" }, "signature_verified": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Signature Verified" }, "signing_key_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Signing Key Id" }, "unsigned_record_count": { "default": 0, "title": "Unsigned Record Count", "type": "integer" }, "verified": { "title": "Verified", "type": "boolean" } }, "required": [ "scope", "verified" ], "title": "AuditVerificationResponse", "type": "object" }, "AuthMethod": { "description": "Supported request authentication methods.", "enum": [ "api_key", "bearer" ], "title": "AuthMethod", "type": "string" }, "CandidateOutcome": { "additionalProperties": false, "description": "One model's measured result in a right-sizing experiment.", "properties": { "capability_ok": { "default": true, "title": "Capability Ok", "type": "boolean" }, "cases_errored": { "default": 0, "title": "Cases Errored", "type": "integer" }, "cases_evaluated": { "default": 0, "title": "Cases Evaluated", "type": "integer" }, "equivalence_rate": { "default": 0.0, "title": "Equivalence Rate", "type": "number" }, "error_rate": { "default": 0.0, "title": "Error Rate", "type": "number" }, "est_cost_per_1k_calls_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Est Cost Per 1K Calls Usd" }, "is_incumbent": { "default": false, "title": "Is Incumbent", "type": "boolean" }, "meets_bar": { "default": false, "title": "Meets Bar", "type": "boolean" }, "model": { "title": "Model", "type": "string" }, "provider": { "title": "Provider", "type": "string" }, "savings_pct": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Savings Pct" } }, "required": [ "model", "provider" ], "title": "CandidateOutcome", "type": "object" }, "Capability": { "description": "A specific permission that a node might need to do its job.\n\nEach value represents one kind of action (like reading from the network\nor writing to the filesystem). Authored tool bindings declare the\ncapabilities they require, and policies use these values to control\nwhat nodes are allowed to do; the policy engine republishes the enum\nfrom :mod:`zeroth.governance.policy.models`.", "enum": [ "network_read", "network_write", "filesystem_read", "filesystem_write", "secret_access", "external_api_call", "process_spawn", "memory_read", "memory_write" ], "title": "Capability", "type": "string" }, "CertificationBlocker": { "additionalProperties": false, "description": "Machine-readable blocker paired with a console remediation.", "properties": { "code": { "title": "Code", "type": "string" }, "message": { "title": "Message", "type": "string" }, "overridable": { "default": false, "title": "Overridable", "type": "boolean" }, "remediation": { "title": "Remediation", "type": "string" } }, "required": [ "code", "message", "remediation" ], "title": "CertificationBlocker", "type": "object" }, "CertificationEvaluation": { "additionalProperties": false, "description": "Central readiness decision reused by API, probes, metrics, and console.", "properties": { "blockers": { "default": [], "items": { "$ref": "#/components/schemas/CertificationBlocker" }, "title": "Blockers", "type": "array" }, "certification_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Certification Id" }, "override_active": { "default": false, "title": "Override Active", "type": "boolean" }, "production_ready": { "title": "Production Ready", "type": "boolean" }, "state": { "anyOf": [ { "$ref": "#/components/schemas/CertificationState" }, { "type": "null" } ] }, "test_deployable": { "title": "Test Deployable", "type": "boolean" } }, "required": [ "test_deployable", "production_ready" ], "title": "CertificationEvaluation", "type": "object" }, "CertificationEvent": { "additionalProperties": false, "description": "One append-only certification audit event.", "properties": { "actor_id": { "title": "Actor Id", "type": "string" }, "certification_id": { "title": "Certification Id", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "event_id": { "title": "Event Id", "type": "string" }, "event_type": { "title": "Event Type", "type": "string" }, "override_expires_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "title": "Override Expires At" }, "promotion_target_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Promotion Target Key" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" }, "scopes": { "default": [], "items": { "$ref": "#/components/schemas/OverrideScope" }, "title": "Scopes", "type": "array" }, "state": { "$ref": "#/components/schemas/CertificationState" }, "tenant_id": { "title": "Tenant Id", "type": "string" }, "workspace_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workspace Id" } }, "required": [ "event_id", "certification_id", "tenant_id", "event_type", "state", "actor_id", "created_at" ], "title": "CertificationEvent", "type": "object" }, "CertificationOverride": { "additionalProperties": false, "description": "Time-bound administrative exception retained with the certification.", "properties": { "actor_id": { "maxLength": 255, "minLength": 1, "title": "Actor Id", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "expires_at": { "format": "date-time", "title": "Expires At", "type": "string" }, "reason": { "maxLength": 500, "minLength": 1, "title": "Reason", "type": "string" }, "scopes": { "items": { "$ref": "#/components/schemas/OverrideScope" }, "minItems": 1, "title": "Scopes", "type": "array" } }, "required": [ "scopes", "reason", "actor_id", "created_at", "expires_at" ], "title": "CertificationOverride", "type": "object" }, "CertificationOverrideRequest": { "additionalProperties": false, "description": "Authorized, scoped, expiring exception request.", "properties": { "expires_at": { "format": "date-time", "title": "Expires At", "type": "string" }, "reason": { "maxLength": 500, "minLength": 1, "title": "Reason", "type": "string" }, "scopes": { "items": { "$ref": "#/components/schemas/OverrideScope" }, "minItems": 1, "title": "Scopes", "type": "array" } }, "required": [ "scopes", "reason", "expires_at" ], "title": "CertificationOverrideRequest", "type": "object" }, "CertificationResponse": { "additionalProperties": false, "description": "One certification with the central decision and audit evidence.", "properties": { "app_commit": { "title": "App Commit", "type": "string" }, "app_name": { "title": "App Name", "type": "string" }, "certification_id": { "title": "Certification Id", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "evaluation": { "$ref": "#/components/schemas/CertificationEvaluation" }, "events": { "items": { "$ref": "#/components/schemas/CertificationEvent" }, "title": "Events", "type": "array" }, "image_digest": { "title": "Image Digest", "type": "string" }, "override": { "anyOf": [ { "$ref": "#/components/schemas/CertificationOverride" }, { "type": "null" } ] }, "promotion_target_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Promotion Target Key" }, "state": { "title": "State", "type": "string" }, "tenant_id": { "title": "Tenant Id", "type": "string" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" }, "workspace_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workspace Id" } }, "required": [ "certification_id", "tenant_id", "workspace_id", "app_name", "app_commit", "image_digest", "state", "promotion_target_key", "override", "evaluation", "events", "created_at", "updated_at" ], "title": "CertificationResponse", "type": "object" }, "CertificationState": { "description": "Lifecycle state for one immutable candidate identity.", "enum": [ "buildable", "test_deployable", "certified", "promoted", "revoked" ], "title": "CertificationState", "type": "string" }, "ChildRunSummaryResponse": { "additionalProperties": false, "description": "Payload-free direct-child identity exposed for lineage inspection.", "properties": { "campaign_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Campaign Id" }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "graph_version_ref": { "title": "Graph Version Ref", "type": "string" }, "parent_run_id": { "title": "Parent Run Id", "type": "string" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "$ref": "#/components/schemas/RunPublicStatus" }, "thread_id": { "title": "Thread Id", "type": "string" } }, "required": [ "run_id", "status", "deployment_ref", "graph_version_ref", "thread_id", "parent_run_id" ], "title": "ChildRunSummaryResponse", "type": "object" }, "Condition": { "description": "A rule that decides whether an edge should be followed.\n\nConditions are attached to edges and evaluated at runtime to determine\nwhich path the execution should take next.", "properties": { "allow_cycle_traversal": { "default": false, "title": "Allow Cycle Traversal", "type": "boolean" }, "branch_rule": { "default": "expression", "enum": [ "all", "any", "expression" ], "title": "Branch Rule", "type": "string" }, "expression": { "title": "Expression", "type": "string" }, "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "operand_refs": { "items": { "type": "string" }, "title": "Operand Refs", "type": "array" } }, "required": [ "expression" ], "title": "Condition", "type": "object" }, "ConnectorCreateRequest": { "additionalProperties": false, "description": "Payload for creating a runtime-managed connector.", "properties": { "backend_type": { "title": "Backend Type", "type": "string" }, "params": { "additionalProperties": true, "title": "Params", "type": "object" }, "ref": { "title": "Ref", "type": "string" } }, "required": [ "ref", "backend_type" ], "title": "ConnectorCreateRequest", "type": "object" }, "ConnectorSummaryResponse": { "additionalProperties": false, "description": "One registered memory connector, as shown in the console.", "properties": { "backend": { "title": "Backend", "type": "string" }, "backend_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Backend Type" }, "connector_type": { "title": "Connector Type", "type": "string" }, "params": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Params" }, "ref": { "title": "Ref", "type": "string" }, "scope": { "title": "Scope", "type": "string" }, "source": { "default": "env", "title": "Source", "type": "string" } }, "required": [ "ref", "connector_type", "scope", "backend" ], "title": "ConnectorSummaryResponse", "type": "object" }, "ConnectorTestRequest": { "additionalProperties": false, "description": "Optional cost boundary for a connector test that may call a provider.", "properties": { "campaign_id": { "maxLength": 128, "minLength": 1, "title": "Campaign Id", "type": "string" }, "max_cost_usd": { "anyOf": [ { "exclusiveMinimum": 0.0, "type": "number" }, { "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$", "type": "string" } ], "title": "Max Cost Usd" }, "operation_id": { "maxLength": 128, "minLength": 1, "title": "Operation Id", "type": "string" }, "run_cap_usd": { "anyOf": [ { "exclusiveMinimum": 0.0, "type": "number" }, { "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$", "type": "string" }, { "type": "null" } ], "title": "Run Cap Usd" }, "run_id": { "anyOf": [ { "maxLength": 128, "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, "required": [ "campaign_id", "operation_id", "max_cost_usd" ], "title": "ConnectorTestRequest", "type": "object" }, "ConnectorTestResponse": { "additionalProperties": false, "description": "Result of a live connectivity probe against a registered connector.", "properties": { "audit_event_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Audit Event Id" }, "campaign_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Campaign Id" }, "cleanup_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cleanup Status" }, "cost_event_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cost Event Id" }, "cost_measurement": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cost Measurement" }, "detail": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Detail" }, "estimated_cost_usd": { "anyOf": [ { "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$", "type": "string" }, { "type": "null" } ], "title": "Estimated Cost Usd" }, "latency_ms": { "title": "Latency Ms", "type": "number" }, "ok": { "title": "Ok", "type": "boolean" }, "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Operation Id" }, "provider_request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider Request Id" } }, "required": [ "ok", "latency_ms" ], "title": "ConnectorTestResponse", "type": "object" }, "ConnectorUpdateRequest": { "additionalProperties": false, "description": "Payload for reconfiguring an existing runtime-managed connector.", "properties": { "backend_type": { "title": "Backend Type", "type": "string" }, "params": { "additionalProperties": true, "title": "Params", "type": "object" } }, "required": [ "backend_type" ], "title": "ConnectorUpdateRequest", "type": "object" }, "ConstantMappingOperation": { "additionalProperties": false, "description": "Set a target field to a fixed value, ignoring the input entirely.\n\nUseful when you always want a specific value in the output regardless of\nwhat the input contains.", "properties": { "operation": { "const": "constant", "default": "constant", "title": "Operation", "type": "string" }, "target_path": { "title": "Target Path", "type": "string" }, "value": { "title": "Value" } }, "required": [ "target_path", "value" ], "title": "ConstantMappingOperation", "type": "object" }, "CreateContractRequest": { "description": "Request body for registering a schema-only contract from the console.", "properties": { "json_schema": { "additionalProperties": true, "title": "Json Schema", "type": "object" }, "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "name": { "maxLength": 200, "minLength": 1, "pattern": "^\\S+$", "title": "Name", "type": "string" } }, "required": [ "name", "json_schema" ], "title": "CreateContractRequest", "type": "object" }, "CreateDeploymentRequest": { "additionalProperties": false, "description": "Request body for POST /v1/deployments.", "properties": { "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "graph_id": { "title": "Graph Id", "type": "string" }, "graph_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Graph Version" } }, "required": [ "deployment_ref", "graph_id" ], "title": "CreateDeploymentRequest", "type": "object" }, "CreateSubscriptionRequest": { "additionalProperties": false, "description": "Request body for creating a webhook subscription.", "properties": { "deployment_ref": { "maxLength": 512, "minLength": 1, "title": "Deployment Ref", "type": "string" }, "event_types": { "items": { "$ref": "#/components/schemas/WebhookEventType" }, "maxItems": 5, "minItems": 1, "title": "Event Types", "type": "array" }, "target_url": { "maxLength": 2048, "minLength": 1, "title": "Target Url", "type": "string" }, "tenant_id": { "default": "default", "maxLength": 512, "minLength": 1, "title": "Tenant Id", "type": "string" } }, "required": [ "deployment_ref", "target_url", "event_types" ], "title": "CreateSubscriptionRequest", "type": "object" }, "CreateTemplateRequest": { "additionalProperties": false, "description": "Request body for creating a new template.", "properties": { "description": { "default": "", "maxLength": 2000, "title": "Description", "type": "string" }, "name": { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._-]*$", "title": "Name", "type": "string" }, "template_str": { "maxLength": 100000, "minLength": 1, "title": "Template Str", "type": "string" }, "variables": { "items": { "type": "string" }, "maxItems": 256, "title": "Variables", "type": "array" }, "version": { "default": 1, "maximum": 1000000.0, "minimum": 1.0, "title": "Version", "type": "integer" } }, "required": [ "name", "template_str" ], "title": "CreateTemplateRequest", "type": "object" }, "CreateWorkflowRequest": { "description": "Request body for creating a new workflow.", "properties": { "name": { "maxLength": 200, "minLength": 1, "title": "Name", "type": "string" } }, "required": [ "name" ], "title": "CreateWorkflowRequest", "type": "object" }, "DecisionKind": { "description": "The verdicts the decision service can return for one attempted call.\n\nThe values match\n``zeroth.integrations.langgraph._tool_types.ToolDecisionKind`` exactly, so\nthe SDK-side client can map a response onto its own verdict without a\ntranslation table. ``REQUIRE_APPROVAL`` is a verdict of its own rather than\na flavour of deny: a call waiting on a human has not been refused, and\ncollapsing the two would lose the distinction an auditor needs.", "enum": [ "allow", "deny", "require_approval" ], "title": "DecisionKind", "type": "string" }, "DecisionRequestV1": { "additionalProperties": false, "description": "Authenticated, versioned decision request.", "properties": { "action": { "$ref": "#/components/schemas/ActionDescriptorV1" }, "context_token": { "minLength": 1, "title": "Context Token", "type": "string" }, "correlation_id": { "minLength": 1, "title": "Correlation Id", "type": "string" }, "deployment_ref": { "minLength": 1, "title": "Deployment Ref", "type": "string" }, "idempotency_key": { "minLength": 1, "title": "Idempotency Key", "type": "string" }, "inventory_fingerprint": { "minLength": 1, "title": "Inventory Fingerprint", "type": "string" }, "policy_version": { "minLength": 1, "title": "Policy Version", "type": "string" }, "principal_id": { "minLength": 1, "title": "Principal Id", "type": "string" }, "run_id": { "minLength": 1, "title": "Run Id", "type": "string" }, "schema_version": { "const": 1, "default": 1, "title": "Schema Version", "type": "integer" }, "tenant_id": { "minLength": 1, "title": "Tenant Id", "type": "string" } }, "required": [ "idempotency_key", "context_token", "tenant_id", "principal_id", "deployment_ref", "correlation_id", "run_id", "policy_version", "inventory_fingerprint", "action" ], "title": "DecisionRequestV1", "type": "object" }, "DecisionResponse": { "additionalProperties": false, "description": "One versioned verdict as it was recorded and is re-served.\n\nAttributes:\n schema_version: The wire version, pinned to ``1``.\n decision_id: The stored decision's identity. A replay returns the\n original, so two calls sharing an id shared a decision.\n kind: The verdict.\n reason_code: The registered audit term the verdict is recorded under.\n approval_ref: The approval the call waits on, when applicable.\n policy_version: The policy revision the verdict was reached against.\n tenant_id: The tenant the decision is scoped to.\n issued_at: When the decision was first recorded -- not when it was\n re-served, so a replay does not look like a fresh evaluation.", "properties": { "approval_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Approval Ref" }, "decision_id": { "title": "Decision Id", "type": "string" }, "issued_at": { "format": "date-time", "title": "Issued At", "type": "string" }, "kind": { "$ref": "#/components/schemas/DecisionKind" }, "policy_version": { "title": "Policy Version", "type": "string" }, "reason_code": { "title": "Reason Code", "type": "string" }, "schema_version": { "const": 1, "default": 1, "title": "Schema Version", "type": "integer" }, "tenant_id": { "title": "Tenant Id", "type": "string" } }, "required": [ "decision_id", "kind", "reason_code", "policy_version", "tenant_id", "issued_at" ], "title": "DecisionResponse", "type": "object" }, "DecisionResponseV1": { "additionalProperties": false, "description": "Stable idempotent decision result.", "properties": { "approval_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Approval Ref" }, "decision": { "$ref": "#/components/schemas/ToolDecisionKind" }, "decision_id": { "title": "Decision Id", "type": "string" }, "idempotency_key": { "title": "Idempotency Key", "type": "string" }, "policy_version": { "title": "Policy Version", "type": "string" }, "reason_code": { "title": "Reason Code", "type": "string" }, "schema_version": { "const": 1, "default": 1, "title": "Schema Version", "type": "integer" } }, "required": [ "decision_id", "idempotency_key", "decision", "reason_code", "policy_version" ], "title": "DecisionResponseV1", "type": "object" }, "DecisionSubmission": { "additionalProperties": false, "description": "One tool call submitted for a verdict.\n\nThe client half of\n:class:`~zeroth.governance.decisions.request.DecisionRequest`: the action,\nthe deployment it was made from, and the replay token. ``tenant_id`` and\n``principal_id`` are deliberately absent -- the route supplies them from\nthe authenticated principal.", "properties": { "action": { "$ref": "#/components/schemas/NormalizedAction" }, "deployment_ref": { "minLength": 1, "title": "Deployment Ref", "type": "string" }, "idempotency_key": { "minLength": 1, "title": "Idempotency Key", "type": "string" }, "policy_bindings": { "default": [], "items": { "type": "string" }, "title": "Policy Bindings", "type": "array" }, "schema_version": { "const": 1, "default": 1, "title": "Schema Version", "type": "integer" } }, "required": [ "deployment_ref", "action", "idempotency_key" ], "title": "DecisionSubmission", "type": "object" }, "DefaultMappingOperation": { "additionalProperties": false, "description": "Copy a value from the input, falling back to a default if it is missing.\n\nIf ``source_path`` is ``None``, the default value is always used. Otherwise\nthe source is looked up first, and the default is only used when the source\npath does not exist in the input.", "properties": { "default_value": { "title": "Default Value" }, "operation": { "const": "default", "default": "default", "title": "Operation", "type": "string" }, "source_path": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Path" }, "target_path": { "title": "Target Path", "type": "string" } }, "required": [ "target_path", "default_value" ], "title": "DefaultMappingOperation", "type": "object" }, "DependencyStatus": { "additionalProperties": false, "description": "Status of a single dependency check.", "properties": { "detail": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Detail" }, "latency_ms": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Latency Ms" }, "status": { "title": "Status", "type": "string" } }, "required": [ "status" ], "title": "DependencyStatus", "type": "object" }, "DeploymentAttestationResponse": { "additionalProperties": false, "description": "Stable attestation payload for a deployment snapshot.", "properties": { "attestation_algorithm": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Attestation Algorithm" }, "attestation_digest": { "title": "Attestation Digest", "type": "string" }, "attestation_payload_version": { "default": 1, "minimum": 1.0, "title": "Attestation Payload Version", "type": "integer" }, "attestation_signature": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Attestation Signature" }, "attestation_signing_key_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Attestation Signing Key Id" }, "contract_snapshot_digest": { "title": "Contract Snapshot Digest", "type": "string" }, "created_at": { "title": "Created At", "type": "string" }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "deployment_version": { "title": "Deployment Version", "type": "integer" }, "engine_mode": { "default": "legacy", "title": "Engine Mode", "type": "string" }, "entry_input_contract_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entry Input Contract Ref" }, "entry_input_contract_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Entry Input Contract Version" }, "entry_output_contract_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entry Output Contract Ref" }, "entry_output_contract_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Entry Output Contract Version" }, "graph_id": { "title": "Graph Id", "type": "string" }, "graph_snapshot_digest": { "title": "Graph Snapshot Digest", "type": "string" }, "graph_version": { "title": "Graph Version", "type": "integer" }, "graph_version_ref": { "title": "Graph Version Ref", "type": "string" }, "settings_snapshot_digest": { "title": "Settings Snapshot Digest", "type": "string" } }, "required": [ "deployment_ref", "deployment_version", "graph_id", "graph_version", "graph_version_ref", "graph_snapshot_digest", "contract_snapshot_digest", "settings_snapshot_digest", "created_at", "attestation_digest" ], "title": "DeploymentAttestationResponse", "type": "object" }, "DeploymentCostResponse": { "additionalProperties": false, "description": "Response for GET /v1/deployments/{deployment_ref}/cost (per D-15).", "properties": { "active_exposure_usd": { "default": 0.0, "title": "Active Exposure Usd", "type": "number" }, "ambiguous_exposure_usd": { "default": 0.0, "title": "Ambiguous Exposure Usd", "type": "number" }, "currency": { "default": "USD", "title": "Currency", "type": "string" }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "estimated_spend_usd": { "default": 0.0, "title": "Estimated Spend Usd", "type": "number" }, "paid_spend_usd": { "default": 0.0, "title": "Paid Spend Usd", "type": "number" }, "total_cost_usd": { "title": "Total Cost Usd", "type": "number" }, "unmeasured_spend_usd": { "default": 0.0, "title": "Unmeasured Spend Usd", "type": "number" } }, "required": [ "deployment_ref", "total_cost_usd" ], "title": "DeploymentCostResponse", "type": "object" }, "DeploymentEnforcementStatus": { "additionalProperties": false, "description": "A deployment's last-known governance level, recomputed server-side.", "properties": { "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "governance_level": { "title": "Governance Level", "type": "string" }, "observed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "title": "Observed At" }, "stale_after_seconds": { "title": "Stale After Seconds", "type": "number" } }, "required": [ "deployment_ref", "governance_level", "stale_after_seconds" ], "title": "DeploymentEnforcementStatus", "type": "object" }, "DeploymentEngineMode": { "description": "Immutable execution engine selected when a deployment is published.", "enum": [ "legacy", "token" ], "title": "DeploymentEngineMode", "type": "string" }, "DeploymentEvidenceResponse": { "additionalProperties": false, "description": "Review-friendly evidence bundle for a deployment snapshot.", "properties": { "approvals": { "items": { "$ref": "#/components/schemas/ApprovalRecord" }, "title": "Approvals", "type": "array" }, "audits": { "items": { "$ref": "#/components/schemas/NodeAuditRecord" }, "title": "Audits", "type": "array" }, "deployment": { "$ref": "#/components/schemas/DeploymentVersionMetadataResponse" }, "policy_events": { "items": { "type": "string" }, "title": "Policy Events", "type": "array" }, "run_ids": { "items": { "type": "string" }, "title": "Run Ids", "type": "array" }, "summary": { "$ref": "#/components/schemas/EvidenceSummaryResponse" } }, "required": [ "deployment", "summary" ], "title": "DeploymentEvidenceResponse", "type": "object" }, "DeploymentResultErrorStateSchemaResponse": { "additionalProperties": false, "description": "Combined terminal result and error schema for a deployed version.", "properties": { "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "deployment_version": { "title": "Deployment Version", "type": "integer" }, "error_state_schema": { "additionalProperties": true, "title": "Error State Schema", "type": "object" }, "graph_version_ref": { "title": "Graph Version Ref", "type": "string" }, "result_contract": { "$ref": "#/components/schemas/PublicContractSchemaResponse" }, "result_state_schema": { "additionalProperties": true, "title": "Result State Schema", "type": "object" } }, "required": [ "deployment_ref", "deployment_version", "graph_version_ref", "result_contract" ], "title": "DeploymentResultErrorStateSchemaResponse", "type": "object" }, "DeploymentStatus": { "description": "Lifecycle status for immutable deployment versions.", "enum": [ "active", "superseded" ], "title": "DeploymentStatus", "type": "string" }, "DeploymentSummaryResponse": { "additionalProperties": false, "description": "One persisted deployment version, as shown in the console.", "properties": { "created_at": { "title": "Created At", "type": "string" }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "graph_version_ref": { "title": "Graph Version Ref", "type": "string" }, "serving": { "title": "Serving", "type": "boolean" }, "status": { "title": "Status", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "deployment_ref", "version", "graph_version_ref", "status", "serving", "created_at" ], "title": "DeploymentSummaryResponse", "type": "object" }, "DeploymentVersionMetadataResponse": { "additionalProperties": false, "description": "Public metadata for one deployed version.", "properties": { "attestation_payload_version": { "minimum": 1.0, "title": "Attestation Payload Version", "type": "integer" }, "attestation_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Attestation Ref" }, "audit_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Audit Ref" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "deployment_settings_snapshot": { "additionalProperties": true, "title": "Deployment Settings Snapshot", "type": "object" }, "deployment_version": { "title": "Deployment Version", "type": "integer" }, "engine_mode": { "$ref": "#/components/schemas/DeploymentEngineMode" }, "entry_input_contract_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entry Input Contract Ref" }, "entry_input_contract_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Entry Input Contract Version" }, "entry_output_contract_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entry Output Contract Ref" }, "entry_output_contract_version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Entry Output Contract Version" }, "evidence_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evidence Ref" }, "graph_id": { "title": "Graph Id", "type": "string" }, "graph_version": { "title": "Graph Version", "type": "integer" }, "graph_version_ref": { "title": "Graph Version Ref", "type": "string" }, "status": { "$ref": "#/components/schemas/DeploymentStatus" }, "timeline_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Timeline Ref" }, "updated_at": { "format": "date-time", "title": "Updated At", "type": "string" } }, "required": [ "deployment_ref", "deployment_version", "graph_id", "graph_version", "graph_version_ref", "engine_mode", "attestation_payload_version", "status", "created_at", "updated_at" ], "title": "DeploymentVersionMetadataResponse", "type": "object" }, "DiscoveredToolResponse": { "additionalProperties": false, "description": "One tool a live server advertised, with the digest an import would pin.", "properties": { "description": { "title": "Description", "type": "string" }, "input_schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Input Schema" }, "name": { "title": "Name", "type": "string" }, "schema_hash": { "title": "Schema Hash", "type": "string" } }, "required": [ "name", "description", "schema_hash" ], "title": "DiscoveredToolResponse", "type": "object" }, "EconomicsConfigurationResponse": { "additionalProperties": false, "description": "Non-secret runtime economics controls visible to scoped operators.", "properties": { "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "failure_mode": { "enum": [ "fail_open", "fail_closed" ], "title": "Failure Mode", "type": "string" }, "per_run_cap_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Per Run Cap Usd" }, "source": { "const": "service_runtime", "default": "service_runtime", "title": "Source", "type": "string" }, "tenant_id": { "title": "Tenant Id", "type": "string" } }, "required": [ "tenant_id", "deployment_ref", "per_run_cap_usd", "failure_mode" ], "title": "EconomicsConfigurationResponse", "type": "object" }, "EdgeMapping": { "additionalProperties": false, "description": "A complete set of mapping operations that describe one edge's data transform.\n\nAn ``EdgeMapping`` groups together all the individual operations that should\nrun when data crosses a particular edge in the graph.", "properties": { "operations": { "items": { "discriminator": { "mapping": { "constant": "#/components/schemas/ConstantMappingOperation", "default": "#/components/schemas/DefaultMappingOperation", "passthrough": "#/components/schemas/PassthroughMappingOperation", "rename": "#/components/schemas/RenameMappingOperation", "transform": "#/components/schemas/TransformMappingOperation" }, "propertyName": "operation" }, "oneOf": [ { "$ref": "#/components/schemas/PassthroughMappingOperation" }, { "$ref": "#/components/schemas/RenameMappingOperation" }, { "$ref": "#/components/schemas/ConstantMappingOperation" }, { "$ref": "#/components/schemas/DefaultMappingOperation" }, { "$ref": "#/components/schemas/TransformMappingOperation" } ] }, "title": "Operations", "type": "array" } }, "title": "EdgeMapping", "type": "object" }, "EffectiveGuardrailSettings": { "additionalProperties": false, "description": "Concrete product defaults after tenant and deployment composition.", "properties": { "backpressure_queue_depth": { "default": 100, "maximum": 1000000.0, "minimum": 1.0, "title": "Backpressure Queue Depth", "type": "integer" }, "max_concurrency": { "default": 8, "maximum": 10000.0, "minimum": 1.0, "title": "Max Concurrency", "type": "integer" }, "quota_daily_limit": { "anyOf": [ { "maximum": 1000000000000.0, "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Quota Daily Limit" }, "rate_limit_burst": { "default": 0, "maximum": 1000000.0, "minimum": 0.0, "title": "Rate Limit Burst", "type": "number" }, "rate_limit_capacity": { "default": 10, "maximum": 1000000.0, "minimum": 1.0, "title": "Rate Limit Capacity", "type": "number" }, "rate_limit_refill_rate": { "default": 1, "maximum": 100000.0, "minimum": 1.1574074074074073e-05, "title": "Rate Limit Refill Rate", "type": "number" } }, "title": "EffectiveGuardrailSettings", "type": "object" }, "ErasureHistoryEntry": { "additionalProperties": false, "description": "Tenant-scoped durable Retention activity exposed for operator inspection.", "properties": { "action": { "title": "Action", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "detail": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Detail" }, "log_id": { "title": "Log Id", "type": "string" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" }, "run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, "required": [ "log_id", "action", "created_at" ], "title": "ErasureHistoryEntry", "type": "object" }, "ErasureRequestBody": { "additionalProperties": false, "description": "Request body for POST /retention/erasure-requests.\n\nExactly one of ``run_id`` (erase one run) or ``tenant_id`` (erase every\nnon-held run for the tenant) must be supplied.", "properties": { "run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" }, "tenant_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tenant Id" } }, "title": "ErasureRequestBody", "type": "object" }, "ErasureResponse": { "additionalProperties": false, "description": "Result of an erasure request (one or many runs).", "properties": { "reason": { "title": "Reason", "type": "string" }, "runs": { "items": { "$ref": "#/components/schemas/ErasureRunResult" }, "title": "Runs", "type": "array" } }, "required": [ "reason" ], "title": "ErasureResponse", "type": "object" }, "ErasureRunResult": { "additionalProperties": false, "description": "Per-run erasure counts.", "properties": { "artifacts_deleted": { "default": 0, "title": "Artifacts Deleted", "type": "integer" }, "audits_erased": { "default": 0, "title": "Audits Erased", "type": "integer" }, "authorization_log_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization Log Id" }, "checkpoints_deleted": { "default": 0, "title": "Checkpoints Deleted", "type": "integer" }, "cleanup_state": { "enum": [ "complete", "failed", "pending" ], "title": "Cleanup State", "type": "string" }, "econ_events_deleted": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Econ Events Deleted" }, "retry_log_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Retry Log Id" }, "run_id": { "title": "Run Id", "type": "string" }, "run_redacted": { "default": false, "title": "Run Redacted", "type": "boolean" } }, "required": [ "run_id", "cleanup_state" ], "title": "ErasureRunResult", "type": "object" }, "EvidenceSummaryResponse": { "additionalProperties": false, "description": "Aggregated governance counts for an evidence bundle.", "properties": { "approval_count": { "default": 0, "title": "Approval Count", "type": "integer" }, "audit_count": { "default": 0, "title": "Audit Count", "type": "integer" }, "cost_event_count": { "default": 0, "title": "Cost Event Count", "type": "integer" }, "cost_identity_state": { "default": "not_applicable_no_priced_call", "title": "Cost Identity State", "type": "string" }, "memory_interaction_count": { "default": 0, "title": "Memory Interaction Count", "type": "integer" }, "priced_call_count": { "default": 0, "title": "Priced Call Count", "type": "integer" }, "reconciliation_state": { "default": "reconciled_zero_activity", "title": "Reconciliation State", "type": "string" }, "tool_call_count": { "default": 0, "title": "Tool Call Count", "type": "integer" }, "total_cost_usd": { "default": 0.0, "title": "Total Cost Usd", "type": "number" } }, "title": "EvidenceSummaryResponse", "type": "object" }, "ExperimentCallEvidence": { "additionalProperties": false, "description": "Credential-free provider identity and economics for one measured call.", "properties": { "audit_event_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Audit Event Id" }, "cache_hit": { "title": "Cache Hit", "type": "boolean" }, "cleanup_status": { "title": "Cleanup Status", "type": "string" }, "cost_event_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cost Event Id" }, "cost_measurement": { "title": "Cost Measurement", "type": "string" }, "estimated_cost_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Estimated Cost Usd" }, "input_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Input Tokens" }, "measured_cost_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Measured Cost Usd" }, "model": { "title": "Model", "type": "string" }, "operation_id": { "title": "Operation Id", "type": "string" }, "output_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Output Tokens" }, "provider_call_attempted": { "title": "Provider Call Attempted", "type": "boolean" }, "provider_request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider Request Id" } }, "required": [ "operation_id", "model", "cost_measurement", "cleanup_status", "provider_call_attempted", "cache_hit" ], "title": "ExperimentCallEvidence", "type": "object" }, "ExperimentExecutionEvidence": { "additionalProperties": false, "description": "Additive run/cost correlation returned by a live measured experiment.", "properties": { "calls": { "items": { "$ref": "#/components/schemas/ExperimentCallEvidence" }, "title": "Calls", "type": "array" }, "campaign_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Campaign Id" }, "estimated_cost_usd": { "default": 0.0, "title": "Estimated Cost Usd", "type": "number" }, "measured_cost_usd": { "default": 0.0, "title": "Measured Cost Usd", "type": "number" }, "provider_call_count": { "default": 0, "title": "Provider Call Count", "type": "integer" }, "run_id": { "title": "Run Id", "type": "string" } }, "required": [ "run_id" ], "title": "ExperimentExecutionEvidence", "type": "object" }, "ExperimentReport": { "additionalProperties": false, "description": "Result of a measured right-sizing experiment for one node.", "properties": { "cases": { "default": 0, "title": "Cases", "type": "integer" }, "execution": { "anyOf": [ { "$ref": "#/components/schemas/ExperimentExecutionEvidence" }, { "type": "null" } ] }, "harvest": { "anyOf": [ { "$ref": "#/components/schemas/HarvestStats" }, { "type": "null" } ] }, "incumbent": { "title": "Incumbent", "type": "string" }, "incumbent_self_equivalence": { "default": 0.0, "title": "Incumbent Self Equivalence", "type": "number" }, "mean_input_tokens": { "default": 0.0, "title": "Mean Input Tokens", "type": "number" }, "mean_output_tokens": { "default": 0.0, "title": "Mean Output Tokens", "type": "number" }, "min_cases": { "default": 5, "title": "Min Cases", "type": "integer" }, "mode": { "default": "equivalence", "title": "Mode", "type": "string" }, "node_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Node Id" }, "note": { "default": "", "title": "Note", "type": "string" }, "outcomes": { "items": { "$ref": "#/components/schemas/CandidateOutcome" }, "title": "Outcomes", "type": "array" }, "recommended_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Recommended Model" }, "token_profile_measured": { "default": false, "title": "Token Profile Measured", "type": "boolean" }, "tolerance_pct": { "default": 5.0, "title": "Tolerance Pct", "type": "number" }, "verdict": { "default": "none", "title": "Verdict", "type": "string" } }, "required": [ "incumbent" ], "title": "ExperimentReport", "type": "object" }, "ExperimentRequest": { "additionalProperties": false, "description": "Request body for POST /v1/econ/rightsizing/experiment (measured right-sizing).\n\nReplays this node's real audit-trail inputs through cheaper candidate models and scores\nequivalence to the incumbent. Runs real LLM calls, so the sample is capped small \u2014 the\nresult is a *flagged* lead below ``min_cases``, not a *confirmed* switch.", "properties": { "incumbent": { "description": "Current model, e.g. openai/gpt-4o", "minLength": 1, "title": "Incumbent", "type": "string" }, "instruction": { "description": "The agent's system instruction", "minLength": 1, "title": "Instruction", "type": "string" }, "judge_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Judge Model" }, "max_candidates": { "default": 2, "maximum": 6.0, "minimum": 1.0, "title": "Max Candidates", "type": "integer" }, "max_cases": { "default": 5, "maximum": 25.0, "minimum": 1.0, "title": "Max Cases", "type": "integer" }, "min_cases": { "default": 5, "maximum": 50.0, "minimum": 1.0, "title": "Min Cases", "type": "integer" }, "mode": { "default": "equivalence", "enum": [ "equivalence", "correctness" ], "title": "Mode", "type": "string" }, "needs_tools": { "default": false, "title": "Needs Tools", "type": "boolean" }, "needs_vision": { "default": false, "title": "Needs Vision", "type": "boolean" }, "node_id": { "minLength": 1, "title": "Node Id", "type": "string" }, "source_deployment_ref": { "anyOf": [ { "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Source Deployment Ref" }, "tolerance_pct": { "default": 5.0, "maximum": 100.0, "minimum": 0.0, "title": "Tolerance Pct", "type": "number" } }, "required": [ "node_id", "incumbent", "instruction" ], "title": "ExperimentRequest", "type": "object" }, "GovernanceLevel": { "description": "Cumulative governance capability supported by evidence.", "enum": [ "admission", "observed", "enforced" ], "title": "GovernanceLevel", "type": "string" }, "GuardrailPolicyPatch": { "additionalProperties": false, "description": "A bounded partial policy; explicitly supplied null quota means unlimited.", "properties": { "backpressure_queue_depth": { "anyOf": [ { "maximum": 1000000.0, "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Backpressure Queue Depth" }, "max_concurrency": { "anyOf": [ { "maximum": 10000.0, "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Max Concurrency" }, "quota_daily_limit": { "anyOf": [ { "maximum": 1000000000000.0, "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Quota Daily Limit" }, "rate_limit_burst": { "anyOf": [ { "maximum": 1000000.0, "minimum": 0.0, "type": "number" }, { "type": "null" } ], "title": "Rate Limit Burst" }, "rate_limit_capacity": { "anyOf": [ { "maximum": 1000000.0, "minimum": 1.0, "type": "number" }, { "type": "null" } ], "title": "Rate Limit Capacity" }, "rate_limit_refill_rate": { "anyOf": [ { "maximum": 100000.0, "minimum": 1.1574074074074073e-05, "type": "number" }, { "type": "null" } ], "title": "Rate Limit Refill Rate" }, "reset_fields": { "items": { "enum": [ "rate_limit_capacity", "rate_limit_refill_rate", "rate_limit_burst", "quota_daily_limit", "backpressure_queue_depth", "max_concurrency" ], "type": "string" }, "title": "Reset Fields", "type": "array" } }, "title": "GuardrailPolicyPatch", "type": "object" }, "GuardrailPolicyResponse": { "additionalProperties": false, "description": "Latest explicit revisions and their composed effective settings.", "properties": { "deployment_overrides": { "anyOf": [ { "$ref": "#/components/schemas/GuardrailPolicyPatch" }, { "type": "null" } ], "description": "Return the deployment scope's composed active overrides.", "readOnly": true }, "deployment_revision": { "anyOf": [ { "$ref": "#/components/schemas/GuardrailPolicyRevision" }, { "type": "null" } ] }, "effective": { "$ref": "#/components/schemas/EffectiveGuardrailSettings" }, "tenant_overrides": { "anyOf": [ { "$ref": "#/components/schemas/GuardrailPolicyPatch" }, { "type": "null" } ], "description": "Return the tenant scope's composed active overrides.", "readOnly": true }, "tenant_revision": { "anyOf": [ { "$ref": "#/components/schemas/GuardrailPolicyRevision" }, { "type": "null" } ] } }, "required": [ "tenant_revision", "deployment_revision", "effective", "tenant_overrides", "deployment_overrides" ], "title": "GuardrailPolicyResponse", "type": "object" }, "GuardrailPolicyRevision": { "additionalProperties": false, "description": "One immutable operator change in the append-only history.", "properties": { "changed_by": { "title": "Changed By", "type": "string" }, "created_at": { "format": "date-time", "title": "Created At", "type": "string" }, "deployment_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Deployment Ref" }, "policy": { "$ref": "#/components/schemas/GuardrailPolicyPatch" }, "revision_id": { "title": "Revision Id", "type": "string" }, "scope": { "enum": [ "tenant", "deployment" ], "title": "Scope", "type": "string" } }, "required": [ "revision_id", "scope", "deployment_ref", "policy", "changed_by", "created_at" ], "title": "GuardrailPolicyRevision", "type": "object" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "title": "Detail", "type": "array" } }, "title": "HTTPValidationError", "type": "object" }, "HarvestStats": { "additionalProperties": false, "description": "What the audit-trail harvest yielded and dropped.", "properties": { "cases": { "default": 0, "title": "Cases", "type": "integer" }, "mean_input_tokens": { "default": 1000.0, "title": "Mean Input Tokens", "type": "number" }, "mean_output_tokens": { "default": 300.0, "title": "Mean Output Tokens", "type": "number" }, "skipped_empty_output": { "default": 0, "title": "Skipped Empty Output", "type": "integer" }, "skipped_not_success": { "default": 0, "title": "Skipped Not Success", "type": "integer" }, "skipped_other_model": { "default": 0, "title": "Skipped Other Model", "type": "integer" }, "skipped_used_tools": { "default": 0, "title": "Skipped Used Tools", "type": "integer" }, "token_profile_measured": { "default": false, "title": "Token Profile Measured", "type": "boolean" } }, "title": "HarvestStats", "type": "object" }, "HealthResponse": { "additionalProperties": false, "description": "Response payload for the service health endpoint.", "properties": { "audit_delivery": { "anyOf": [ { "$ref": "#/components/schemas/AuditDeliveryHealth" }, { "type": "null" } ] }, "campaign_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Campaign Id" }, "certification": { "anyOf": [ { "$ref": "#/components/schemas/CertificationEvaluation" }, { "type": "null" } ] }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "deployment_version": { "title": "Deployment Version", "type": "integer" }, "graph_version_ref": { "title": "Graph Version Ref", "type": "string" }, "langgraph_gateway": { "anyOf": [ { "$ref": "#/components/schemas/LangGraphGatewayHealth" }, { "type": "null" } ] }, "production_ready": { "default": false, "title": "Production Ready", "type": "boolean" }, "status": { "default": "ok", "title": "Status", "type": "string" } }, "required": [ "deployment_ref", "deployment_version", "graph_version_ref" ], "title": "HealthResponse", "type": "object" }, "HeartbeatAck": { "additionalProperties": false, "description": "The identity and observation time the server recorded for a ping.", "properties": { "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "heartbeat_id": { "title": "Heartbeat Id", "type": "string" }, "observed_at": { "format": "date-time", "title": "Observed At", "type": "string" } }, "required": [ "heartbeat_id", "deployment_ref", "observed_at" ], "title": "HeartbeatAck", "type": "object" }, "HeartbeatSubmission": { "additionalProperties": false, "description": "One liveness ping from a deployment's adapter.", "properties": { "adapter_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Adapter Version" }, "deployment_ref": { "minLength": 1, "title": "Deployment Ref", "type": "string" }, "graph_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Graph Version" }, "reported_level": { "title": "Reported Level", "type": "string" } }, "required": [ "deployment_ref", "reported_level" ], "title": "HeartbeatSubmission", "type": "object" }, "HeartbeatV1": { "additionalProperties": false, "description": "Authenticated liveness signal for one registered adapter inventory.", "properties": { "adapter_version": { "default": "2", "minLength": 1, "title": "Adapter Version", "type": "string" }, "context_token": { "minLength": 1, "title": "Context Token", "type": "string" }, "deployment_ref": { "minLength": 1, "title": "Deployment Ref", "type": "string" }, "graph_version": { "minLength": 1, "title": "Graph Version", "type": "string" }, "inventory_fingerprint": { "minLength": 1, "title": "Inventory Fingerprint", "type": "string" }, "principal_id": { "minLength": 1, "title": "Principal Id", "type": "string" }, "schema_version": { "const": 1, "default": 1, "title": "Schema Version", "type": "integer" }, "tenant_id": { "minLength": 1, "title": "Tenant Id", "type": "string" } }, "required": [ "context_token", "tenant_id", "principal_id", "deployment_ref", "graph_version", "inventory_fingerprint" ], "title": "HeartbeatV1", "type": "object" }, "HumanInteractionType": { "description": "The kind of interaction the system is requesting from a human.\n\nFor example, \"approval\" means the system needs a yes/no decision,\nwhile \"clarification\" means it needs more information to proceed.", "enum": [ "approval", "clarification", "request_input", "notification" ], "title": "HumanInteractionType", "type": "string" }, "IdentityResponse": { "additionalProperties": false, "description": "The scope and roles actually carried by the presented credential.", "properties": { "roles": { "items": { "type": "string" }, "title": "Roles", "type": "array" }, "subject": { "title": "Subject", "type": "string" }, "tenant_id": { "title": "Tenant Id", "type": "string" }, "workspace_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workspace Id" } }, "required": [ "subject", "roles", "tenant_id" ], "title": "IdentityResponse", "type": "object" }, "InventoryAck": { "additionalProperties": false, "description": "The identity the server assigned to a recorded registration.", "properties": { "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "registered_at": { "format": "date-time", "title": "Registered At", "type": "string" }, "registration_id": { "title": "Registration Id", "type": "string" } }, "required": [ "registration_id", "deployment_ref", "registered_at" ], "title": "InventoryAck", "type": "object" }, "InventoryCoverage": { "description": "Whether a tool inventory saw every tool the run can reach.\n\nAn inventory built by walking a compiled graph can miss tools bound at call\ntime, so a consumer must be able to tell \"no dangerous tool is present\" from\n\"no dangerous tool was visible\".", "enum": [ "partial", "complete" ], "title": "InventoryCoverage", "type": "string" }, "InventoryEntryV1": { "additionalProperties": false, "description": "Server-registered identity and contract facts for one tool.", "properties": { "capability_refs": { "default": [], "items": { "type": "string" }, "title": "Capability Refs", "type": "array" }, "contract_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Contract Ref" }, "fingerprint": { "minLength": 1, "title": "Fingerprint", "type": "string" }, "identity_configuration": { "default": [], "items": { "type": "string" }, "title": "Identity Configuration", "type": "array" }, "name": { "minLength": 1, "title": "Name", "type": "string" }, "requires_approval": { "default": false, "title": "Requires Approval", "type": "boolean" }, "side_effect": { "$ref": "#/components/schemas/SideEffectClass", "default": "unknown" } }, "required": [ "name", "fingerprint" ], "title": "InventoryEntryV1", "type": "object" }, "InventoryRegistrationV1": { "additionalProperties": false, "description": "Versioned tool-inventory registration.", "properties": { "adapter_version": { "default": "2", "minLength": 1, "title": "Adapter Version", "type": "string" }, "context_token": { "minLength": 1, "title": "Context Token", "type": "string" }, "coverage": { "$ref": "#/components/schemas/InventoryCoverage" }, "deployment_ref": { "minLength": 1, "title": "Deployment Ref", "type": "string" }, "entries": { "items": { "$ref": "#/components/schemas/InventoryEntryV1" }, "title": "Entries", "type": "array" }, "graph_version": { "minLength": 1, "title": "Graph Version", "type": "string" }, "inventory_fingerprint": { "minLength": 1, "title": "Inventory Fingerprint", "type": "string" }, "principal_id": { "minLength": 1, "title": "Principal Id", "type": "string" }, "schema_version": { "const": 1, "default": 1, "title": "Schema Version", "type": "integer" }, "tenant_id": { "minLength": 1, "title": "Tenant Id", "type": "string" } }, "required": [ "context_token", "tenant_id", "principal_id", "deployment_ref", "graph_version", "coverage", "entries", "inventory_fingerprint" ], "title": "InventoryRegistrationV1", "type": "object" }, "InventorySubmission": { "additionalProperties": false, "description": "A tool inventory an adapter declares for one deployment.", "properties": { "adapter_version": { "title": "Adapter Version", "type": "string" }, "coverage": { "title": "Coverage", "type": "string" }, "deployment_ref": { "minLength": 1, "title": "Deployment Ref", "type": "string" }, "graph_version": { "title": "Graph Version", "type": "string" }, "tools": { "default": [], "items": { "$ref": "#/components/schemas/RegisteredTool" }, "title": "Tools", "type": "array" } }, "required": [ "deployment_ref", "graph_version", "adapter_version", "coverage" ], "title": "InventorySubmission", "type": "object" }, "LangGraphCompatibilityHealth": { "additionalProperties": false, "description": "Evidence from the one bounded Agent Server startup detection.", "properties": { "detected_agent_server": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Detected Agent Server" }, "openapi_fingerprint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Openapi Fingerprint" }, "status": { "title": "Status", "type": "string" }, "tested_agent_server": { "items": { "type": "string" }, "title": "Tested Agent Server", "type": "array" }, "tested_langgraph": { "items": { "type": "string" }, "title": "Tested Langgraph", "type": "array" } }, "required": [ "tested_langgraph", "tested_agent_server", "detected_agent_server", "status", "openapi_fingerprint" ], "title": "LangGraphCompatibilityHealth", "type": "object" }, "LangGraphGatewayHealth": { "additionalProperties": false, "description": "Conservative deployment-level gateway capability surface.", "properties": { "compatibility": { "$ref": "#/components/schemas/LangGraphCompatibilityHealth" }, "enabled": { "default": true, "title": "Enabled", "type": "boolean" }, "governance_level": { "$ref": "#/components/schemas/GovernanceLevel" }, "limitation": { "default": "internal tool calls are not enforced in gateway-only mode", "title": "Limitation", "type": "string" } }, "required": [ "governance_level", "compatibility" ], "title": "LangGraphGatewayHealth", "type": "object" }, "LegalHoldBody": { "additionalProperties": false, "description": "Request body for POST /retention/legal-holds.\n\n``run_id`` omitted places a tenant-wide hold (freezes every run).", "properties": { "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" }, "run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, "title": "LegalHoldBody", "type": "object" }, "LegalHoldResponse": { "additionalProperties": false, "description": "A placed or listed legal hold.", "properties": { "active": { "default": true, "title": "Active", "type": "boolean" }, "hold_id": { "title": "Hold Id", "type": "string" }, "placed_by": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Placed By" }, "reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Reason" }, "run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" }, "tenant_id": { "title": "Tenant Id", "type": "string" } }, "required": [ "hold_id", "tenant_id" ], "title": "LegalHoldResponse", "type": "object" }, "LiveProviderProbe": { "properties": { "audit_event_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Audit Event Id" }, "cleanup_status": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cleanup Status" }, "cost_event_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cost Event Id" }, "cost_measurement": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cost Measurement" }, "error_code": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error Code" }, "estimated_cost_usd": { "anyOf": [ { "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$", "type": "string" }, { "type": "null" } ], "title": "Estimated Cost Usd" }, "input_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Input Tokens" }, "latency_ms": { "title": "Latency Ms", "type": "integer" }, "model": { "title": "Model", "type": "string" }, "ok": { "title": "Ok", "type": "boolean" }, "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Operation Id" }, "output_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Output Tokens" }, "provider_request_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Provider Request Id" } }, "required": [ "model", "ok", "latency_ms" ], "title": "LiveProviderProbe", "type": "object" }, "LiveProviderVerificationRequest": { "properties": { "acknowledge_external_call": { "default": false, "title": "Acknowledge External Call", "type": "boolean" }, "campaign_id": { "anyOf": [ { "maxLength": 128, "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Campaign Id" }, "max_cost_usd": { "anyOf": [ { "exclusiveMinimum": 0.0, "type": "number" }, { "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$", "type": "string" }, { "type": "null" } ], "title": "Max Cost Usd" }, "max_models": { "default": 3, "maximum": 3.0, "minimum": 1.0, "title": "Max Models", "type": "integer" }, "operation_id": { "anyOf": [ { "maxLength": 128, "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Operation Id" }, "run_cap_usd": { "anyOf": [ { "exclusiveMinimum": 0.0, "type": "number" }, { "pattern": "^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$", "type": "string" }, { "type": "null" } ], "title": "Run Cap Usd" }, "run_id": { "anyOf": [ { "maxLength": 128, "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Run Id" }, "timeout_seconds": { "default": 15.0, "maximum": 30.0, "minimum": 1.0, "title": "Timeout Seconds", "type": "number" } }, "title": "LiveProviderVerificationRequest", "type": "object" }, "LiveProviderVerificationResponse": { "properties": { "campaign_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Campaign Id" }, "operation_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Operation Id" }, "probes": { "items": { "$ref": "#/components/schemas/LiveProviderProbe" }, "title": "Probes", "type": "array" }, "verified": { "title": "Verified", "type": "boolean" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id", "verified", "probes" ], "title": "LiveProviderVerificationResponse", "type": "object" }, "LivenessResponse": { "additionalProperties": false, "description": "Response payload for the liveness probe.", "properties": { "status": { "default": "ok", "title": "Status", "type": "string" } }, "title": "LivenessResponse", "type": "object" }, "MCPDiscoverResponse": { "additionalProperties": false, "description": "Result of listing tools on a live server.", "properties": { "latency_ms": { "title": "Latency Ms", "type": "number" }, "ref": { "title": "Ref", "type": "string" }, "tools": { "items": { "$ref": "#/components/schemas/DiscoveredToolResponse" }, "title": "Tools", "type": "array" } }, "required": [ "ref", "tools", "latency_ms" ], "title": "MCPDiscoverResponse", "type": "object" }, "MCPServerCreateRequest": { "additionalProperties": false, "description": "Payload for registering an MCP server.", "properties": { "args": { "items": { "type": "string" }, "title": "Args", "type": "array" }, "command": { "title": "Command", "type": "string" }, "env": { "additionalProperties": { "type": "string" }, "title": "Env", "type": "object" }, "grants": { "items": { "$ref": "#/components/schemas/Capability" }, "title": "Grants", "type": "array" }, "ref": { "title": "Ref", "type": "string" } }, "required": [ "ref", "command" ], "title": "MCPServerCreateRequest", "type": "object" }, "MCPServerResponse": { "additionalProperties": false, "description": "One registered MCP server, as shown to an operator.", "properties": { "args": { "items": { "type": "string" }, "title": "Args", "type": "array" }, "command": { "title": "Command", "type": "string" }, "created_at": { "title": "Created At", "type": "string" }, "env": { "additionalProperties": { "type": "string" }, "title": "Env", "type": "object" }, "grants": { "items": { "$ref": "#/components/schemas/Capability" }, "title": "Grants", "type": "array" }, "ref": { "title": "Ref", "type": "string" }, "updated_at": { "title": "Updated At", "type": "string" } }, "required": [ "ref", "command", "args", "env", "grants", "created_at", "updated_at" ], "title": "MCPServerResponse", "type": "object" }, "MCPServerUpdateRequest": { "additionalProperties": false, "description": "Payload for reconfiguring a registered MCP server.", "properties": { "args": { "items": { "type": "string" }, "title": "Args", "type": "array" }, "command": { "title": "Command", "type": "string" }, "env": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "title": "Env" }, "grants": { "items": { "$ref": "#/components/schemas/Capability" }, "title": "Grants", "type": "array" } }, "required": [ "command" ], "title": "MCPServerUpdateRequest", "type": "object" }, "ManifestDetailResponse": { "additionalProperties": false, "description": "Secret-free executable-unit configuration suitable for operator inspection.", "properties": { "artifact_source_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Artifact Source Kind" }, "capability_requests": { "items": { "type": "string" }, "title": "Capability Requests", "type": "array" }, "content_hash": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Content Hash" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "entrypoint_type": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entrypoint Type" }, "execution_placement": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Execution Placement" }, "input_contract_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Input Contract Ref" }, "input_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Input Mode" }, "input_schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Input Schema" }, "kind": { "title": "Kind", "type": "string" }, "manifest_ref": { "title": "Manifest Ref", "type": "string" }, "onboarding_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Onboarding Mode" }, "output_contract_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Output Contract Ref" }, "output_mode": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Output Mode" }, "output_schema": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Output Schema" }, "resource_limits": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Resource Limits" }, "runtime": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Runtime" }, "side_effect": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Side Effect" }, "timeout_seconds": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Timeout Seconds" }, "version": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Version" } }, "required": [ "manifest_ref", "kind" ], "title": "ManifestDetailResponse", "type": "object" }, "ManifestRunLinkResponse": { "additionalProperties": false, "properties": { "node_id": { "title": "Node Id", "type": "string" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "title": "Status", "type": "string" } }, "required": [ "run_id", "node_id", "status" ], "title": "ManifestRunLinkResponse", "type": "object" }, "ManifestRunListResponse": { "additionalProperties": false, "properties": { "manifest_ref": { "title": "Manifest Ref", "type": "string" }, "runs": { "items": { "$ref": "#/components/schemas/ManifestRunLinkResponse" }, "title": "Runs", "type": "array" } }, "required": [ "manifest_ref" ], "title": "ManifestRunListResponse", "type": "object" }, "ManifestSummaryResponse": { "additionalProperties": false, "description": "One registered executable unit or agent runner, as shown in the console.", "properties": { "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Description" }, "kind": { "title": "Kind", "type": "string" }, "manifest_ref": { "title": "Manifest Ref", "type": "string" }, "runtime": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Runtime" } }, "required": [ "manifest_ref", "kind" ], "title": "ManifestSummaryResponse", "type": "object" }, "MeasurementState": { "description": "Whether a value was observed, derived, or unavailable.", "enum": [ "measured", "estimated", "unmeasured" ], "title": "MeasurementState", "type": "string" }, "MemoryAccessRecord": { "additionalProperties": false, "description": "A record of a single memory read or write during a node execution.\n\nTracks which memory store was accessed, what operation was performed\n(e.g. read, write, delete), and the key/value involved.", "properties": { "connector_type": { "title": "Connector Type", "type": "string" }, "key": { "title": "Key", "type": "string" }, "memory_ref": { "title": "Memory Ref", "type": "string" }, "operation": { "title": "Operation", "type": "string" }, "scope": { "title": "Scope", "type": "string" }, "value": { "anyOf": [ {}, { "type": "null" } ], "title": "Value" } }, "required": [ "memory_ref", "connector_type", "scope", "operation", "key" ], "title": "MemoryAccessRecord", "type": "object" }, "ModelOption": { "additionalProperties": false, "description": "One cheaper, capability-compatible alternative to the incumbent model.", "properties": { "blended_per_mtok_usd": { "title": "Blended Per Mtok Usd", "type": "number" }, "input_per_mtok_usd": { "title": "Input Per Mtok Usd", "type": "number" }, "max_input_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Max Input Tokens" }, "model": { "title": "Model", "type": "string" }, "output_per_mtok_usd": { "title": "Output Per Mtok Usd", "type": "number" }, "provider": { "title": "Provider", "type": "string" }, "same_provider": { "default": false, "title": "Same Provider", "type": "boolean" }, "savings_pct": { "title": "Savings Pct", "type": "number" }, "supports_tools": { "default": false, "title": "Supports Tools", "type": "boolean" }, "supports_vision": { "default": false, "title": "Supports Vision", "type": "boolean" } }, "required": [ "model", "provider", "input_per_mtok_usd", "output_per_mtok_usd", "blended_per_mtok_usd", "savings_pct" ], "title": "ModelOption", "type": "object" }, "NodeAuditRecord": { "additionalProperties": false, "description": "The main audit record for a single node execution.\n\nThis is the core audit object. It captures everything that happened\nwhen a node ran: inputs, outputs, tool calls, memory accesses,\napproval actions, validation results, timing, and any errors.", "properties": { "actor": { "anyOf": [ { "$ref": "#/components/schemas/ActorIdentity" }, { "type": "null" } ] }, "approval_actions": { "items": { "$ref": "#/components/schemas/ApprovalActionRecord" }, "title": "Approval Actions", "type": "array" }, "attempt": { "default": 1, "title": "Attempt", "type": "integer" }, "audit_id": { "title": "Audit Id", "type": "string" }, "campaign_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Campaign Id" }, "chain_sequence": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Chain Sequence" }, "completed_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "title": "Completed At" }, "condition_results": { "items": { "additionalProperties": true, "type": "object" }, "title": "Condition Results", "type": "array" }, "cost_event_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Cost Event Id" }, "cost_measurement": { "anyOf": [ { "$ref": "#/components/schemas/MeasurementState" }, { "type": "null" } ] }, "cost_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Cost Usd" }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "digest_version": { "default": 1, "title": "Digest Version", "type": "integer" }, "erased": { "default": false, "title": "Erased", "type": "boolean" }, "erased_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "title": "Erased At" }, "erasure_reason": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Erasure Reason" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" }, "estimated_cost_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Estimated Cost Usd" }, "execution_metadata": { "additionalProperties": true, "title": "Execution Metadata", "type": "object" }, "graph_version_ref": { "title": "Graph Version Ref", "type": "string" }, "input_snapshot": { "additionalProperties": true, "title": "Input Snapshot", "type": "object" }, "memory_interactions": { "items": { "$ref": "#/components/schemas/MemoryAccessRecord" }, "title": "Memory Interactions", "type": "array" }, "node_id": { "title": "Node Id", "type": "string" }, "node_version": { "default": 1, "title": "Node Version", "type": "integer" }, "output_snapshot": { "additionalProperties": true, "title": "Output Snapshot", "type": "object" }, "pii_commitments": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "type": "null" } ], "title": "Pii Commitments" }, "previous_record_digest": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Previous Record Digest" }, "record_digest": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Record Digest" }, "record_signature": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Record Signature" }, "run_id": { "title": "Run Id", "type": "string" }, "signing_algorithm": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Signing Algorithm" }, "signing_key_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Signing Key Id" }, "started_at": { "format": "date-time", "title": "Started At", "type": "string" }, "status": { "title": "Status", "type": "string" }, "stderr": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Stderr" }, "stdout": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Stdout" }, "supersedes_audit_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Supersedes Audit Id" }, "tenant_id": { "title": "Tenant Id", "type": "string" }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thread Id" }, "token_usage": { "anyOf": [ { "$ref": "#/components/schemas/TokenUsage" }, { "type": "null" } ] }, "tool_calls": { "items": { "$ref": "#/components/schemas/ToolCallRecord" }, "title": "Tool Calls", "type": "array" }, "validation_results": { "additionalProperties": true, "title": "Validation Results", "type": "object" }, "workspace_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workspace Id" } }, "required": [ "audit_id", "run_id", "node_id", "graph_version_ref", "deployment_ref", "tenant_id", "status" ], "title": "NodeAuditRecord", "type": "object" }, "NodeSpend": { "additionalProperties": false, "description": "Attributed spend and right-sizing potential for one node.", "properties": { "best_savings_pct": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Best Savings Pct" }, "cheaper_alternatives": { "default": 0, "title": "Cheaper Alternatives", "type": "integer" }, "experiment_ready": { "default": false, "title": "Experiment Ready", "type": "boolean" }, "incumbent_model": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Incumbent Model" }, "mean_cost_per_call_usd": { "default": 0.0, "title": "Mean Cost Per Call Usd", "type": "number" }, "mean_estimated_cost_per_call_usd": { "default": 0.0, "title": "Mean Estimated Cost Per Call Usd", "type": "number" }, "node_id": { "title": "Node Id", "type": "string" }, "projected_estimated_savings_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Projected Estimated Savings Usd" }, "projected_savings_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Projected Savings Usd" }, "runs": { "default": 0, "title": "Runs", "type": "integer" }, "source_deployment_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Deployment Ref" }, "tool_free_runs": { "default": 0, "title": "Tool Free Runs", "type": "integer" }, "total_cost_usd": { "default": 0.0, "title": "Total Cost Usd", "type": "number" }, "total_estimated_cost_usd": { "default": 0.0, "title": "Total Estimated Cost Usd", "type": "number" }, "uses_tools": { "default": false, "title": "Uses Tools", "type": "boolean" } }, "required": [ "node_id" ], "title": "NodeSpend", "type": "object" }, "NodeTypeResponse": { "description": "A node type the Studio knows how to draw.\n\nKnowing how to *draw* a type and letting an author *create* one are separate\nquestions. An imported MCP tool has to appear here so the canvas can resolve\nits ports -- without an entry it would render with no handles and its tool\nedge would silently fail to attach, showing an agent and its tool as\ndisconnected -- but it must not appear in the palette.", "properties": { "category": { "title": "Category", "type": "string" }, "label": { "title": "Label", "type": "string" }, "ports": { "items": { "$ref": "#/components/schemas/PortDefinitionResponse" }, "title": "Ports", "type": "array" }, "type": { "title": "Type", "type": "string" } }, "required": [ "type", "label", "category", "ports" ], "title": "NodeTypeResponse", "type": "object" }, "NormalizedAction": { "additionalProperties": false, "description": "One tool call, already normalized, as a policy is written against it.\n\nThe name alone is not an identity -- whoever bound the tool chose it and can\nreuse it for a different callable between runs -- so ``fingerprint`` is what\nmakes a decision reproducible.\n\nAttributes:\n name: The tool's bound name, as the framework reports it.\n fingerprint: A stable digest of the tool's identifying material.\n arguments_digest: A digest of the call arguments. The arguments\n themselves are never carried.\n contract_ref: The tool contract this call claims to satisfy, when one\n is declared.\n side_effect: The classification, defaulting to the refusable ``unknown``\n rather than to anything the service would admit.\n capability_refs: Capabilities the action requires.\n requires_approval: Whether the tool explicitly requires a human approval.\n identity_configuration: Identity-bearing configuration names in the fingerprint.", "properties": { "arguments_digest": { "title": "Arguments Digest", "type": "string" }, "capability_refs": { "default": [], "items": { "type": "string" }, "title": "Capability Refs", "type": "array" }, "contract_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Contract Ref" }, "fingerprint": { "title": "Fingerprint", "type": "string" }, "identity_configuration": { "default": [], "items": { "type": "string" }, "title": "Identity Configuration", "type": "array" }, "name": { "title": "Name", "type": "string" }, "requires_approval": { "default": false, "title": "Requires Approval", "type": "boolean" }, "side_effect": { "default": "unknown", "enum": [ "read_only", "side_effecting", "unknown" ], "title": "Side Effect", "type": "string" } }, "required": [ "name", "fingerprint", "arguments_digest" ], "title": "NormalizedAction", "type": "object" }, "OperationResolutionRequest": { "additionalProperties": false, "properties": { "reason": { "maxLength": 2000, "minLength": 1, "title": "Reason", "type": "string" }, "receipt": { "anyOf": [ {}, { "type": "null" } ], "title": "Receipt" }, "resolution": { "$ref": "#/components/schemas/OperatorResolution" } }, "required": [ "resolution", "reason" ], "title": "OperationResolutionRequest", "type": "object" }, "OperationResolutionResponse": { "additionalProperties": false, "properties": { "operation_key": { "title": "Operation Key", "type": "string" }, "state": { "$ref": "#/components/schemas/OperationState" } }, "required": [ "operation_key", "state" ], "title": "OperationResolutionResponse", "type": "object" }, "OperationState": { "description": "The five outcomes a side-effecting operation can be in.\n\n``NOT_STARTED`` is deliberately not a stored row. Writing one before the\neffect is attempted would itself be a durable act that recovery could not\ntell apart from a real attempt, so absence *is* the not-started state.", "enum": [ "NOT_STARTED", "IN_FLIGHT", "COMPLETED", "FAILED", "AMBIGUOUS" ], "title": "OperationState", "type": "string" }, "OperatorResolution": { "enum": [ "completed", "failed" ], "title": "OperatorResolution", "type": "string" }, "OverrideScope": { "description": "Explicitly overridable production-readiness blockers.", "enum": [ "receipt_expired", "environment_policy" ], "title": "OverrideScope", "type": "string" }, "PassthroughMappingOperation": { "additionalProperties": false, "description": "Copy a value from the input to the output without changing it.\n\nThe source and target paths are the same logical field, just moved across\nthe edge boundary.", "properties": { "operation": { "const": "passthrough", "default": "passthrough", "title": "Operation", "type": "string" }, "source_path": { "title": "Source Path", "type": "string" }, "target_path": { "title": "Target Path", "type": "string" } }, "required": [ "target_path", "source_path" ], "title": "PassthroughMappingOperation", "type": "object" }, "PortDefinitionResponse": { "description": "A port on a node type.", "properties": { "direction": { "title": "Direction", "type": "string" }, "id": { "title": "Id", "type": "string" }, "label": { "title": "Label", "type": "string" }, "type": { "title": "Type", "type": "string" } }, "required": [ "id", "type", "direction", "label" ], "title": "PortDefinitionResponse", "type": "object" }, "PromoteCertificationRequest": { "additionalProperties": false, "description": "Promotion intent; the target and artifact identity are server-owned.", "properties": {}, "title": "PromoteCertificationRequest", "type": "object" }, "PromotionReceiptPayload": { "additionalProperties": false, "description": "Immutable certification claims accepted by the runtime promotion gate.", "properties": { "app_commit": { "pattern": "^[0-9a-f]{40}$", "title": "App Commit", "type": "string" }, "app_name": { "maxLength": 120, "minLength": 1, "title": "App Name", "type": "string" }, "certification_id": { "pattern": "^[0-9a-f]{32}$", "title": "Certification Id", "type": "string" }, "environments": { "items": { "enum": [ "test", "production" ], "type": "string" }, "maxItems": 2, "title": "Environments", "type": "array" }, "evidence_digest": { "pattern": "^sha256:[0-9a-f]{64}$", "title": "Evidence Digest", "type": "string" }, "expires_at": { "format": "date-time", "title": "Expires At", "type": "string" }, "image_digest": { "pattern": "^sha256:[0-9a-f]{64}$", "title": "Image Digest", "type": "string" }, "image_reference": { "maxLength": 255, "pattern": "^[A-Za-z0-9][A-Za-z0-9./:_-]*$", "title": "Image Reference", "type": "string" }, "issued_at": { "format": "date-time", "title": "Issued At", "type": "string" }, "report_digest": { "pattern": "^sha256:[0-9a-f]{64}$", "title": "Report Digest", "type": "string" }, "schema_version": { "const": 1, "default": 1, "title": "Schema Version", "type": "integer" }, "source_digest": { "pattern": "^sha256:[0-9a-f]{64}$", "title": "Source Digest", "type": "string" }, "tenant_id": { "maxLength": 255, "minLength": 1, "title": "Tenant Id", "type": "string" }, "workspace_id": { "anyOf": [ { "maxLength": 255, "minLength": 1, "type": "string" }, { "type": "null" } ], "title": "Workspace Id" }, "zeroth_version": { "pattern": "^[0-9]+(?:\\.[0-9]+){1,4}$", "title": "Zeroth Version", "type": "string" } }, "required": [ "certification_id", "tenant_id", "app_name", "app_commit", "zeroth_version", "image_reference", "image_digest", "source_digest", "evidence_digest", "report_digest", "environments", "issued_at", "expires_at" ], "title": "PromotionReceiptPayload", "type": "object" }, "PublicContractSchemaResponse": { "additionalProperties": false, "description": "Public contract payload exposed by the deployment API.", "properties": { "json_schema": { "additionalProperties": true, "title": "Json Schema", "type": "object" }, "name": { "title": "Name", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "name", "version" ], "title": "PublicContractSchemaResponse", "type": "object" }, "QualityEconomicsReport": { "additionalProperties": false, "description": "Cost per *quality* success over the labeled subset of the window.\n\nEvery headline travels with its coverage so the number can never be read alone.", "properties": { "cost_on_quality_failures_usd": { "default": 0.0, "title": "Cost On Quality Failures Usd", "type": "number" }, "cost_per_quality_success_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Cost Per Quality Success Usd" }, "coverage": { "default": 0.0, "title": "Coverage", "type": "number" }, "labeled_terminal_runs": { "default": 0, "title": "Labeled Terminal Runs", "type": "integer" }, "note": { "default": "", "title": "Note", "type": "string" }, "quality_success_rate_over_labeled": { "default": 0.0, "title": "Quality Success Rate Over Labeled", "type": "number" }, "quality_successes": { "default": 0, "title": "Quality Successes", "type": "integer" }, "sources": { "items": { "type": "string" }, "title": "Sources", "type": "array" }, "state": { "default": "not_configured", "enum": [ "ok", "not_configured", "below_coverage_floor" ], "title": "State", "type": "string" }, "terminal_runs": { "default": 0, "title": "Terminal Runs", "type": "integer" } }, "title": "QualityEconomicsReport", "type": "object" }, "QualityVerdictRequest": { "additionalProperties": false, "description": "Request body for POST /econ/quality-verdict.", "properties": { "detail": { "default": "", "title": "Detail", "type": "string" }, "expected_output": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expected Output" }, "rubric_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rubric Id" }, "run_id": { "minLength": 1, "title": "Run Id", "type": "string" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Score" }, "source": { "description": "Who/what judged it, e.g. 'human:alice'", "minLength": 1, "title": "Source", "type": "string" }, "verdict": { "enum": [ "good", "bad", "unknown" ], "title": "Verdict", "type": "string" } }, "required": [ "run_id", "verdict", "source" ], "title": "QualityVerdictRequest", "type": "object" }, "ReadinessResponse": { "additionalProperties": false, "description": "Serialized readiness payload with schema-revision evidence.", "properties": { "certification": { "$ref": "#/components/schemas/CertificationEvaluation" }, "checks": { "additionalProperties": { "$ref": "#/components/schemas/DependencyStatus" }, "title": "Checks", "type": "object" }, "production_ready": { "title": "Production Ready", "type": "boolean" }, "schema_revision": { "$ref": "#/components/schemas/SchemaRevision" }, "status": { "title": "Status", "type": "string" } }, "required": [ "status", "schema_revision", "production_ready", "certification" ], "title": "ReadinessResponse", "type": "object" }, "RegisterCertificationRequest": { "additionalProperties": false, "description": "A portable certification receipt to retain and evaluate.", "properties": { "receipt": { "$ref": "#/components/schemas/SignedPromotionReceipt" } }, "required": [ "receipt" ], "title": "RegisterCertificationRequest", "type": "object" }, "RegisteredTool": { "additionalProperties": false, "description": "One governed tool and the complete governance metadata registered for it.\n\nThe fingerprint is what makes the identity meaningful. A registration\nholding names alone says only which labels exist, so a tool swapped for\nanother under the same name would register identically -- exactly the\nsubstitution ZER-6's suite exists to catch.", "properties": { "capability_refs": { "default": [], "items": { "type": "string" }, "title": "Capability Refs", "type": "array" }, "contract_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Contract Ref" }, "fingerprint": { "minLength": 1, "title": "Fingerprint", "type": "string" }, "identity_configuration": { "default": [], "items": { "type": "string" }, "title": "Identity Configuration", "type": "array" }, "name": { "minLength": 1, "title": "Name", "type": "string" }, "requires_approval": { "default": false, "title": "Requires Approval", "type": "boolean" }, "side_effect": { "default": "unknown", "enum": [ "read_only", "side_effecting", "unknown" ], "title": "Side Effect", "type": "string" } }, "required": [ "name", "fingerprint" ], "title": "RegisteredTool", "type": "object" }, "RenameMappingOperation": { "additionalProperties": false, "description": "Copy a value from the input to the output under a different name.\n\nWorks just like passthrough, but the target path can differ from the source\npath, effectively renaming the field.", "properties": { "operation": { "const": "rename", "default": "rename", "title": "Operation", "type": "string" }, "source_path": { "title": "Source Path", "type": "string" }, "target_path": { "title": "Target Path", "type": "string" } }, "required": [ "target_path", "source_path" ], "title": "RenameMappingOperation", "type": "object" }, "RetentionPolicyBody": { "additionalProperties": false, "description": "Request body for PUT /retention/policy.", "properties": { "audit_ttl_seconds": { "anyOf": [ { "maximum": 2147483647.0, "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Audit Ttl Seconds" }, "enabled": { "default": true, "title": "Enabled", "type": "boolean" }, "run_ttl_seconds": { "anyOf": [ { "maximum": 2147483647.0, "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Run Ttl Seconds" } }, "title": "RetentionPolicyBody", "type": "object" }, "RetentionPolicyResponse": { "additionalProperties": false, "description": "A tenant's resolved retention policy.", "properties": { "audit_ttl_seconds": { "anyOf": [ { "maximum": 2147483647.0, "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Audit Ttl Seconds" }, "enabled": { "default": true, "title": "Enabled", "type": "boolean" }, "run_ttl_seconds": { "anyOf": [ { "maximum": 2147483647.0, "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Run Ttl Seconds" }, "tenant_id": { "title": "Tenant Id", "type": "string" } }, "required": [ "tenant_id" ], "title": "RetentionPolicyResponse", "type": "object" }, "RevokeCertificationRequest": { "additionalProperties": false, "description": "Operator reason retained with an explicit revocation.", "properties": { "reason": { "maxLength": 500, "minLength": 1, "title": "Reason", "type": "string" } }, "required": [ "reason" ], "title": "RevokeCertificationRequest", "type": "object" }, "RightsizingRequest": { "additionalProperties": false, "description": "Request body for POST /v1/econ/rightsizing.\n\nTask-shape flags are *capability gates*, derived from how the node is wired: an agent\nwith tools attached needs ``needs_tools``; one handed images needs ``needs_vision``.", "properties": { "incumbent": { "description": "Current model, e.g. openai/gpt-4o", "minLength": 1, "title": "Incumbent", "type": "string" }, "limit": { "default": 6, "maximum": 20.0, "minimum": 1.0, "title": "Limit", "type": "integer" }, "min_savings_pct": { "default": 20.0, "maximum": 100.0, "minimum": 0.0, "title": "Min Savings Pct", "type": "number" }, "needs_tools": { "default": false, "title": "Needs Tools", "type": "boolean" }, "needs_vision": { "default": false, "title": "Needs Vision", "type": "boolean" } }, "required": [ "incumbent" ], "title": "RightsizingRequest", "type": "object" }, "RightsizingResult": { "additionalProperties": false, "description": "Cheaper capability-compatible candidates for an incumbent model, or why there are none.\n\n``incumbent_known`` is ``False`` when litellm has no pricing for the incumbent (e.g. a\nmodel newer than the installed litellm) \u2014 the honest signal that this is a *pricing gap*,\nnot \"nothing is cheaper\". Never let an unknown incumbent read as \"no savings available\".", "properties": { "assumption": { "default": "blended price assumes a 3:1 input:output token ratio", "title": "Assumption", "type": "string" }, "candidates": { "items": { "$ref": "#/components/schemas/ModelOption" }, "title": "Candidates", "type": "array" }, "incumbent": { "title": "Incumbent", "type": "string" }, "incumbent_blended_per_mtok_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Incumbent Blended Per Mtok Usd" }, "incumbent_known": { "title": "Incumbent Known", "type": "boolean" }, "incumbent_provider": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Incumbent Provider" }, "needs_tools": { "default": false, "title": "Needs Tools", "type": "boolean" }, "needs_vision": { "default": false, "title": "Needs Vision", "type": "boolean" }, "note": { "default": "", "title": "Note", "type": "string" } }, "required": [ "incumbent", "incumbent_known" ], "title": "RightsizingResult", "type": "object" }, "RollbackDeploymentRequest": { "additionalProperties": false, "description": "Request body for POST /v1/deployments/{deployment_ref}/rollback.", "properties": { "target_graph_version": { "title": "Target Graph Version", "type": "integer" } }, "required": [ "target_graph_version" ], "title": "RollbackDeploymentRequest", "type": "object" }, "RoutingDecisionResponse": { "additionalProperties": false, "description": "Content-free record of one persisted conditional-route decision.", "properties": { "condition_id": { "title": "Condition Id", "type": "string" }, "matched": { "title": "Matched", "type": "boolean" }, "selected_edge_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Selected Edge Id" }, "suppression_reason": { "anyOf": [ { "enum": [ "edge_disabled", "condition_false", "visit_limit" ], "type": "string" }, { "type": "null" } ], "title": "Suppression Reason" } }, "required": [ "condition_id", "matched" ], "title": "RoutingDecisionResponse", "type": "object" }, "RunAttestationV1": { "additionalProperties": false, "description": "Run-start claim authenticated by reserved context and signed by Zeroth.", "properties": { "adapter_version": { "default": "2", "minLength": 1, "title": "Adapter Version", "type": "string" }, "claimed_level": { "$ref": "#/components/schemas/GovernanceLevel", "default": "observed" }, "context_token": { "minLength": 1, "title": "Context Token", "type": "string" }, "correlation_id": { "minLength": 1, "title": "Correlation Id", "type": "string" }, "deployment_ref": { "minLength": 1, "title": "Deployment Ref", "type": "string" }, "graph_version": { "minLength": 1, "title": "Graph Version", "type": "string" }, "inventory_fingerprint": { "minLength": 1, "title": "Inventory Fingerprint", "type": "string" }, "principal_id": { "minLength": 1, "title": "Principal Id", "type": "string" }, "schema_version": { "const": 1, "default": 1, "title": "Schema Version", "type": "integer" }, "tenant_id": { "minLength": 1, "title": "Tenant Id", "type": "string" } }, "required": [ "context_token", "tenant_id", "principal_id", "deployment_ref", "correlation_id", "graph_version", "inventory_fingerprint" ], "title": "RunAttestationV1", "type": "object" }, "RunCapabilityEvidence": { "description": "Attested evidence used to clamp a run's reported governance level.", "properties": { "adapter_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Adapter Version" }, "correlation_id": { "title": "Correlation Id", "type": "string" }, "governance_level": { "$ref": "#/components/schemas/GovernanceLevel" }, "graph_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Graph Version" }, "inventory_fingerprint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Inventory Fingerprint" }, "observed_at": { "format": "date-time", "title": "Observed At", "type": "string" }, "run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" }, "signature_valid": { "default": false, "title": "Signature Valid", "type": "boolean" }, "tool_manifest_complete": { "default": false, "title": "Tool Manifest Complete", "type": "boolean" } }, "required": [ "correlation_id", "governance_level", "observed_at" ], "title": "RunCapabilityEvidence", "type": "object" }, "RunEnforcementStatus": { "additionalProperties": false, "description": "One run's governance level, recomputed from stored evidence.", "properties": { "correlation_id": { "title": "Correlation Id", "type": "string" }, "governance_level": { "title": "Governance Level", "type": "string" } }, "required": [ "correlation_id", "governance_level" ], "title": "RunEnforcementStatus", "type": "object" }, "RunEvidenceResponse": { "additionalProperties": false, "description": "Review-friendly evidence bundle for a single run.", "properties": { "approvals": { "items": { "$ref": "#/components/schemas/ApprovalRecord" }, "title": "Approvals", "type": "array" }, "audits": { "items": { "$ref": "#/components/schemas/NodeAuditRecord" }, "title": "Audits", "type": "array" }, "policy_events": { "items": { "type": "string" }, "title": "Policy Events", "type": "array" }, "run": { "$ref": "#/components/schemas/RunStatusResponse" }, "summary": { "$ref": "#/components/schemas/EvidenceSummaryResponse" } }, "required": [ "run", "summary" ], "title": "RunEvidenceResponse", "type": "object" }, "RunFailureState": { "additionalProperties": false, "description": "Details about why a run failed.\n\nWhen a run ends in an error, this stores the reason and any extra details\nso you can figure out what went wrong.", "properties": { "details": { "additionalProperties": true, "title": "Details", "type": "object" }, "message": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Message" }, "reason": { "title": "Reason", "type": "string" } }, "required": [ "reason" ], "title": "RunFailureState", "type": "object" }, "RunInvocationRequest": { "additionalProperties": false, "description": "Request body for creating a new run.", "properties": { "campaign_id": { "anyOf": [ { "maxLength": 128, "minLength": 1, "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]*$", "type": "string" }, { "type": "null" } ], "title": "Campaign Id" }, "campaign_strict": { "const": true, "default": true, "title": "Campaign Strict", "type": "boolean" }, "input_payload": { "additionalProperties": true, "title": "Input Payload", "type": "object" }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thread Id" } }, "title": "RunInvocationRequest", "type": "object" }, "RunInvocationResponse": { "additionalProperties": false, "description": "Response body for run creation.", "properties": { "approval_paused_state": { "anyOf": [ { "$ref": "#/components/schemas/ApprovalPausedState" }, { "type": "null" } ] }, "audit_refs": { "items": { "type": "string" }, "title": "Audit Refs", "type": "array" }, "campaign_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Campaign Id" }, "current_step": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Current Step" }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "evidence_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evidence Ref" }, "failure_state": { "anyOf": [ { "$ref": "#/components/schemas/RunFailureState" }, { "type": "null" } ] }, "graph_version_ref": { "title": "Graph Version Ref", "type": "string" }, "parent_run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Run Id" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "$ref": "#/components/schemas/RunPublicStatus" }, "submitted_by": { "anyOf": [ { "$ref": "#/components/schemas/ActorIdentity" }, { "type": "null" } ] }, "tenant_id": { "default": "default", "title": "Tenant Id", "type": "string" }, "terminal_output": { "anyOf": [ {}, { "type": "null" } ], "title": "Terminal Output" }, "thread_id": { "title": "Thread Id", "type": "string" }, "timeline_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Timeline Ref" }, "traversal": { "$ref": "#/components/schemas/RunTraversalResponse" }, "workspace_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workspace Id" } }, "required": [ "run_id", "status", "deployment_ref", "graph_version_ref", "thread_id" ], "title": "RunInvocationResponse", "type": "object" }, "RunPublicStatus": { "description": "Public run lifecycle states returned by the HTTP API.", "enum": [ "queued", "running", "paused_for_approval", "waiting_interrupt", "succeeded", "failed", "terminated_by_policy", "terminated_by_loop_guard", "dead_letter" ], "title": "RunPublicStatus", "type": "string" }, "RunQualityVerdict": { "additionalProperties": false, "description": "An externally-attached judgement of whether a run's output was good.", "properties": { "attached_at": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "title": "Attached At" }, "detail": { "default": "", "title": "Detail", "type": "string" }, "expected_output": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expected Output" }, "rubric_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Rubric Id" }, "score": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Score" }, "source": { "title": "Source", "type": "string" }, "verdict": { "enum": [ "good", "bad", "unknown" ], "title": "Verdict", "type": "string" } }, "required": [ "verdict", "source" ], "title": "RunQualityVerdict", "type": "object" }, "RunStatusResponse": { "additionalProperties": false, "description": "Public serialization of run state.", "properties": { "approval_paused_state": { "anyOf": [ { "$ref": "#/components/schemas/ApprovalPausedState" }, { "type": "null" } ] }, "audit_refs": { "items": { "type": "string" }, "title": "Audit Refs", "type": "array" }, "campaign_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Campaign Id" }, "current_step": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Current Step" }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "evidence_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Evidence Ref" }, "failure_state": { "anyOf": [ { "$ref": "#/components/schemas/RunFailureState" }, { "type": "null" } ] }, "graph_version_ref": { "title": "Graph Version Ref", "type": "string" }, "parent_run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Parent Run Id" }, "run_id": { "title": "Run Id", "type": "string" }, "status": { "$ref": "#/components/schemas/RunPublicStatus" }, "submitted_by": { "anyOf": [ { "$ref": "#/components/schemas/ActorIdentity" }, { "type": "null" } ] }, "tenant_id": { "default": "default", "title": "Tenant Id", "type": "string" }, "terminal_output": { "anyOf": [ {}, { "type": "null" } ], "title": "Terminal Output" }, "thread_id": { "title": "Thread Id", "type": "string" }, "timeline_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Timeline Ref" }, "traversal": { "$ref": "#/components/schemas/RunTraversalResponse" }, "workspace_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Workspace Id" } }, "required": [ "run_id", "status", "deployment_ref", "graph_version_ref", "thread_id" ], "title": "RunStatusResponse", "type": "object" }, "RunTraversalResponse": { "additionalProperties": false, "description": "Sanitized traversal proof for loops and conditional routing.", "properties": { "edge_visit_counts": { "additionalProperties": { "type": "integer" }, "title": "Edge Visit Counts", "type": "object" }, "node_visit_counts": { "additionalProperties": { "type": "integer" }, "title": "Node Visit Counts", "type": "object" }, "routing_decisions": { "items": { "$ref": "#/components/schemas/RoutingDecisionResponse" }, "title": "Routing Decisions", "type": "array" }, "stop_reason": { "anyOf": [ { "enum": [ "no_outgoing_edges", "branch_suppressed" ], "type": "string" }, { "type": "null" } ], "title": "Stop Reason" } }, "title": "RunTraversalResponse", "type": "object" }, "SchemaRevision": { "additionalProperties": false, "description": "One schema's applied revision, shipped head, and conservative state.", "properties": { "applied": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Applied" }, "head": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Head" }, "state": { "enum": [ "current", "behind", "unknown" ], "title": "State", "type": "string" } }, "required": [ "applied", "head", "state" ], "title": "SchemaRevision", "type": "object" }, "ServiceRole": { "description": "Built-in service roles used by route authorization.\n\nDeployments may add custom role names through service configuration.\nPrincipals therefore carry strings while this enum remains the stable\ncatalogue of built-in names.", "enum": [ "operator", "reviewer", "admin", "platform_admin" ], "title": "ServiceRole", "type": "string" }, "SideEffectClass": { "description": "How consequential invoking a tool is, as far as the classifier can tell.\n\n``UNKNOWN`` is a real member, not a placeholder: an unclassified tool must\nbe distinguishable from one positively known to be read-only, because a\npolicy that waves through read-only calls must not wave through the ones\nnobody classified.", "enum": [ "read_only", "side_effecting", "unknown" ], "title": "SideEffectClass", "type": "string" }, "SignedPromotionReceipt": { "additionalProperties": false, "description": "Certification payload plus a keyed signature over its canonical digest.", "properties": { "digest": { "pattern": "^sha256:[0-9a-f]{64}$", "title": "Digest", "type": "string" }, "payload": { "$ref": "#/components/schemas/PromotionReceiptPayload" }, "signature": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Signature" }, "signing_algorithm": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Signing Algorithm" }, "signing_key_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Signing Key Id" } }, "required": [ "payload", "digest" ], "title": "SignedPromotionReceipt", "type": "object" }, "SpendReport": { "additionalProperties": false, "description": "Deployment-wide spend attribution, ranked by right-sizing opportunity.", "properties": { "nodes": { "items": { "$ref": "#/components/schemas/NodeSpend" }, "title": "Nodes", "type": "array" }, "note": { "default": "", "title": "Note", "type": "string" }, "total_cost_usd": { "default": 0.0, "title": "Total Cost Usd", "type": "number" }, "total_estimated_cost_usd": { "default": 0.0, "title": "Total Estimated Cost Usd", "type": "number" } }, "title": "SpendReport", "type": "object" }, "StudioContractResponse": { "description": "A registered contract, for canvas contract-ref pickers.", "properties": { "json_schema": { "additionalProperties": true, "title": "Json Schema", "type": "object" }, "name": { "title": "Name", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "name", "version" ], "title": "StudioContractResponse", "type": "object" }, "StudioEdgeInput": { "description": "An edge accepted from the Studio frontend.\n\n``kind=\"tool\"`` marks a tool attachment (agent \u2192 executable unit)\nrather than a control-flow connection.", "properties": { "condition": { "anyOf": [ { "$ref": "#/components/schemas/Condition" }, { "type": "null" } ] }, "enabled": { "default": true, "title": "Enabled", "type": "boolean" }, "id": { "title": "Id", "type": "string" }, "kind": { "default": "data", "enum": [ "data", "tool" ], "title": "Kind", "type": "string" }, "mapping": { "anyOf": [ { "$ref": "#/components/schemas/EdgeMapping" }, { "type": "null" } ] }, "source": { "title": "Source", "type": "string" }, "source_handle": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Handle" }, "target": { "title": "Target", "type": "string" }, "target_handle": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Target Handle" } }, "required": [ "id", "source", "target" ], "title": "StudioEdgeInput", "type": "object" }, "StudioEdgeResponse": { "description": "An edge returned to the Studio frontend.", "properties": { "condition": { "anyOf": [ { "$ref": "#/components/schemas/Condition" }, { "type": "null" } ] }, "enabled": { "default": true, "title": "Enabled", "type": "boolean" }, "id": { "title": "Id", "type": "string" }, "kind": { "default": "data", "enum": [ "data", "tool" ], "title": "Kind", "type": "string" }, "mapping": { "anyOf": [ { "$ref": "#/components/schemas/EdgeMapping" }, { "type": "null" } ] }, "source": { "title": "Source", "type": "string" }, "source_handle": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source Handle" }, "target": { "title": "Target", "type": "string" }, "target_handle": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Target Handle" } }, "required": [ "id", "source", "target" ], "title": "StudioEdgeResponse", "type": "object" }, "StudioExecutionSettings": { "description": "Authorable graph safety ceilings exposed by Studio.\n\nRuntime-mode, failure-policy, and audit controls deliberately remain outside\nthe canvas contract. Studio authors only the bounds needed to make cycles\nand long-running graphs fail closed.", "properties": { "default_timeout_seconds": { "anyOf": [ { "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Default Timeout Seconds" }, "max_total_runtime_seconds": { "anyOf": [ { "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Max Total Runtime Seconds" }, "max_total_steps": { "default": 1000, "minimum": 1.0, "title": "Max Total Steps", "type": "integer" }, "max_visits_per_edge": { "anyOf": [ { "minimum": 1.0, "type": "integer" }, { "type": "null" } ], "title": "Max Visits Per Edge" }, "max_visits_per_node": { "default": 10, "minimum": 1.0, "title": "Max Visits Per Node", "type": "integer" } }, "title": "StudioExecutionSettings", "type": "object" }, "StudioNodeResponse": { "description": "A node as represented in the Studio frontend.", "properties": { "data": { "additionalProperties": true, "title": "Data", "type": "object" }, "id": { "title": "Id", "type": "string" }, "position": { "$ref": "#/components/schemas/StudioPosition" }, "type": { "title": "Type", "type": "string" } }, "required": [ "id", "type", "position" ], "title": "StudioNodeResponse", "type": "object" }, "StudioPosition": { "description": "Canvas position for a node in the Studio editor.", "properties": { "x": { "default": 0.0, "title": "X", "type": "number" }, "y": { "default": 0.0, "title": "Y", "type": "number" } }, "title": "StudioPosition", "type": "object" }, "StudioViewport": { "description": "Viewport state for the Studio canvas.", "properties": { "x": { "default": 0.0, "title": "X", "type": "number" }, "y": { "default": 0.0, "title": "Y", "type": "number" }, "zoom": { "default": 1.0, "title": "Zoom", "type": "number" } }, "title": "StudioViewport", "type": "object" }, "TemplateListResponse": { "description": "Response for listing templates.", "properties": { "templates": { "items": { "$ref": "#/components/schemas/TemplateResponse" }, "title": "Templates", "type": "array" } }, "required": [ "templates" ], "title": "TemplateListResponse", "type": "object" }, "TemplateResponse": { "description": "Response for a single template.", "properties": { "description": { "default": "", "title": "Description", "type": "string" }, "name": { "title": "Name", "type": "string" }, "template_str": { "title": "Template Str", "type": "string" }, "variables": { "items": { "type": "string" }, "title": "Variables", "type": "array" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "name", "version", "template_str", "variables" ], "title": "TemplateResponse", "type": "object" }, "TenantAuditRecordListResponse": { "additionalProperties": false, "description": "Tenant-scoped audit records across all deployments visible to the caller.", "properties": { "records": { "items": { "$ref": "#/components/schemas/NodeAuditRecord" }, "title": "Records", "type": "array" }, "scope": { "title": "Scope", "type": "string" } }, "required": [ "scope" ], "title": "TenantAuditRecordListResponse", "type": "object" }, "TenantBudgetRequest": { "additionalProperties": false, "description": "Request body for PUT /v1/tenants/{tenant_id}/budget.", "properties": { "budget_cap_usd": { "title": "Budget Cap Usd", "type": "number" } }, "required": [ "budget_cap_usd" ], "title": "TenantBudgetRequest", "type": "object" }, "TenantCostResponse": { "additionalProperties": false, "description": "Response for GET /v1/tenants/{tenant_id}/cost (per D-14).", "properties": { "active_exposure_usd": { "default": 0.0, "title": "Active Exposure Usd", "type": "number" }, "actual_spend_usd": { "default": 0.0, "title": "Actual Spend Usd", "type": "number" }, "ambiguous_exposure_usd": { "default": 0.0, "title": "Ambiguous Exposure Usd", "type": "number" }, "budget_cap_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Budget Cap Usd" }, "budget_consumed_usd": { "default": 0.0, "title": "Budget Consumed Usd", "type": "number" }, "currency": { "default": "USD", "title": "Currency", "type": "string" }, "estimated_spend_usd": { "default": 0.0, "title": "Estimated Spend Usd", "type": "number" }, "paid_spend_usd": { "default": 0.0, "title": "Paid Spend Usd", "type": "number" }, "synthetic_control_usd": { "default": 0.0, "title": "Synthetic Control Usd", "type": "number" }, "tenant_id": { "title": "Tenant Id", "type": "string" }, "total_cost_usd": { "title": "Total Cost Usd", "type": "number" }, "unmeasured_spend_usd": { "default": 0.0, "title": "Unmeasured Spend Usd", "type": "number" } }, "required": [ "tenant_id", "total_cost_usd" ], "title": "TenantCostResponse", "type": "object" }, "TenantEconomics": { "additionalProperties": false, "description": "Unit economics for one tenant (customer) within a deployment.\n\nThe 'which customer is unprofitable' view: same shape as WorkflowEconomics, keyed\nby tenant_id instead of workflow_name.", "properties": { "cost_per_successful_run_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Cost Per Successful Run Usd" }, "estimated_cost_per_successful_run_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Estimated Cost Per Successful Run Usd" }, "estimated_failure_tax_usd": { "default": 0.0, "title": "Estimated Failure Tax Usd", "type": "number" }, "estimated_terminal_cost_usd": { "default": 0.0, "title": "Estimated Terminal Cost Usd", "type": "number" }, "failed_runs": { "default": 0, "title": "Failed Runs", "type": "integer" }, "failure_tax_usd": { "default": 0.0, "title": "Failure Tax Usd", "type": "number" }, "runs": { "default": 0, "title": "Runs", "type": "integer" }, "success_rate": { "default": 0.0, "title": "Success Rate", "type": "number" }, "successful_runs": { "default": 0, "title": "Successful Runs", "type": "integer" }, "tenant_id": { "title": "Tenant Id", "type": "string" }, "terminal_cost_usd": { "default": 0.0, "title": "Terminal Cost Usd", "type": "number" } }, "required": [ "tenant_id" ], "title": "TenantEconomics", "type": "object" }, "TokenUsage": { "additionalProperties": false, "description": "Token consumption metrics from a single LLM provider call.\n\nTracks input (prompt) tokens, output (completion) tokens, total tokens,\nand the model that produced them. Used by ProviderResponse and\nNodeAuditRecord for cost attribution and budget enforcement.", "properties": { "input_tokens": { "default": 0, "title": "Input Tokens", "type": "integer" }, "model_name": { "default": "", "title": "Model Name", "type": "string" }, "output_tokens": { "default": 0, "title": "Output Tokens", "type": "integer" }, "total_tokens": { "default": 0, "title": "Total Tokens", "type": "integer" } }, "title": "TokenUsage", "type": "object" }, "ToolCallRecord": { "additionalProperties": false, "description": "A record of a single tool call made during a node execution.\n\nCaptures which tool was called, what arguments were passed in,\nwhat the tool returned, and whether it produced an error.\n\nThe ``operation_*`` fields carry the durable receipt outcome for guarded\nexecutable tools. MCP calls populate only the support and residual-risk\nmarker because they bypass the operation boundary entirely.", "properties": { "alias": { "title": "Alias", "type": "string" }, "arguments": { "additionalProperties": true, "title": "Arguments", "type": "object" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" }, "operation_first_execution": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Operation First Execution" }, "operation_key": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Operation Key" }, "operation_reconciliation_exhausted": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Operation Reconciliation Exhausted" }, "operation_reconciliation_required": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Operation Reconciliation Required" }, "operation_replay_suppressed": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Operation Replay Suppressed" }, "operation_residual_duplicate_risk": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Operation Residual Duplicate Risk" }, "operation_state": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Operation State" }, "operation_support": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Operation Support" }, "operation_target_ref": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Operation Target Ref" }, "outcome": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Outcome" }, "tool_call_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tool Call Id" }, "tool_ref": { "title": "Tool Ref", "type": "string" } }, "required": [ "tool_ref", "alias" ], "title": "ToolCallRecord", "type": "object" }, "ToolDecisionKind": { "description": "The verdicts tool governance can return for one attempted call.\n\nDeliberately *not*\n:class:`~zeroth.governance.policy.models.PolicyDecision`: see the module\ndocstring for why that enum stays two-valued.", "enum": [ "allow", "deny", "require_approval" ], "title": "ToolDecisionKind", "type": "string" }, "TransformMappingOperation": { "additionalProperties": false, "description": "Evaluate an expression and write the computed result to target_path.\n\nThe expression is evaluated using the safe AST-based evaluator against a\nnamespace containing ``payload``, ``state``, ``variables``, and other\nruntime context. This enables side-effect-free data transformation\nbetween nodes.", "properties": { "expression": { "title": "Expression", "type": "string" }, "operation": { "const": "transform", "default": "transform", "title": "Operation", "type": "string" }, "target_path": { "title": "Target Path", "type": "string" } }, "required": [ "target_path", "expression" ], "title": "TransformMappingOperation", "type": "object" }, "UnitEconomicsReport": { "additionalProperties": false, "description": "Deployment-wide unit economics: what a successful outcome costs, and the failure tax.\n\nComputed over a bounded, most-recent window of top-level runs (``window_runs``); the\ndollar figures are for that window, not all time.", "properties": { "by_tenant": { "items": { "$ref": "#/components/schemas/TenantEconomics" }, "title": "By Tenant", "type": "array" }, "by_workflow": { "items": { "$ref": "#/components/schemas/WorkflowEconomics" }, "title": "By Workflow", "type": "array" }, "cost_on_failed_usd": { "default": 0.0, "title": "Cost On Failed Usd", "type": "number" }, "cost_on_in_flight_usd": { "default": 0.0, "title": "Cost On In Flight Usd", "type": "number" }, "cost_on_successful_usd": { "default": 0.0, "title": "Cost On Successful Usd", "type": "number" }, "cost_per_successful_run_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Cost Per Successful Run Usd" }, "estimated_cost_on_failed_usd": { "default": 0.0, "title": "Estimated Cost On Failed Usd", "type": "number" }, "estimated_cost_on_in_flight_usd": { "default": 0.0, "title": "Estimated Cost On In Flight Usd", "type": "number" }, "estimated_cost_on_successful_usd": { "default": 0.0, "title": "Estimated Cost On Successful Usd", "type": "number" }, "estimated_cost_per_successful_run_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Estimated Cost Per Successful Run Usd" }, "estimated_failure_tax_ratio": { "default": 0.0, "title": "Estimated Failure Tax Ratio", "type": "number" }, "estimated_failure_tax_usd": { "default": 0.0, "title": "Estimated Failure Tax Usd", "type": "number" }, "estimated_mean_cost_per_successful_run_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Estimated Mean Cost Per Successful Run Usd" }, "estimated_terminal_cost_usd": { "default": 0.0, "title": "Estimated Terminal Cost Usd", "type": "number" }, "estimated_total_cost_usd": { "default": 0.0, "title": "Estimated Total Cost Usd", "type": "number" }, "failed_runs": { "default": 0, "title": "Failed Runs", "type": "integer" }, "failure_tax_ratio": { "default": 0.0, "title": "Failure Tax Ratio", "type": "number" }, "failure_tax_usd": { "default": 0.0, "title": "Failure Tax Usd", "type": "number" }, "in_flight_runs": { "default": 0, "title": "In Flight Runs", "type": "integer" }, "mean_cost_per_successful_run_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Mean Cost Per Successful Run Usd" }, "note": { "default": "", "title": "Note", "type": "string" }, "quality": { "anyOf": [ { "$ref": "#/components/schemas/QualityEconomicsReport" }, { "type": "null" } ] }, "runs_with_cost": { "default": 0, "title": "Runs With Cost", "type": "integer" }, "runs_with_estimated_cost": { "default": 0, "title": "Runs With Estimated Cost", "type": "integer" }, "success_rate": { "default": 0.0, "title": "Success Rate", "type": "number" }, "successful_runs": { "default": 0, "title": "Successful Runs", "type": "integer" }, "terminal_cost_usd": { "default": 0.0, "title": "Terminal Cost Usd", "type": "number" }, "total_cost_usd": { "default": 0.0, "title": "Total Cost Usd", "type": "number" }, "window_runs": { "default": 0, "title": "Window Runs", "type": "integer" } }, "title": "UnitEconomicsReport", "type": "object" }, "UpdateWorkflowRequest": { "description": "Request body for updating an existing workflow.", "properties": { "edges": { "anyOf": [ { "items": { "$ref": "#/components/schemas/StudioEdgeInput" }, "type": "array" }, { "type": "null" } ], "title": "Edges" }, "entry_step": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entry Step" }, "execution_settings": { "anyOf": [ { "$ref": "#/components/schemas/StudioExecutionSettings" }, { "type": "null" } ] }, "name": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Name" }, "nodes": { "anyOf": [ { "items": { "$ref": "#/components/schemas/StudioNodeResponse" }, "type": "array" }, { "type": "null" } ], "title": "Nodes" }, "viewport": { "anyOf": [ { "$ref": "#/components/schemas/StudioViewport" }, { "type": "null" } ] } }, "title": "UpdateWorkflowRequest", "type": "object" }, "ValidationError": { "properties": { "ctx": { "title": "Context", "type": "object" }, "input": { "title": "Input" }, "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "title": "Location", "type": "array" }, "msg": { "title": "Message", "type": "string" }, "type": { "title": "Error Type", "type": "string" } }, "required": [ "loc", "msg", "type" ], "title": "ValidationError", "type": "object" }, "VerifyChainRequest": { "additionalProperties": false, "description": "Optional body for POST /runs/{run_id}/verify-chain.\n\nA client that recorded the chain head out-of-band can pin it: verification\nadditionally fails if the persisted head digest does not match.", "properties": { "expected_head_digest": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Expected Head Digest" } }, "title": "VerifyChainRequest", "type": "object" }, "WasteKind": { "description": "The category of an economic-waste finding.", "enum": [ "paid_for_failed_run", "loop_reexecution", "retry_overhead", "cache_inefficiency" ], "title": "WasteKind", "type": "string" }, "WasteKindTotal": { "additionalProperties": false, "description": "Per-kind waste totals across the window.", "properties": { "count": { "default": 0, "title": "Count", "type": "integer" }, "kind": { "$ref": "#/components/schemas/WasteKind" }, "wasted_usd": { "default": 0.0, "title": "Wasted Usd", "type": "number" } }, "required": [ "kind" ], "title": "WasteKindTotal", "type": "object" }, "WasteRollup": { "additionalProperties": false, "description": "Deployment-wide economic-waste rollup over a window of runs.", "properties": { "by_kind": { "items": { "$ref": "#/components/schemas/WasteKindTotal" }, "title": "By Kind", "type": "array" }, "confirmed_findings": { "default": 0, "title": "Confirmed Findings", "type": "integer" }, "cost_measurement_complete": { "default": true, "title": "Cost Measurement Complete", "type": "boolean" }, "estimated_cost_usd": { "default": 0.0, "title": "Estimated Cost Usd", "type": "number" }, "findings": { "default": 0, "title": "Findings", "type": "integer" }, "flagged_findings": { "default": 0, "title": "Flagged Findings", "type": "integer" }, "note": { "default": "", "title": "Note", "type": "string" }, "runs_with_cost": { "default": 0, "title": "Runs With Cost", "type": "integer" }, "runs_with_waste": { "default": 0, "title": "Runs With Waste", "type": "integer" }, "top_findings": { "items": { "$ref": "#/components/schemas/WasteRollupFinding" }, "title": "Top Findings", "type": "array" }, "total_confirmed_waste_usd": { "default": 0.0, "title": "Total Confirmed Waste Usd", "type": "number" }, "total_cost_usd": { "default": 0.0, "title": "Total Cost Usd", "type": "number" }, "total_flagged_waste_usd": { "default": 0.0, "title": "Total Flagged Waste Usd", "type": "number" }, "waste_ratio": { "default": 0.0, "title": "Waste Ratio", "type": "number" }, "window_runs": { "default": 0, "title": "Window Runs", "type": "integer" } }, "title": "WasteRollup", "type": "object" }, "WasteRollupFinding": { "additionalProperties": false, "description": "A waste finding tagged with the run it came from, so it stays actionable.", "properties": { "confirmed": { "default": false, "title": "Confirmed", "type": "boolean" }, "detail": { "default": "", "title": "Detail", "type": "string" }, "kind": { "$ref": "#/components/schemas/WasteKind" }, "metadata": { "additionalProperties": true, "title": "Metadata", "type": "object" }, "node_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Node Id" }, "run_id": { "title": "Run Id", "type": "string" }, "severity": { "default": "info", "title": "Severity", "type": "string" }, "wasted_usd": { "default": 0.0, "title": "Wasted Usd", "type": "number" } }, "required": [ "kind", "run_id" ], "title": "WasteRollupFinding", "type": "object" }, "WebhookDeadLetterListResponse": { "additionalProperties": false, "description": "Response for listing dead-letter entries.", "properties": { "dead_letters": { "items": { "$ref": "#/components/schemas/WebhookDeadLetterResponse" }, "title": "Dead Letters", "type": "array" }, "total": { "title": "Total", "type": "integer" } }, "required": [ "dead_letters", "total" ], "title": "WebhookDeadLetterListResponse", "type": "object" }, "WebhookDeadLetterResponse": { "additionalProperties": false, "description": "Response for a single dead-letter entry.", "properties": { "approval_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Approval Id" }, "attempt_count": { "title": "Attempt Count", "type": "integer" }, "created_at": { "title": "Created At", "type": "string" }, "dead_letter_id": { "title": "Dead Letter Id", "type": "string" }, "dead_lettered_at": { "title": "Dead Lettered At", "type": "string" }, "delivery_id": { "title": "Delivery Id", "type": "string" }, "event_id": { "title": "Event Id", "type": "string" }, "event_type": { "title": "Event Type", "type": "string" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Error" }, "last_status_code": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Last Status Code" }, "run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" }, "subscription_id": { "title": "Subscription Id", "type": "string" } }, "required": [ "dead_letter_id", "delivery_id", "subscription_id", "event_type", "event_id", "attempt_count", "last_error", "last_status_code", "created_at", "dead_lettered_at" ], "title": "WebhookDeadLetterResponse", "type": "object" }, "WebhookDeliveryListResponse": { "additionalProperties": false, "description": "Response for listing scoped webhook delivery state.", "properties": { "deliveries": { "items": { "$ref": "#/components/schemas/WebhookDeliveryResponse" }, "title": "Deliveries", "type": "array" }, "total": { "title": "Total", "type": "integer" } }, "required": [ "deliveries", "total" ], "title": "WebhookDeliveryListResponse", "type": "object" }, "WebhookDeliveryResponse": { "additionalProperties": false, "description": "Safe operator view of one delivery; payload and secret are intentionally absent.", "properties": { "approval_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Approval Id" }, "attempt_count": { "title": "Attempt Count", "type": "integer" }, "created_at": { "title": "Created At", "type": "string" }, "delivery_id": { "title": "Delivery Id", "type": "string" }, "event_id": { "title": "Event Id", "type": "string" }, "event_type": { "title": "Event Type", "type": "string" }, "last_error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Last Error" }, "last_status_code": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Last Status Code" }, "max_attempts": { "title": "Max Attempts", "type": "integer" }, "run_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" }, "status": { "title": "Status", "type": "string" }, "subscription_id": { "title": "Subscription Id", "type": "string" }, "updated_at": { "title": "Updated At", "type": "string" } }, "required": [ "delivery_id", "subscription_id", "event_type", "event_id", "status", "attempt_count", "max_attempts", "last_error", "last_status_code", "created_at", "updated_at" ], "title": "WebhookDeliveryResponse", "type": "object" }, "WebhookEventType": { "description": "Types of events that can trigger webhook deliveries.", "enum": [ "run.completed", "run.failed", "approval.requested", "approval.resolved", "approval.escalated" ], "title": "WebhookEventType", "type": "string" }, "WebhookSubscriptionListResponse": { "additionalProperties": false, "description": "Response for listing webhook subscriptions.", "properties": { "subscriptions": { "items": { "$ref": "#/components/schemas/WebhookSubscriptionResponse" }, "title": "Subscriptions", "type": "array" }, "total": { "title": "Total", "type": "integer" } }, "required": [ "subscriptions", "total" ], "title": "WebhookSubscriptionListResponse", "type": "object" }, "WebhookSubscriptionResponse": { "additionalProperties": false, "description": "Response for a single webhook subscription.", "properties": { "active": { "title": "Active", "type": "boolean" }, "created_at": { "title": "Created At", "type": "string" }, "deployment_ref": { "title": "Deployment Ref", "type": "string" }, "event_types": { "items": { "type": "string" }, "title": "Event Types", "type": "array" }, "secret": { "title": "Secret", "type": "string" }, "subscription_id": { "title": "Subscription Id", "type": "string" }, "target_url": { "title": "Target Url", "type": "string" }, "tenant_id": { "title": "Tenant Id", "type": "string" }, "updated_at": { "title": "Updated At", "type": "string" } }, "required": [ "subscription_id", "deployment_ref", "tenant_id", "target_url", "secret", "event_types", "active", "created_at", "updated_at" ], "title": "WebhookSubscriptionResponse", "type": "object" }, "WorkflowDetailResponse": { "description": "Full workflow representation with nodes, edges, and viewport.", "properties": { "edges": { "items": { "$ref": "#/components/schemas/StudioEdgeResponse" }, "title": "Edges", "type": "array" }, "entry_step": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Entry Step" }, "execution_settings": { "$ref": "#/components/schemas/StudioExecutionSettings" }, "id": { "title": "Id", "type": "string" }, "name": { "title": "Name", "type": "string" }, "nodes": { "items": { "$ref": "#/components/schemas/StudioNodeResponse" }, "title": "Nodes", "type": "array" }, "status": { "title": "Status", "type": "string" }, "updated_at": { "title": "Updated At", "type": "string" }, "version": { "title": "Version", "type": "integer" }, "viewport": { "$ref": "#/components/schemas/StudioViewport" } }, "required": [ "id", "name", "version", "status", "nodes", "edges", "viewport", "updated_at" ], "title": "WorkflowDetailResponse", "type": "object" }, "WorkflowEconomics": { "additionalProperties": false, "description": "Unit economics for one workflow within a deployment.", "properties": { "cost_per_successful_run_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Cost Per Successful Run Usd" }, "estimated_cost_per_successful_run_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Estimated Cost Per Successful Run Usd" }, "estimated_failure_tax_usd": { "default": 0.0, "title": "Estimated Failure Tax Usd", "type": "number" }, "estimated_terminal_cost_usd": { "default": 0.0, "title": "Estimated Terminal Cost Usd", "type": "number" }, "failed_runs": { "default": 0, "title": "Failed Runs", "type": "integer" }, "failure_tax_usd": { "default": 0.0, "title": "Failure Tax Usd", "type": "number" }, "runs": { "default": 0, "title": "Runs", "type": "integer" }, "success_rate": { "default": 0.0, "title": "Success Rate", "type": "number" }, "successful_runs": { "default": 0, "title": "Successful Runs", "type": "integer" }, "terminal_cost_usd": { "default": 0.0, "title": "Terminal Cost Usd", "type": "number" }, "workflow_name": { "title": "Workflow Name", "type": "string" } }, "required": [ "workflow_name" ], "title": "WorkflowEconomics", "type": "object" }, "WorkflowPreflightIssue": { "properties": { "code": { "title": "Code", "type": "string" }, "edge_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Edge Id" }, "message": { "title": "Message", "type": "string" }, "node_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Node Id" }, "severity": { "enum": [ "error", "warning" ], "title": "Severity", "type": "string" } }, "required": [ "severity", "code", "message" ], "title": "WorkflowPreflightIssue", "type": "object" }, "WorkflowPreflightResponse": { "properties": { "checks": { "items": { "type": "string" }, "title": "Checks", "type": "array" }, "issues": { "items": { "$ref": "#/components/schemas/WorkflowPreflightIssue" }, "title": "Issues", "type": "array" }, "ready": { "title": "Ready", "type": "boolean" }, "version": { "title": "Version", "type": "integer" }, "workflow_id": { "title": "Workflow Id", "type": "string" } }, "required": [ "workflow_id", "version", "ready", "checks", "issues" ], "title": "WorkflowPreflightResponse", "type": "object" }, "WorkflowSummaryResponse": { "description": "Compact workflow representation for list views.", "properties": { "id": { "title": "Id", "type": "string" }, "name": { "title": "Name", "type": "string" }, "status": { "title": "Status", "type": "string" }, "updated_at": { "title": "Updated At", "type": "string" }, "version": { "title": "Version", "type": "integer" } }, "required": [ "id", "name", "version", "status", "updated_at" ], "title": "WorkflowSummaryResponse", "type": "object" } } }, "info": { "description": "Governed medium-code platform for production-grade multi-agent systems", "title": "Zeroth Platform API", "version": "1.0.0" }, "openapi": "3.1.0", "paths": { "/api/studio/v1/contracts": { "get": { "description": "List registered contracts (latest version each) for contract-ref pickers.", "operationId": "list_contracts_api_studio_v1_contracts_get", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/StudioContractResponse" }, "title": "Response List Contracts Api Studio V1 Contracts Get", "type": "array" } } }, "description": "Successful Response" } }, "summary": "List Contracts", "tags": [ "studio" ] }, "post": { "description": "Register a schema-only contract authored in the console.\n\nThe schema is arbitrary JSON Schema \u2014 payload validation at run ingress\nhonors it exactly. Re-registering an existing name creates the next\nversion (the picker lists the latest).", "operationId": "create_contract_api_studio_v1_contracts_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateContractRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StudioContractResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Contract", "tags": [ "studio" ] } }, "/api/studio/v1/node-types": { "get": { "description": "Return all available node types with their port definitions.", "operationId": "list_node_types_api_studio_v1_node_types_get", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/NodeTypeResponse" }, "title": "Response List Node Types Api Studio V1 Node Types Get", "type": "array" } } }, "description": "Successful Response" } }, "summary": "List Node Types", "tags": [ "studio" ] } }, "/api/studio/v1/workflows": { "get": { "description": "List all workflows as summaries.", "operationId": "list_workflows_api_studio_v1_workflows_get", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/WorkflowSummaryResponse" }, "title": "Response List Workflows Api Studio V1 Workflows Get", "type": "array" } } }, "description": "Successful Response" } }, "summary": "List Workflows", "tags": [ "studio" ] }, "post": { "description": "Create a new workflow with default Studio metadata.", "operationId": "create_workflow_api_studio_v1_workflows_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateWorkflowRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkflowDetailResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Workflow", "tags": [ "studio" ] } }, "/api/studio/v1/workflows/{workflow_id}": { "delete": { "description": "Archive a workflow (soft delete).", "operationId": "delete_workflow_api_studio_v1_workflows__workflow_id__delete", "parameters": [ { "in": "path", "name": "workflow_id", "required": true, "schema": { "title": "Workflow Id", "type": "string" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Delete Workflow", "tags": [ "studio" ] }, "get": { "description": "Get a workflow with full detail including nodes, edges, and viewport.", "operationId": "get_workflow_api_studio_v1_workflows__workflow_id__get", "parameters": [ { "in": "path", "name": "workflow_id", "required": true, "schema": { "title": "Workflow Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkflowDetailResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Workflow", "tags": [ "studio" ] }, "put": { "description": "Update a workflow's name, structure (nodes/edges), and visual layout.\n\nOnly draft graphs are editable \u2014 published versions are immutable; clone one\nto a draft first (POST .../clone). When ``nodes`` are supplied they are built\ninto real executable graph nodes (and ``edges`` into graph edges), so the\ncanvas authors the actual graph, not just visual metadata.", "operationId": "update_workflow_api_studio_v1_workflows__workflow_id__put", "parameters": [ { "in": "path", "name": "workflow_id", "required": true, "schema": { "title": "Workflow Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UpdateWorkflowRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkflowDetailResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Update Workflow", "tags": [ "studio" ] } }, "/api/studio/v1/workflows/{workflow_id}/clone": { "post": { "description": "Clone a published workflow into a new editable draft version.", "operationId": "clone_workflow_api_studio_v1_workflows__workflow_id__clone_post", "parameters": [ { "in": "path", "name": "workflow_id", "required": true, "schema": { "title": "Workflow Id", "type": "string" } } ], "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkflowDetailResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Clone Workflow", "tags": [ "studio" ] } }, "/api/studio/v1/workflows/{workflow_id}/diff": { "get": { "description": "Structured diff between two versions of a workflow.", "operationId": "diff_workflow_api_studio_v1_workflows__workflow_id__diff_get", "parameters": [ { "in": "path", "name": "workflow_id", "required": true, "schema": { "title": "Workflow Id", "type": "string" } }, { "in": "query", "name": "left", "required": true, "schema": { "title": "Left", "type": "integer" } }, { "in": "query", "name": "right", "required": true, "schema": { "title": "Right", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": true, "title": "Response Diff Workflow Api Studio V1 Workflows Workflow Id Diff Get", "type": "object" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Diff Workflow", "tags": [ "studio" ] } }, "/api/studio/v1/workflows/{workflow_id}/preflight": { "post": { "description": "Prove structural and dependency readiness without executing any node.\n\nThis deliberately does not call models, tools, connectors, or child graphs.\nConnectivity and live-provider verification remain separately labelled\nevidence because a preflight must be safe to run against side-effecting\nworkflows.", "operationId": "preflight_workflow_api_studio_v1_workflows__workflow_id__preflight_post", "parameters": [ { "in": "path", "name": "workflow_id", "required": true, "schema": { "title": "Workflow Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkflowPreflightResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Preflight Workflow", "tags": [ "studio" ] } }, "/api/studio/v1/workflows/{workflow_id}/publish": { "post": { "description": "Validate and publish the draft, making it immutable and deployable.\n\nValidation failures return 422 with the structured issue list so the\ncanvas can point at the offending node/edge.", "operationId": "publish_workflow_api_studio_v1_workflows__workflow_id__publish_post", "parameters": [ { "in": "path", "name": "workflow_id", "required": true, "schema": { "title": "Workflow Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkflowDetailResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Publish Workflow", "tags": [ "studio" ] } }, "/api/studio/v1/workflows/{workflow_id}/verify-provider": { "post": { "description": "Run a bounded, explicitly consented probe against each distinct agent model.", "operationId": "verify_workflow_providers_api_studio_v1_workflows__workflow_id__verify_provider_post", "parameters": [ { "in": "path", "name": "workflow_id", "required": true, "schema": { "title": "Workflow Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveProviderVerificationRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LiveProviderVerificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Verify Workflow Providers", "tags": [ "studio" ] } }, "/health": { "get": { "operationId": "health_health_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthResponse" } } }, "description": "Successful Response" } }, "summary": "Health" } }, "/health/live": { "get": { "operationId": "health_live_health_live_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LivenessResponse" } } }, "description": "Successful Response" } }, "summary": "Health Live" } }, "/health/ready": { "get": { "operationId": "health_ready_health_ready_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadinessResponse" } } }, "description": "Successful Response" } }, "summary": "Health Ready" } }, "/v1/admin/audits": { "get": { "description": "List audit records across the caller's tenant-visible deployments.", "operationId": "list_tenant_audits_v1_admin_audits_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TenantAuditRecordListResponse" } } }, "description": "Successful Response" } }, "summary": "List Tenant Audits", "tags": [ "v1" ] } }, "/v1/admin/runs": { "get": { "operationId": "list_admin_runs_v1_admin_runs_get", "parameters": [ { "in": "query", "name": "status_filter", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Status Filter" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "maximum": 1000000, "minimum": 0, "title": "Offset", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdminRunListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Admin Runs", "tags": [ "v1" ] } }, "/v1/admin/runs/{run_id}/cancel": { "post": { "operationId": "cancel_run_v1_admin_runs__run_id__cancel_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunStatusResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Cancel Run", "tags": [ "v1" ] } }, "/v1/admin/runs/{run_id}/interrupt": { "post": { "description": "Interrupt a running run (transitions to WAITING_INTERRUPT).", "operationId": "interrupt_run_v1_admin_runs__run_id__interrupt_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunStatusResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Interrupt Run", "tags": [ "v1" ] } }, "/v1/admin/runs/{run_id}/replay": { "post": { "description": "Replay a dead-letter or failed run by resetting it to PENDING.", "operationId": "replay_run_v1_admin_runs__run_id__replay_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunStatusResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Replay Run", "tags": [ "v1" ] } }, "/v1/artifacts/{artifact_id}": { "get": { "operationId": "get_artifact_v1_artifacts__artifact_id__get", "parameters": [ { "in": "path", "name": "artifact_id", "required": true, "schema": { "title": "Artifact Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Artifact", "tags": [ "v1" ] } }, "/v1/audit-readiness": { "get": { "operationId": "audit_readiness_v1_audit_readiness_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditReadinessResponse" } } }, "description": "Successful Response" } }, "summary": "Audit Readiness", "tags": [ "v1" ] } }, "/v1/certifications": { "get": { "operationId": "list_certifications_v1_certifications_get", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/CertificationResponse" }, "title": "Response List Certifications V1 Certifications Get", "type": "array" } } }, "description": "Successful Response" } }, "summary": "List Certifications", "tags": [ "v1" ] }, "post": { "operationId": "create_certification_v1_certifications_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RegisterCertificationRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CertificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Certification", "tags": [ "v1" ] } }, "/v1/certifications/{certification_id}": { "get": { "operationId": "get_certification_v1_certifications__certification_id__get", "parameters": [ { "in": "path", "name": "certification_id", "required": true, "schema": { "title": "Certification Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CertificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Certification", "tags": [ "v1" ] } }, "/v1/certifications/{certification_id}/override": { "post": { "operationId": "override_certification_v1_certifications__certification_id__override_post", "parameters": [ { "in": "path", "name": "certification_id", "required": true, "schema": { "title": "Certification Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CertificationOverrideRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CertificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Override Certification", "tags": [ "v1" ] } }, "/v1/certifications/{certification_id}/promote": { "post": { "operationId": "promote_certification_v1_certifications__certification_id__promote_post", "parameters": [ { "in": "path", "name": "certification_id", "required": true, "schema": { "title": "Certification Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PromoteCertificationRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CertificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Promote Certification", "tags": [ "v1" ] } }, "/v1/certifications/{certification_id}/revoke": { "post": { "operationId": "revoke_certification_v1_certifications__certification_id__revoke_post", "parameters": [ { "in": "path", "name": "certification_id", "required": true, "schema": { "title": "Certification Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeCertificationRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CertificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Revoke Certification", "tags": [ "v1" ] } }, "/v1/connectors": { "get": { "description": "All memory connectors registered for this deployment, by ref.\n\nThese are the values a retrieval node's ``connector_ref`` (and an\nagent's ``memory_refs``) can resolve at run time. Runtime-managed\nconnectors include their backend_type and secret-masked params;\nenv-sourced connectors return ``params=None``.", "operationId": "list_connectors_v1_connectors_get", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ConnectorSummaryResponse" }, "title": "Response List Connectors V1 Connectors Get", "type": "array" } } }, "description": "Successful Response" } }, "summary": "List Connectors", "tags": [ "v1" ] }, "post": { "description": "Create a runtime-managed connector: build, persist, then register live.\n\nBackend construction is cheap and may connect lazily (pgvector opens\nits first connection on first use) -- use POST /connectors/{ref}/test\nfor a real connectivity check.\n\nA02-19: the live registry is an in-process dict and the config store is\nSQL, so no transaction spans them. The ordering is what makes that safe:\nthe two steps that can fail come first and leave nothing behind, and the\none step that cannot fail -- assigning into the registry -- goes last.\nRegistering first meant a failed write left a connector serving\n``connector_ref`` lookups in this process and nowhere else, which\nvanished at the next restart.", "operationId": "create_connector_v1_connectors_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorCreateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorSummaryResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Connector", "tags": [ "v1" ] } }, "/v1/connectors/{ref}": { "delete": { "description": "Delete a runtime-managed connector (env-sourced ones cannot be deleted).\n\nA02-19: the durable delete goes first for the same reason create's goes\nlast -- unregistering first meant a failed row delete left the connector\nunresolvable in this process while its config survived, so the next\nrestart resurrected it.", "operationId": "delete_connector_v1_connectors__ref__delete", "parameters": [ { "in": "path", "name": "ref", "required": true, "schema": { "title": "Ref", "type": "string" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Delete Connector", "tags": [ "v1" ] }, "put": { "description": "Reconfigure an existing runtime-managed connector (rebuild + re-register).\n\nA02-19: same ordering rule as create -- the reconfiguration only goes\nlive once it is durable, so a failed write leaves the previous backend\nboth live and persisted instead of swapping in one that reverts at the\nnext restart.", "operationId": "update_connector_v1_connectors__ref__put", "parameters": [ { "in": "path", "name": "ref", "required": true, "schema": { "title": "Ref", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorUpdateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorSummaryResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Update Connector", "tags": [ "v1" ] } }, "/v1/connectors/{ref}/test": { "post": { "description": "Probe the LIVE connector with a tiny write+read round-trip.\n\nWorks for both env-sourced and runtime connectors. Connection\nfailures never raise 500 -- they come back as ``ok=false`` with the\nerror message. The probe is capped at 5 seconds.\n\nNote: pgvector's write path generates an embedding via litellm, so\nprobing a pgvector connector performs one (tiny) embedding API call.", "operationId": "test_connector_v1_connectors__ref__test_post", "parameters": [ { "in": "path", "name": "ref", "required": true, "schema": { "title": "Ref", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ConnectorTestRequest" }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConnectorTestResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Test Connector", "tags": [ "v1" ] } }, "/v1/deployments": { "get": { "description": "All persisted deployment versions, newest first.\n\n``serving`` marks the deployment version this service instance was\nbootstrapped with (the one /health reports).", "operationId": "list_deployments_v1_deployments_get", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/DeploymentSummaryResponse" }, "title": "Response List Deployments V1 Deployments Get", "type": "array" } } }, "description": "Successful Response" } }, "summary": "List Deployments", "tags": [ "v1" ] }, "post": { "description": "Create a deployment version from a published graph.\n\nCompletes the authoring loop without Python: publish the graph\n(studio API), deploy it here, then restart the service with\n``ZEROTH_DEPLOYMENT_REF`` set to the new ref to serve it.", "operationId": "create_deployment_v1_deployments_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateDeploymentRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentSummaryResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Deployment", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/approvals": { "get": { "operationId": "list_approvals_v1_deployments__deployment_ref__approvals_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } }, { "in": "query", "name": "approval_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Approval Id" } }, { "in": "query", "name": "run_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, { "in": "query", "name": "thread_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thread Id" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ApprovalRecord" }, "title": "Response List Approvals V1 Deployments Deployment Ref Approvals Get", "type": "array" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Approvals", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/approvals/{approval_id}": { "get": { "operationId": "get_approval_v1_deployments__deployment_ref__approvals__approval_id__get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } }, { "in": "path", "name": "approval_id", "required": true, "schema": { "title": "Approval Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApprovalRecord" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Approval", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/approvals/{approval_id}/resolve": { "post": { "operationId": "resolve_approval_v1_deployments__deployment_ref__approvals__approval_id__resolve_post", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } }, { "in": "path", "name": "approval_id", "required": true, "schema": { "title": "Approval Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApprovalResolutionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApprovalResolutionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Resolve Approval", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/attestation": { "get": { "description": "Return the persisted deployment attestation; requires ``Permission.DEPLOYMENT_READ``.", "operationId": "get_attestation_v1_deployments__deployment_ref__attestation_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentAttestationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Attestation", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/attestation/verify": { "get": { "description": "Server self-verifies its persisted attestation (digest + signature).", "operationId": "get_attestation_verify_v1_deployments__deployment_ref__attestation_verify_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttestationVerificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Attestation Verify", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/audit-verification": { "get": { "description": "Verify digest continuity + signatures across every run of a deployment.", "operationId": "verify_deployment_audit_chain_v1_deployments__deployment_ref__audit_verification_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditVerificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Verify Deployment Audit Chain", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/audits": { "get": { "description": "List a deployment's audit records; requires ``Permission.AUDIT_READ``.", "operationId": "list_audits_v1_deployments__deployment_ref__audits_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } }, { "in": "query", "name": "run_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Run Id" } }, { "in": "query", "name": "thread_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thread Id" } }, { "in": "query", "name": "node_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Node Id" } }, { "in": "query", "name": "graph_version_ref", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Graph Version Ref" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditRecordListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Audits", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/cost": { "get": { "description": "Return cumulative spend for a deployment (per D-15, D-16).", "operationId": "get_deployment_cost_v1_deployments__deployment_ref__cost_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentCostResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Deployment Cost", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/evidence": { "get": { "description": "Return the evidence bundle for a deployment; requires ``Permission.AUDIT_READ``.", "operationId": "get_deployment_evidence_v1_deployments__deployment_ref__evidence_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentEvidenceResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Deployment Evidence", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/guardrails": { "get": { "operationId": "get_deployment_guardrails_v1_deployments__deployment_ref__guardrails_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuardrailPolicyResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Deployment Guardrails", "tags": [ "v1" ] }, "put": { "operationId": "put_deployment_guardrails_v1_deployments__deployment_ref__guardrails_put", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuardrailPolicyPatch" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuardrailPolicyResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Put Deployment Guardrails", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/input-contract": { "get": { "operationId": "get_input_contract_v1_deployments__deployment_ref__input_contract_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicContractSchemaResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Input Contract", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/metadata": { "get": { "operationId": "get_deployment_metadata_v1_deployments__deployment_ref__metadata_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentVersionMetadataResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Deployment Metadata", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/operations/{operation_key}/resolve": { "post": { "operationId": "resolve_ambiguous_operation_v1_deployments__deployment_ref__operations__operation_key__resolve_post", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } }, { "in": "path", "name": "operation_key", "required": true, "schema": { "title": "Operation Key", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OperationResolutionRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OperationResolutionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Resolve Ambiguous Operation", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/output-contract": { "get": { "operationId": "get_output_contract_v1_deployments__deployment_ref__output_contract_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PublicContractSchemaResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Output Contract", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/result-error-state-schema": { "get": { "operationId": "get_result_error_state_schema_v1_deployments__deployment_ref__result_error_state_schema_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentResultErrorStateSchemaResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Result Error State Schema", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/rollback": { "post": { "description": "Create a new deployment version pinned to an earlier graph version.", "operationId": "rollback_deployment_v1_deployments__deployment_ref__rollback_post", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RollbackDeploymentRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentSummaryResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Rollback Deployment", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/timeline": { "get": { "description": "Return a deployment's ordered audit timeline; requires ``Permission.AUDIT_READ``.", "operationId": "get_deployment_timeline_v1_deployments__deployment_ref__timeline_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditTimelineResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Deployment Timeline", "tags": [ "v1" ] } }, "/v1/deployments/{deployment_ref}/verify-attestation": { "post": { "description": "Verify a client-supplied attestation against the bound deployment.", "operationId": "post_verify_attestation_v1_deployments__deployment_ref__verify_attestation_post", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentAttestationResponse" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttestationVerificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Verify Attestation", "tags": [ "v1" ] } }, "/v1/econ/configuration": { "get": { "description": "Return effective, non-secret economics controls for this deployment.\n\nThe values are read from the already-built runtime rather than reloading\nprocess environment, so the console shows what this process enforces.", "operationId": "get_economics_configuration_v1_econ_configuration_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EconomicsConfigurationResponse" } } }, "description": "Successful Response" } }, "summary": "Get Economics Configuration", "tags": [ "v1" ] } }, "/v1/econ/dashboard/action-suppression": { "get": { "operationId": "econ_dashboard_action_suppression_v1_econ_dashboard_action_suppression_get", "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Econ Dashboard Action Suppression V1 Econ Dashboard Action Suppression Get" } } }, "description": "Successful Response" } }, "summary": "Econ Dashboard Action Suppression", "tags": [ "v1" ] } }, "/v1/econ/dashboard/calibration-trend": { "get": { "operationId": "econ_dashboard_calibration_trend_v1_econ_dashboard_calibration_trend_get", "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Econ Dashboard Calibration Trend V1 Econ Dashboard Calibration Trend Get" } } }, "description": "Successful Response" } }, "summary": "Econ Dashboard Calibration Trend", "tags": [ "v1" ] } }, "/v1/econ/dashboard/capability-ranking": { "get": { "operationId": "econ_dashboard_capability_ranking_v1_econ_dashboard_capability_ranking_get", "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Econ Dashboard Capability Ranking V1 Econ Dashboard Capability Ranking Get" } } }, "description": "Successful Response" } }, "summary": "Econ Dashboard Capability Ranking", "tags": [ "v1" ] } }, "/v1/econ/dashboard/capital-destroyers": { "get": { "operationId": "econ_dashboard_capital_destroyers_v1_econ_dashboard_capital_destroyers_get", "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Econ Dashboard Capital Destroyers V1 Econ Dashboard Capital Destroyers Get" } } }, "description": "Successful Response" } }, "summary": "Econ Dashboard Capital Destroyers", "tags": [ "v1" ] } }, "/v1/econ/dashboard/confidence-trend": { "get": { "operationId": "econ_dashboard_confidence_trend_v1_econ_dashboard_confidence_trend_get", "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Econ Dashboard Confidence Trend V1 Econ Dashboard Confidence Trend Get" } } }, "description": "Successful Response" } }, "summary": "Econ Dashboard Confidence Trend", "tags": [ "v1" ] } }, "/v1/econ/dashboard/data-quality-mix": { "get": { "operationId": "econ_dashboard_data_quality_mix_v1_econ_dashboard_data_quality_mix_get", "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Econ Dashboard Data Quality Mix V1 Econ Dashboard Data Quality Mix Get" } } }, "description": "Successful Response" } }, "summary": "Econ Dashboard Data Quality Mix", "tags": [ "v1" ] } }, "/v1/econ/dashboard/efficiency-trend": { "get": { "operationId": "econ_dashboard_efficiency_trend_v1_econ_dashboard_efficiency_trend_get", "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Econ Dashboard Efficiency Trend V1 Econ Dashboard Efficiency Trend Get" } } }, "description": "Successful Response" } }, "summary": "Econ Dashboard Efficiency Trend", "tags": [ "v1" ] } }, "/v1/econ/dashboard/kpis": { "get": { "operationId": "econ_dashboard_kpis_v1_econ_dashboard_kpis_get", "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Econ Dashboard Kpis V1 Econ Dashboard Kpis Get" } } }, "description": "Successful Response" } }, "summary": "Econ Dashboard Kpis", "tags": [ "v1" ] } }, "/v1/econ/dashboard/top-creators": { "get": { "operationId": "econ_dashboard_top_creators_v1_econ_dashboard_top_creators_get", "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Econ Dashboard Top Creators V1 Econ Dashboard Top Creators Get" } } }, "description": "Successful Response" } }, "summary": "Econ Dashboard Top Creators", "tags": [ "v1" ] } }, "/v1/econ/quality-verdict": { "post": { "description": "Attach an external good/bad verdict to a terminal run for quality-aware economics.\n\nThe runtime can't know whether an answer was *good*, so this is the honest way to\nfeed that signal in: a human reviewer or downstream check records a verdict, and\nunit economics then reports cost per good outcome over the labeled subset.\n\nAnnotation, not evidence \u2014 it merges under ``run.metadata['quality_verdict']`` and is\ndeliberately off the audit hash-chain. Admin-only (``METRICS_ADMIN``). 404 for an\nunknown or out-of-deployment run; 409 for a non-terminal run (no outcome to judge yet).", "operationId": "attach_quality_verdict_v1_econ_quality_verdict_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QualityVerdictRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunQualityVerdict" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Attach Quality Verdict", "tags": [ "v1" ] } }, "/v1/econ/regulus/costing/estimates/{capability_id}/latest": { "get": { "operationId": "regulus_costing_estimate_v1_econ_regulus_costing_estimates__capability_id__latest_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Costing Estimate", "tags": [ "v1" ] } }, "/v1/econ/regulus/costing/profiles/{profile_id}": { "get": { "operationId": "regulus_costing_profile_v1_econ_regulus_costing_profiles__profile_id__get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Costing Profile", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/action-suppression": { "get": { "operationId": "regulus_dashboard_action_suppression_v1_econ_regulus_dashboard_action_suppression_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Action Suppression", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/calibration-trend": { "get": { "operationId": "regulus_dashboard_calibration_trend_v1_econ_regulus_dashboard_calibration_trend_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Calibration Trend", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/capability-ranking": { "get": { "operationId": "regulus_dashboard_capability_ranking_v1_econ_regulus_dashboard_capability_ranking_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Capability Ranking", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/capital-destroyers": { "get": { "operationId": "regulus_dashboard_capital_destroyers_v1_econ_regulus_dashboard_capital_destroyers_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Capital Destroyers", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/confidence-gate-status": { "get": { "operationId": "regulus_dashboard_confidence_gate_v1_econ_regulus_dashboard_confidence_gate_status_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Confidence Gate", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/confidence-trend": { "get": { "operationId": "regulus_dashboard_confidence_trend_v1_econ_regulus_dashboard_confidence_trend_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Confidence Trend", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/data-quality-mix": { "get": { "operationId": "regulus_dashboard_data_quality_v1_econ_regulus_dashboard_data_quality_mix_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Data Quality", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/drift-timeline/{capability_id}": { "get": { "operationId": "regulus_dashboard_drift_timeline_v1_econ_regulus_dashboard_drift_timeline__capability_id__get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Drift Timeline", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/efficiency-trend": { "get": { "operationId": "regulus_dashboard_efficiency_trend_v1_econ_regulus_dashboard_efficiency_trend_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Efficiency Trend", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/implementation-compare/{capability_id}": { "get": { "operationId": "regulus_dashboard_implementation_compare_v1_econ_regulus_dashboard_implementation_compare__capability_id__get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Implementation Compare", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/kpis": { "get": { "operationId": "regulus_dashboard_kpis_v1_econ_regulus_dashboard_kpis_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Kpis", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/policy-timeline": { "get": { "operationId": "regulus_dashboard_policy_timeline_v1_econ_regulus_dashboard_policy_timeline_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Policy Timeline", "tags": [ "v1" ] } }, "/v1/econ/regulus/dashboard/top-creators": { "get": { "operationId": "regulus_dashboard_top_creators_v1_econ_regulus_dashboard_top_creators_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Dashboard Top Creators", "tags": [ "v1" ] } }, "/v1/econ/regulus/enforcement/actions": { "get": { "operationId": "regulus_enforcement_actions_v1_econ_regulus_enforcement_actions_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Enforcement Actions", "tags": [ "v1" ] } }, "/v1/econ/regulus/enforcement/actions/{action_id}/approve": { "post": { "operationId": "regulus_enforcement_approve_v1_econ_regulus_enforcement_actions__action_id__approve_post", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Enforcement Approve", "tags": [ "v1" ] } }, "/v1/econ/regulus/enforcement/actions/{action_id}/reject": { "post": { "operationId": "regulus_enforcement_reject_v1_econ_regulus_enforcement_actions__action_id__reject_post", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Enforcement Reject", "tags": [ "v1" ] } }, "/v1/econ/regulus/enforcement/policy-actions": { "get": { "operationId": "regulus_enforcement_policy_actions_v1_econ_regulus_enforcement_policy_actions_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Enforcement Policy Actions", "tags": [ "v1" ] } }, "/v1/econ/regulus/evaluations/{capability_id}/history": { "get": { "operationId": "regulus_evaluations_history_v1_econ_regulus_evaluations__capability_id__history_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Evaluations History", "tags": [ "v1" ] } }, "/v1/econ/regulus/evaluations/{capability_id}/latest": { "get": { "operationId": "regulus_evaluations_latest_v1_econ_regulus_evaluations__capability_id__latest_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Evaluations Latest", "tags": [ "v1" ] } }, "/v1/econ/regulus/performance/capabilities": { "get": { "operationId": "regulus_performance_capabilities_v1_econ_regulus_performance_capabilities_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Performance Capabilities", "tags": [ "v1" ] } }, "/v1/econ/regulus/performance/summary": { "get": { "operationId": "regulus_performance_summary_v1_econ_regulus_performance_summary_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Performance Summary", "tags": [ "v1" ] } }, "/v1/econ/regulus/reconciliation/calibration-summary": { "get": { "operationId": "regulus_reconciliation_calibration_v1_econ_regulus_reconciliation_calibration_summary_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Reconciliation Calibration", "tags": [ "v1" ] } }, "/v1/econ/regulus/registry/capabilities": { "get": { "operationId": "regulus_registry_capabilities_v1_econ_regulus_registry_capabilities_get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Registry Capabilities", "tags": [ "v1" ] } }, "/v1/econ/regulus/registry/capabilities/{capability_id}": { "get": { "operationId": "regulus_registry_capability_v1_econ_regulus_registry_capabilities__capability_id__get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Registry Capability", "tags": [ "v1" ] } }, "/v1/econ/regulus/registry/implementations/{implementation_id}": { "get": { "operationId": "regulus_registry_implementation_v1_econ_regulus_registry_implementations__implementation_id__get", "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful Response" } }, "summary": "Regulus Registry Implementation", "tags": [ "v1" ] } }, "/v1/econ/rightsizing": { "post": { "description": "Return cheaper, capability-compatible alternatives to ``body.incumbent``.\n\nCandidates to A/B test, not a verdict \u2014 the endpoint gates on capability and\nprice only. An unknown incumbent returns ``incumbent_known=False`` (a 200 with an\nexplanation), never an error.", "operationId": "suggest_rightsizing_v1_econ_rightsizing_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RightsizingRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RightsizingResult" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Suggest Rightsizing", "tags": [ "v1" ] } }, "/v1/econ/rightsizing/experiment": { "post": { "description": "Replay this node's real inputs through cheaper models and measure equivalence.\n\nEvery branch returns a 200 with an explanatory ``note`` rather than an error: an\nunpriced incumbent, no cheaper candidates, no run history, or a missing provider key\nare all *results* of the measurement, not failures of the endpoint.", "operationId": "run_rightsizing_experiment_v1_econ_rightsizing_experiment_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExperimentRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExperimentReport" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Run Rightsizing Experiment", "tags": [ "v1" ] } }, "/v1/econ/rightsizing/experiment/latest": { "get": { "description": "Restore the latest completed measured result in the caller's deployment scope.", "operationId": "get_latest_rightsizing_experiment_v1_econ_rightsizing_experiment_latest_get", "responses": { "200": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/ExperimentReport" }, { "type": "null" } ], "title": "Response Get Latest Rightsizing Experiment V1 Econ Rightsizing Experiment Latest Get" } } }, "description": "Successful Response" } }, "summary": "Get Latest Rightsizing Experiment", "tags": [ "v1" ] } }, "/v1/econ/rightsizing/opportunities": { "get": { "description": "Rank this deployment's agent nodes by right-sizing opportunity (spend \u00d7 savings).\n\nRead-only aggregation over the audit trail \u2014 no LLM calls. Surfaces which nodes are\nworth a measured experiment. Returns an empty report (200) when no spend is on record.", "operationId": "rightsizing_opportunities_v1_econ_rightsizing_opportunities_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpendReport" } } }, "description": "Successful Response" } }, "summary": "Rightsizing Opportunities", "tags": [ "v1" ] } }, "/v1/econ/unit-economics": { "get": { "description": "Cost per successful outcome and the failure tax over the last ``window`` runs.\n\nRead-only aggregation over the run + audit trail \u2014 no LLM calls, no Regulus. Every\nstate is a 200: no runs, no attributed cost, or no successes yet are all *results*\ncarried in the report's ``note``, never errors. Returns 503 only when the\nrepositories themselves are unavailable.", "operationId": "get_unit_economics_v1_econ_unit_economics_get", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": 200, "maximum": 1000, "minimum": 1, "title": "Window", "type": "integer" } }, { "in": "query", "name": "scope", "required": false, "schema": { "default": "deployment", "enum": [ "deployment", "tenant" ], "title": "Scope", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UnitEconomicsReport" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Unit Economics", "tags": [ "v1" ] } }, "/v1/econ/waste": { "get": { "description": "Deployment-wide structural-waste rollup over the last ``window`` runs.\n\nRuns ``analyze_run`` per top-level run and sums confirmed (paid-for-failed) vs\nflagged (loops/retries) waste \u2014 which never share a dollar. Read-only, no LLM, no\nRegulus. Every data state is a 200 carried in ``note``; ``limit`` caps the returned\ntop findings. Returns 503 only when the repositories are unavailable.", "operationId": "get_waste_v1_econ_waste_get", "parameters": [ { "in": "query", "name": "window", "required": false, "schema": { "default": 200, "maximum": 1000, "minimum": 1, "title": "Window", "type": "integer" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 10, "maximum": 50, "minimum": 1, "title": "Limit", "type": "integer" } }, { "in": "query", "name": "scope", "required": false, "schema": { "default": "deployment", "enum": [ "deployment", "tenant" ], "title": "Scope", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WasteRollup" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Waste", "tags": [ "v1" ] } }, "/v1/enforcement/attestations": { "post": { "description": "Sign and record a run's start-of-run claims, if the run has none yet.\n\nA run's evidence is fixed by the first attestation the server accepts.\nA submission that loses to an earlier one answers 409 and reports\n``authoritative: false`` together with the digest of the attestation\nactually in force -- never a bare 200, which would tell the client its\nown claims are what the run will be judged on.\n\n**The winner is disclosed only when it belongs to the deployment the\ncaller named.** Correlations are unique per tenant, not per deployment,\nso a loser may have lost to a sibling deployment's run; that case\nanswers a fixed, opaque 409 instead, because the alternative is an\noracle for reading another deployment's digest and expiry.\n\n**A retry of the attestation already in force is not a second\nattestation.** The server stamps ``issued_at`` and ``expires_at`` on\narrival, so an adapter that lost its response cannot resubmit the bytes\nit sent -- the digest and signature differ on every attempt, and an\nenvelope comparison alone would tell an honest retry that some other\nattestation governs its run. ``is_identical_resubmission`` decides that\ncase on the claims plus a re-signature of the stored payload; when it\nholds, the caller gets the *original* acceptance back. Changed claims,\na rotated key, and a signed/unsigned change all still answer 409.\n\n**A losing insert is not always a lost race.** Two concurrent identical\nrequests stamped with the same ``issued_at`` build the same payload, so\ndeterministic signing gives the loser an envelope equal to the winner's:\na duplicate, not a conflict, and counting it as ``recorded`` would\noverstate how many attestations were stored. The branch is chosen on\n``record``'s ``inserted`` -- did *this* write create the row -- and\nevery non-insert takes the same path: read the winner back\ndeployment-scoped, then classify with ``is_identical_resubmission``.\n\n**``record``'s own ``authoritative`` is deliberately not consulted\nhere.** It is computed from the stored envelope *columns*, which are no\nevidence that the stored ``payload_json`` derives from them, nor that\nthe row's flat ``deployment_ref`` matches the deployment named inside\nits signed payload. Short-circuiting on it -- as an earlier revision\ndid -- let an internally inconsistent row answer 201 for claims it does\nnot carry, and skipped the scoped read that keeps a sibling\ndeployment's evidence unreadable. Re-signing the stored payload\nrecomputes its digest *from that payload*, so an inconsistent row fails\nthe comparison rather than passing it, and the scoped read is now on\nevery non-insert path rather than only on the slow one.\n\n**What that costs: a 503 window this path did not previously have.**\nThe read happens *after* ``record`` has returned, and only on the\nbranch where this submission did **not** insert -- so a storage fault\nbetween the two turns what would have been a 201 for an exact-envelope\nduplicate into a fail-closed 503. Nothing is lost by that: this request\nwrote nothing (it lost the insert), and the row it would have been\nanswered about is the winner's, already durably in place. A retry reads\nthat winner back and answers 201 as before. This is the intended\ndirection -- a row that cannot be read is no evidence, so it must not\nbe certified -- but it is a real behaviour change for a case that used\nto answer without reading, and it is stated here rather than left for\nsomeone to discover from a metric.\n\n**The retry answer is byte-identical to the first one** (201,\n``authoritative: true``, the stored digest and the stored expiry): a\nclient that cannot tell a retry from the original is what idempotency\nmeans, and the window reported is the one actually in force rather than\na fresh one the run does not have. Only the metric separates them, as\n``already_recorded`` -- nothing on the wire is false, and an operator\nstill gets to see retry volume instead of it inflating ``recorded``.", "operationId": "attest_run_start_v1_enforcement_attestations_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttestationSubmission" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AttestationAck" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Attest Run Start", "tags": [ "v1" ] } }, "/v1/enforcement/decisions": { "post": { "description": "Return the verdict for one tool call, recorded once per key.\n\nThe idempotency key answers a repeat with the stored decision. It does\nnot serialize concurrent first requests: two racing calls under one new\nkey may both be evaluated, and exactly one of their decisions is\nstored and returned to both.", "operationId": "decide_tool_call_v1_enforcement_decisions_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionSubmission" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Decide Tool Call", "tags": [ "v1" ] } }, "/v1/enforcement/deployments/{deployment_ref}/runs/{correlation_id}": { "get": { "description": "Report the level the server can prove for one attested run.\n\nThe correlation is attacker-suppliable, so the provider is bound to the\ncaller's tenant and to the resolved deployment: a correlation stored\nunder another tenant reads as absent, never as that tenant's evidence.", "operationId": "read_run_status_v1_enforcement_deployments__deployment_ref__runs__correlation_id__get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } }, { "in": "path", "name": "correlation_id", "required": true, "schema": { "title": "Correlation Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunEnforcementStatus" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Read Run Status", "tags": [ "v1" ] } }, "/v1/enforcement/deployments/{deployment_ref}/status": { "get": { "description": "Report a deployment's last-known level from its newest heartbeat.\n\nThe level is run through :class:`CapabilityReporter` rather than read\noff the heartbeat, so the staleness window and the graph-version match\nare applied by the same code that governs the gateway. A heartbeat can\nnever reach ``ENFORCED``: it proves no tool inventory.", "operationId": "read_deployment_status_v1_enforcement_deployments__deployment_ref__status_get", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeploymentEnforcementStatus" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Read Deployment Status", "tags": [ "v1" ] } }, "/v1/enforcement/heartbeats": { "post": { "description": "Append one liveness ping for a deployment.", "operationId": "report_heartbeat_v1_enforcement_heartbeats_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HeartbeatSubmission" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HeartbeatAck" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Report Heartbeat", "tags": [ "v1" ] } }, "/v1/enforcement/registrations": { "post": { "description": "Record the tool inventory an adapter declares for one deployment.", "operationId": "register_tool_inventory_v1_enforcement_registrations_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InventorySubmission" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InventoryAck" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Register Tool Inventory", "tags": [ "v1" ] } }, "/v1/guardrails": { "get": { "operationId": "get_tenant_guardrails_v1_guardrails_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuardrailPolicyResponse" } } }, "description": "Successful Response" } }, "summary": "Get Tenant Guardrails", "tags": [ "v1" ] }, "put": { "operationId": "put_tenant_guardrails_v1_guardrails_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuardrailPolicyPatch" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GuardrailPolicyResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Put Tenant Guardrails", "tags": [ "v1" ] } }, "/v1/guardrails/history": { "get": { "operationId": "get_guardrail_history_v1_guardrails_history_get", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/GuardrailPolicyRevision" }, "title": "Response Get Guardrail History V1 Guardrails History Get", "type": "array" } } }, "description": "Successful Response" } }, "summary": "Get Guardrail History", "tags": [ "v1" ] } }, "/v1/identity": { "get": { "operationId": "get_identity_v1_identity_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IdentityResponse" } } }, "description": "Successful Response" } }, "summary": "Get Identity", "tags": [ "v1" ] } }, "/v1/langgraph/deployments/{deployment_ref}/attestations": { "post": { "operationId": "attest_v1_langgraph_deployments__deployment_ref__attestations_post", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunAttestationV1" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCapabilityEvidence" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Attest", "tags": [ "v1" ] } }, "/v1/langgraph/deployments/{deployment_ref}/decisions": { "post": { "operationId": "decide_v1_langgraph_deployments__deployment_ref__decisions_post", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionRequestV1" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DecisionResponseV1" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Decide", "tags": [ "v1" ] } }, "/v1/langgraph/deployments/{deployment_ref}/heartbeat": { "post": { "operationId": "heartbeat_v1_langgraph_deployments__deployment_ref__heartbeat_post", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HeartbeatV1" } } }, "required": true }, "responses": { "204": { "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Heartbeat", "tags": [ "v1" ] } }, "/v1/langgraph/deployments/{deployment_ref}/inventories": { "post": { "operationId": "register_inventory_v1_langgraph_deployments__deployment_ref__inventories_post", "parameters": [ { "in": "path", "name": "deployment_ref", "required": true, "schema": { "title": "Deployment Ref", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InventoryRegistrationV1" } } }, "required": true }, "responses": { "204": { "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Register Inventory", "tags": [ "v1" ] } }, "/v1/manifests": { "get": { "description": "All executable units and agent runners registered for this deployment.\n\nThese are the values an executable_unit node's ``manifest_ref`` can\nreference, plus the runner names agent nodes bind to at run time.", "operationId": "list_manifests_v1_manifests_get", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ManifestSummaryResponse" }, "title": "Response List Manifests V1 Manifests Get", "type": "array" } } }, "description": "Successful Response" } }, "summary": "List Manifests", "tags": [ "v1" ] } }, "/v1/manifests/{manifest_ref}": { "get": { "description": "Return a safe manifest projection; commands, source and environment stay hidden.", "operationId": "get_manifest_v1_manifests__manifest_ref__get", "parameters": [ { "in": "path", "name": "manifest_ref", "required": true, "schema": { "title": "Manifest Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManifestDetailResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Manifest", "tags": [ "v1" ] } }, "/v1/manifests/{manifest_ref}/runs": { "get": { "description": "Recent run/node identities linked to a manifest through scoped audit evidence.", "operationId": "list_manifest_runs_v1_manifests__manifest_ref__runs_get", "parameters": [ { "in": "path", "name": "manifest_ref", "required": true, "schema": { "title": "Manifest Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ManifestRunListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Manifest Runs", "tags": [ "v1" ] } }, "/v1/mcp/servers": { "get": { "description": "Every MCP server registered for this deployment, by ref.", "operationId": "list_mcp_servers_v1_mcp_servers_get", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/MCPServerResponse" }, "title": "Response List Mcp Servers V1 Mcp Servers Get", "type": "array" } } }, "description": "Successful Response" } }, "summary": "List Mcp Servers", "tags": [ "v1" ] }, "post": { "description": "Register a server. Does not spawn it -- use the discover route for that.", "operationId": "create_mcp_server_v1_mcp_servers_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPServerCreateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPServerResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Mcp Server", "tags": [ "v1" ] } }, "/v1/mcp/servers/{ref}": { "delete": { "description": "Deregister a server.", "operationId": "delete_mcp_server_v1_mcp_servers__ref__delete", "parameters": [ { "in": "path", "name": "ref", "required": true, "schema": { "title": "Ref", "type": "string" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Delete Mcp Server", "tags": [ "v1" ] }, "put": { "description": "Reconfigure a registered server.\n\nNarrowing ``grants`` here can strand an already-published graph whose\nnode was validated against the wider ceiling. That is deliberate:\n``MCPSessionPool`` re-reads this row before it will hand out a session,\nso the graph fails closed rather than keeping a capability the operator\nhas since withdrawn. Published versions are immutable, so the\npublish-time check alone could not achieve that.", "operationId": "update_mcp_server_v1_mcp_servers__ref__put", "parameters": [ { "in": "path", "name": "ref", "required": true, "schema": { "title": "Ref", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPServerUpdateRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPServerResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Update Mcp Server", "tags": [ "v1" ] } }, "/v1/mcp/servers/{ref}/tools": { "get": { "description": "Spawn the server, list its tools with the digests an import would pin, stop.\n\nThis is the only route that runs the operator's command, and it is\nwhy the route set is admin-tier. The returned ``schema_hash`` values\nare what ``mcp-import`` freezes into the graph and what the runtime\ndrift check later compares against.", "operationId": "discover_mcp_tools_v1_mcp_servers__ref__tools_get", "parameters": [ { "in": "path", "name": "ref", "required": true, "schema": { "title": "Ref", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MCPDiscoverResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Discover Mcp Tools", "tags": [ "v1" ] } }, "/v1/metrics": { "get": { "operationId": "get_metrics_v1_metrics_get", "responses": { "200": { "content": { "application/json": { "schema": { "title": "Response Get Metrics V1 Metrics Get" } } }, "description": "Successful Response" } }, "summary": "Get Metrics", "tags": [ "v1" ] } }, "/v1/retention/erasure-history": { "get": { "description": "Return recent append-only Retention activity for the caller's tenant.", "operationId": "list_erasure_history_v1_retention_erasure_history_get", "parameters": [ { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 200, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ErasureHistoryEntry" }, "title": "Response List Erasure History V1 Retention Erasure History Get", "type": "array" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Erasure History", "tags": [ "v1" ] } }, "/v1/retention/erasure-requests": { "post": { "description": "Erase one run or every non-held run of the caller's tenant (409 on hold).", "operationId": "request_erasure_v1_retention_erasure_requests_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErasureRequestBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErasureResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Request Erasure", "tags": [ "v1" ] } }, "/v1/retention/legal-holds": { "get": { "description": "List active legal holds for the caller's tenant.", "operationId": "list_legal_holds_v1_retention_legal_holds_get", "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/LegalHoldResponse" }, "title": "Response List Legal Holds V1 Retention Legal Holds Get", "type": "array" } } }, "description": "Successful Response" } }, "summary": "List Legal Holds", "tags": [ "v1" ] }, "post": { "description": "Place a run-scoped or tenant-wide legal hold for the caller's tenant.", "operationId": "place_legal_hold_v1_retention_legal_holds_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalHoldBody" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalHoldResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Place Legal Hold", "tags": [ "v1" ] } }, "/v1/retention/legal-holds/{hold_id}": { "delete": { "description": "Release a legal hold owned by the caller's tenant (404 otherwise).", "operationId": "release_legal_hold_v1_retention_legal_holds__hold_id__delete", "parameters": [ { "in": "path", "name": "hold_id", "required": true, "schema": { "title": "Hold Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LegalHoldResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Release Legal Hold", "tags": [ "v1" ] } }, "/v1/retention/policy": { "get": { "description": "Return the caller tenant's resolved retention policy (admin-tier).", "operationId": "get_retention_policy_v1_retention_policy_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetentionPolicyResponse" } } }, "description": "Successful Response" } }, "summary": "Get Retention Policy", "tags": [ "v1" ] }, "put": { "description": "Create or replace the caller tenant's retention policy (admin-tier).", "operationId": "put_retention_policy_v1_retention_policy_put", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetentionPolicyBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetentionPolicyResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Put Retention Policy", "tags": [ "v1" ] } }, "/v1/runs": { "post": { "description": "Validate, guard-check, and queue a new run; requires ``Permission.RUN_CREATE``.", "operationId": "create_run_v1_runs_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunInvocationRequest" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunInvocationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Run", "tags": [ "v1" ] } }, "/v1/runs/{run_id}": { "get": { "description": "Return the public status of a run; requires ``Permission.RUN_READ``.", "operationId": "get_run_v1_runs__run_id__get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunStatusResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Run", "tags": [ "v1" ] } }, "/v1/runs/{run_id}/audit-verification": { "get": { "description": "Verify the digest chain + signatures over a run's audit records.", "operationId": "verify_run_audit_chain_v1_runs__run_id__audit_verification_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditVerificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Verify Run Audit Chain", "tags": [ "v1" ] } }, "/v1/runs/{run_id}/children": { "get": { "description": "Return payload-free direct-child linkage within the caller's scope.", "operationId": "list_child_runs_v1_runs__run_id__children_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "items": { "$ref": "#/components/schemas/ChildRunSummaryResponse" }, "title": "Response List Child Runs V1 Runs Run Id Children Get", "type": "array" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Child Runs", "tags": [ "v1" ] } }, "/v1/runs/{run_id}/evidence": { "get": { "description": "Return the evidence bundle for a run; requires ``Permission.AUDIT_READ``.", "operationId": "get_run_evidence_v1_runs__run_id__evidence_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunEvidenceResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Run Evidence", "tags": [ "v1" ] } }, "/v1/runs/{run_id}/timeline": { "get": { "description": "Return the ordered audit timeline for a run; requires ``Permission.AUDIT_READ``.", "operationId": "get_run_timeline_v1_runs__run_id__timeline_get", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditTimelineResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Run Timeline", "tags": [ "v1" ] } }, "/v1/runs/{run_id}/verify-chain": { "post": { "description": "POST alias of the run audit-verification with an optional head pin.", "operationId": "post_verify_run_chain_v1_runs__run_id__verify_chain_post", "parameters": [ { "in": "path", "name": "run_id", "required": true, "schema": { "title": "Run Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "anyOf": [ { "$ref": "#/components/schemas/VerifyChainRequest" }, { "type": "null" } ], "title": "Body" } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AuditVerificationResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Post Verify Run Chain", "tags": [ "v1" ] } }, "/v1/templates": { "get": { "operationId": "list_templates_v1_templates_get", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateListResponse" } } }, "description": "Successful Response" } }, "summary": "List Templates", "tags": [ "v1" ] }, "post": { "operationId": "create_template_v1_templates_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateTemplateRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Template", "tags": [ "v1" ] } }, "/v1/templates/{name}": { "get": { "operationId": "get_template_v1_templates__name__get", "parameters": [ { "in": "path", "name": "name", "required": true, "schema": { "title": "Name", "type": "string" } }, { "in": "query", "name": "version", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Version" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TemplateResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Template", "tags": [ "v1" ] } }, "/v1/templates/{name}/{version}": { "delete": { "operationId": "delete_template_v1_templates__name___version__delete", "parameters": [ { "in": "path", "name": "name", "required": true, "schema": { "title": "Name", "type": "string" } }, { "in": "path", "name": "version", "required": true, "schema": { "title": "Version", "type": "integer" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Delete Template", "tags": [ "v1" ] } }, "/v1/tenants/{tenant_id}/budget": { "put": { "description": "Set the tenant spend cap enforced before LLM calls and fan-out.", "operationId": "set_tenant_budget_v1_tenants__tenant_id__budget_put", "parameters": [ { "in": "path", "name": "tenant_id", "required": true, "schema": { "title": "Tenant Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TenantBudgetRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TenantCostResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Set Tenant Budget", "tags": [ "v1" ] } }, "/v1/tenants/{tenant_id}/cost": { "get": { "description": "Return month-to-date spend and cap for a tenant (per D-14, D-16).", "operationId": "get_tenant_cost_v1_tenants__tenant_id__cost_get", "parameters": [ { "in": "path", "name": "tenant_id", "required": true, "schema": { "title": "Tenant Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TenantCostResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Tenant Cost", "tags": [ "v1" ] } }, "/v1/webhooks/dead-letters": { "get": { "operationId": "list_dead_letters_v1_webhooks_dead_letters_get", "parameters": [ { "in": "query", "name": "subscription_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Subscription Id" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookDeadLetterListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Dead Letters", "tags": [ "v1" ] } }, "/v1/webhooks/dead-letters/{dead_letter_id}/replay": { "post": { "operationId": "replay_dead_letter_v1_webhooks_dead_letters__dead_letter_id__replay_post", "parameters": [ { "in": "path", "name": "dead_letter_id", "required": true, "schema": { "title": "Dead Letter Id", "type": "string" } } ], "responses": { "201": { "content": { "application/json": { "schema": { "additionalProperties": true, "title": "Response Replay Dead Letter V1 Webhooks Dead Letters Dead Letter Id Replay Post", "type": "object" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Replay Dead Letter", "tags": [ "v1" ] } }, "/v1/webhooks/deliveries": { "get": { "operationId": "list_deliveries_v1_webhooks_deliveries_get", "parameters": [ { "in": "query", "name": "subscription_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Subscription Id" } }, { "in": "query", "name": "limit", "required": false, "schema": { "default": 50, "maximum": 1000, "minimum": 1, "title": "Limit", "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookDeliveryListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Deliveries", "tags": [ "v1" ] } }, "/v1/webhooks/subscriptions": { "get": { "operationId": "list_subscriptions_v1_webhooks_subscriptions_get", "parameters": [ { "in": "query", "name": "deployment_ref", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Deployment Ref" } }, { "in": "query", "name": "tenant_id", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tenant Id" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookSubscriptionListResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Subscriptions", "tags": [ "v1" ] }, "post": { "operationId": "create_subscription_v1_webhooks_subscriptions_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateSubscriptionRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookSubscriptionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Subscription", "tags": [ "v1" ] } }, "/v1/webhooks/subscriptions/{subscription_id}": { "delete": { "operationId": "deactivate_subscription_v1_webhooks_subscriptions__subscription_id__delete", "parameters": [ { "in": "path", "name": "subscription_id", "required": true, "schema": { "title": "Subscription Id", "type": "string" } } ], "responses": { "204": { "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Deactivate Subscription", "tags": [ "v1" ] }, "get": { "operationId": "get_subscription_v1_webhooks_subscriptions__subscription_id__get", "parameters": [ { "in": "path", "name": "subscription_id", "required": true, "schema": { "title": "Subscription Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookSubscriptionResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Get Subscription", "tags": [ "v1" ] } } } }