{
  "components": {
    "schemas": {
      "CustomerReconciliation": {
        "additionalProperties": false,
        "properties": {
          "customer_id": {
            "title": "Customer Id",
            "type": "string"
          },
          "deployment": {
            "description": "The deployment's name.",
            "title": "Deployment",
            "type": "string"
          },
          "months": {
            "description": "Complete months it can reconcile, latest first.",
            "items": {
              "type": "string"
            },
            "title": "Months",
            "type": "array"
          },
          "program": {
            "title": "Program",
            "type": "string"
          },
          "reconciliations": {
            "items": {
              "$ref": "#/components/schemas/ReconciliationOut"
            },
            "title": "Reconciliations",
            "type": "array"
          },
          "status": {
            "$ref": "#/components/schemas/ReconcileStatus"
          },
          "vendor_name": {
            "title": "Vendor Name",
            "type": "string"
          }
        },
        "required": [
          "customer_id",
          "program",
          "vendor_name",
          "deployment",
          "status",
          "months",
          "reconciliations"
        ],
        "title": "CustomerReconciliation",
        "type": "object"
      },
      "DeploymentCreate": {
        "additionalProperties": false,
        "properties": {
          "job_type": {
            "default": "support-resolution",
            "title": "Job Type",
            "type": "string"
          },
          "name": {
            "description": "e.g. \"Acme Shop, support bot\"",
            "maxLength": 200,
            "minLength": 1,
            "title": "Name",
            "type": "string"
          },
          "rights_attested": {
            "description": "The vendor attests it has the right to share this customer's interaction data with Attify (the terms, Witnessed data). Required.",
            "title": "Rights Attested",
            "type": "boolean"
          },
          "source": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DeploymentSourceIn"
              },
              {
                "type": "null"
              }
            ],
            "description": "Read the interactions from the vendor's own agent platform or observability account instead of streaming them: the platform and what its connector asks for (the key, and the scope that picks out this customer's agent)."
          }
        },
        "required": [
          "name",
          "rights_attested"
        ],
        "title": "DeploymentCreate",
        "type": "object"
      },
      "DeploymentCreated": {
        "additionalProperties": false,
        "properties": {
          "deployment": {
            "$ref": "#/components/schemas/DeploymentOut"
          },
          "key": {
            "description": "pdk_<key id>_<secret>. Shown once.",
            "title": "Key",
            "type": "string"
          }
        },
        "required": [
          "deployment",
          "key"
        ],
        "title": "DeploymentCreated",
        "type": "object"
      },
      "DeploymentCustomer": {
        "additionalProperties": false,
        "properties": {
          "consented": {
            "title": "Consented",
            "type": "boolean"
          },
          "customer_id": {
            "title": "Customer Id",
            "type": "string"
          },
          "label": {
            "title": "Label",
            "type": "string"
          },
          "program": {
            "description": "Vendor and product.",
            "title": "Program",
            "type": "string"
          },
          "program_id": {
            "title": "Program Id",
            "type": "string"
          },
          "reconciliation": {
            "$ref": "#/components/schemas/ReconcileStatus"
          },
          "status": {
            "enum": [
              "invited",
              "connected",
              "disconnected"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "customer_id",
          "program_id",
          "program",
          "label",
          "status",
          "consented",
          "reconciliation"
        ],
        "title": "DeploymentCustomer",
        "type": "object"
      },
      "DeploymentList": {
        "additionalProperties": false,
        "properties": {
          "deployments": {
            "items": {
              "$ref": "#/components/schemas/DeploymentOut"
            },
            "title": "Deployments",
            "type": "array"
          }
        },
        "required": [
          "deployments"
        ],
        "title": "DeploymentList",
        "type": "object"
      },
      "DeploymentOut": {
        "additionalProperties": false,
        "properties": {
          "agent": {
            "additionalProperties": true,
            "description": "What the agent last said it runs.",
            "title": "Agent",
            "type": "object"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "customers": {
            "items": {
              "$ref": "#/components/schemas/DeploymentCustomer"
            },
            "title": "Customers",
            "type": "array"
          },
          "dashboard_url": {
            "description": "The private report of what it sent.",
            "title": "Dashboard Url",
            "type": "string"
          },
          "health": {
            "$ref": "#/components/schemas/IngestHealth"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "ingest_url": {
            "title": "Ingest Url",
            "type": "string"
          },
          "job_type": {
            "title": "Job Type",
            "type": "string"
          },
          "keys": {
            "items": {
              "$ref": "#/components/schemas/IngestKeyOut"
            },
            "title": "Keys",
            "type": "array"
          },
          "name": {
            "title": "Name",
            "type": "string"
          },
          "otlp_url": {
            "title": "Otlp Url",
            "type": "string"
          },
          "provenance": {
            "const": "witnessed",
            "title": "Provenance",
            "type": "string"
          },
          "rights": {
            "additionalProperties": true,
            "description": "The vendor's attestation that it may share this customer's data.",
            "title": "Rights",
            "type": "object"
          },
          "schema": {
            "const": "proven.deployment/1",
            "default": "proven.deployment/1",
            "title": "Schema",
            "type": "string"
          },
          "source": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DeploymentSource"
              },
              {
                "type": "null"
              }
            ],
            "description": "Set when Attify reads the deployment from the vendor's own platform account; null when the agent streams to the Ingest API."
          },
          "volumes": {
            "description": "Interactions per month, latest first.",
            "items": {
              "$ref": "#/components/schemas/MonthVolume"
            },
            "title": "Volumes",
            "type": "array"
          }
        },
        "required": [
          "id",
          "name",
          "job_type",
          "provenance",
          "created_at",
          "agent",
          "rights",
          "keys",
          "health",
          "volumes",
          "customers",
          "dashboard_url",
          "ingest_url",
          "otlp_url"
        ],
        "title": "DeploymentOut",
        "type": "object"
      },
      "DeploymentSource": {
        "additionalProperties": false,
        "description": "Where Attify reads a deployment's interactions when it pulls them from the vendor's own\nagent platform or observability account, instead of the agent streaming them.",
        "properties": {
          "account_id": {
            "title": "Account Id",
            "type": "string"
          },
          "account_name": {
            "title": "Account Name",
            "type": "string"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "every_minutes": {
            "description": "How often Attify reads the account.",
            "title": "Every Minutes",
            "type": "integer"
          },
          "keys_url": {
            "description": "Where the vendor revokes the key at the platform.",
            "title": "Keys Url",
            "type": "string"
          },
          "kind": {
            "enum": [
              "help_desk",
              "business_system",
              "agent_platform",
              "observability"
            ],
            "title": "Kind",
            "type": "string"
          },
          "platform": {
            "description": "The platform's key, e.g. \"vapi\" (GET /v1/connectors).",
            "title": "Platform",
            "type": "string"
          },
          "platform_name": {
            "title": "Platform Name",
            "type": "string"
          },
          "pulled_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The start of the last read that finished: watched up to here.",
            "title": "Pulled At"
          },
          "scope": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "What picks out this customer's agent in the account (agent ids, a project).",
            "title": "Scope",
            "type": "object"
          },
          "status": {
            "enum": [
              "pending",
              "active",
              "failed"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "platform",
          "platform_name",
          "kind",
          "account_id",
          "account_name",
          "scope",
          "status",
          "every_minutes",
          "keys_url"
        ],
        "title": "DeploymentSource",
        "type": "object"
      },
      "DeploymentSourceIn": {
        "additionalProperties": false,
        "properties": {
          "fields": {
            "additionalProperties": {
              "type": "string"
            },
            "description": "The platform's token fields: the key (\"token\") and, for an account that runs agents for several customers, the ids that pick out this one.",
            "title": "Fields",
            "type": "object"
          },
          "platform": {
            "description": "e.g. \"vapi\"; GET /v1/connectors/{job_type} lists them.",
            "title": "Platform",
            "type": "string"
          }
        },
        "required": [
          "platform",
          "fields"
        ],
        "title": "DeploymentSourceIn",
        "type": "object"
      },
      "ErrorBody": {
        "properties": {
          "code": {
            "description": "Stable, machine-readable, e.g. \"spend_cap_reached\".",
            "title": "Code",
            "type": "string"
          },
          "details": {
            "additionalProperties": true,
            "title": "Details",
            "type": "object"
          },
          "message": {
            "description": "One plain sentence for a person.",
            "title": "Message",
            "type": "string"
          },
          "status": {
            "description": "The HTTP status, repeated for clients that lose it.",
            "title": "Status",
            "type": "integer"
          }
        },
        "required": [
          "code",
          "message",
          "status"
        ],
        "title": "ErrorBody",
        "type": "object"
      },
      "ErrorResponse": {
        "properties": {
          "error": {
            "$ref": "#/components/schemas/ErrorBody"
          }
        },
        "required": [
          "error"
        ],
        "title": "ErrorResponse",
        "type": "object"
      },
      "IngestHealth": {
        "additionalProperties": false,
        "properties": {
          "breaks": {
            "description": "Ids reused with other content, or stream positions reused.",
            "title": "Breaks",
            "type": "integer"
          },
          "by_auth": {
            "additionalProperties": {
              "type": "integer"
            },
            "description": "Events by how they were authenticated.",
            "title": "By Auth",
            "type": "object"
          },
          "events": {
            "description": "Events received in the period.",
            "title": "Events",
            "type": "integer"
          },
          "gap_share": {
            "title": "Gap Share",
            "type": "number"
          },
          "interactions": {
            "description": "Interactions that started in the period.",
            "title": "Interactions",
            "type": "integer"
          },
          "last_event_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Event At"
          },
          "late_interactions": {
            "description": "Interactions with an event that arrived after the allowed delay: never scored as witnessed.",
            "title": "Late Interactions",
            "type": "integer"
          },
          "late_share": {
            "title": "Late Share",
            "type": "number"
          },
          "missing_seq": {
            "description": "Sequence numbers never received (gaps).",
            "title": "Missing Seq",
            "type": "integer"
          },
          "period_end": {
            "format": "date-time",
            "title": "Period End",
            "type": "string"
          },
          "period_start": {
            "format": "date-time",
            "title": "Period Start",
            "type": "string"
          },
          "reasons": {
            "items": {
              "type": "string"
            },
            "title": "Reasons",
            "type": "array"
          },
          "sequence_measured": {
            "description": "False when no event carried a sequence number (OpenTelemetry data).",
            "title": "Sequence Measured",
            "type": "boolean"
          },
          "signed_share": {
            "description": "Share of events whose request was HMAC-signed.",
            "title": "Signed Share",
            "type": "number"
          },
          "status": {
            "description": "degraded: too many missing sequence numbers, late interactions, or interactions the AI handled left without a claim in the scoring period; its data stops counting toward verification until it recovers.",
            "enum": [
              "healthy",
              "degraded",
              "no_data"
            ],
            "title": "Status",
            "type": "string"
          },
          "unclaimed_interactions": {
            "default": 0,
            "description": "Interactions the AI handled, old enough to be audited, that ended with no outcome.claimed either way. Only for a standard that audits every one of them with the vendor's claim (support resolution); 0 elsewhere.",
            "title": "Unclaimed Interactions",
            "type": "integer"
          },
          "unclaimed_share": {
            "default": 0.0,
            "description": "Their share of the AI-handled interactions old enough to audit.",
            "title": "Unclaimed Share",
            "type": "number"
          }
        },
        "required": [
          "status",
          "reasons",
          "period_start",
          "period_end",
          "events",
          "interactions",
          "late_interactions",
          "late_share",
          "sequence_measured",
          "missing_seq",
          "gap_share",
          "breaks",
          "signed_share",
          "by_auth",
          "last_event_at"
        ],
        "title": "IngestHealth",
        "type": "object"
      },
      "IngestKeyCreated": {
        "additionalProperties": false,
        "properties": {
          "key": {
            "description": "pdk_<key id>_<secret>. Shown once.",
            "title": "Key",
            "type": "string"
          },
          "keys": {
            "items": {
              "$ref": "#/components/schemas/IngestKeyOut"
            },
            "title": "Keys",
            "type": "array"
          }
        },
        "required": [
          "key",
          "keys"
        ],
        "title": "IngestKeyCreated",
        "type": "object"
      },
      "IngestKeyOut": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "last_used_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Used At"
          },
          "prefix": {
            "description": "pdk_<key id>: the part of the key that is not secret.",
            "title": "Prefix",
            "type": "string"
          },
          "revoked_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Revoked At"
          }
        },
        "required": [
          "id",
          "prefix",
          "created_at",
          "last_used_at",
          "revoked_at"
        ],
        "title": "IngestKeyOut",
        "type": "object"
      },
      "IngestResult": {
        "additionalProperties": false,
        "properties": {
          "accepted": {
            "title": "Accepted",
            "type": "integer"
          },
          "deployment": {
            "title": "Deployment",
            "type": "string"
          },
          "duplicates": {
            "title": "Duplicates",
            "type": "integer"
          },
          "late": {
            "title": "Late",
            "type": "integer"
          },
          "receipt": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "description": "Attify's Ed25519 signature over the body's SHA-256, when it arrived and the counts (the keys at /.well-known/proven-keys.json).",
            "title": "Receipt"
          },
          "received_at": {
            "format": "date-time",
            "title": "Received At",
            "type": "string"
          },
          "rejected": {
            "title": "Rejected",
            "type": "integer"
          },
          "results": {
            "items": {
              "$ref": "#/components/schemas/IngestResultRow"
            },
            "title": "Results",
            "type": "array"
          },
          "schema": {
            "const": "proven.ingest.result/1",
            "default": "proven.ingest.result/1",
            "title": "Schema",
            "type": "string"
          }
        },
        "required": [
          "deployment",
          "received_at",
          "accepted",
          "duplicates",
          "rejected",
          "late",
          "results",
          "receipt"
        ],
        "title": "IngestResult",
        "type": "object"
      },
      "IngestResultRow": {
        "additionalProperties": false,
        "properties": {
          "code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Code"
          },
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "late": {
            "default": false,
            "title": "Late",
            "type": "boolean"
          },
          "message": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message"
          },
          "status": {
            "enum": [
              "accepted",
              "duplicate",
              "rejected"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "id",
          "status"
        ],
        "title": "IngestResultRow",
        "type": "object"
      },
      "MonthVolume": {
        "additionalProperties": false,
        "properties": {
          "interactions": {
            "title": "Interactions",
            "type": "integer"
          },
          "month": {
            "description": "\"2026-09\"",
            "title": "Month",
            "type": "string"
          }
        },
        "required": [
          "month",
          "interactions"
        ],
        "title": "MonthVolume",
        "type": "object"
      },
      "ReconcileIn": {
        "additionalProperties": false,
        "properties": {
          "month": {
            "description": "\"2026-09\"",
            "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
            "title": "Month",
            "type": "string"
          },
          "source": {
            "enum": [
              "records",
              "invoice"
            ],
            "title": "Source",
            "type": "string"
          },
          "stated": {
            "description": "Your own total for the month.",
            "maximum": 100000000.0,
            "minimum": 0.0,
            "title": "Stated",
            "type": "integer"
          }
        },
        "required": [
          "month",
          "stated",
          "source"
        ],
        "title": "ReconcileIn",
        "type": "object"
      },
      "ReconcileStatus": {
        "additionalProperties": false,
        "properties": {
          "due": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The month the customer reconciles next.",
            "title": "Due"
          },
          "latest": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ReconciliationOut"
              },
              {
                "type": "null"
              }
            ],
            "description": "The latest reconciliation (without transcripts for the vendor)."
          },
          "reason": {
            "title": "Reason",
            "type": "string"
          },
          "status": {
            "enum": [
              "passed",
              "pending",
              "failed",
              "not_linked"
            ],
            "title": "Status",
            "type": "string"
          }
        },
        "required": [
          "status",
          "reason",
          "due",
          "latest"
        ],
        "title": "ReconcileStatus",
        "type": "object"
      },
      "ReconciliationOut": {
        "additionalProperties": false,
        "properties": {
          "checked": {
            "title": "Checked",
            "type": "integer"
          },
          "commitment": {
            "description": "SHA-256 of the secret seed the sample was drawn with.",
            "title": "Commitment",
            "type": "string"
          },
          "completed_at": {
            "anyOf": [
              {
                "format": "date-time",
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Completed At"
          },
          "created_at": {
            "format": "date-time",
            "title": "Created At",
            "type": "string"
          },
          "difference": {
            "description": "(witnessed - stated) / stated.",
            "title": "Difference",
            "type": "number"
          },
          "id": {
            "title": "Id",
            "type": "string"
          },
          "matched": {
            "title": "Matched",
            "type": "integer"
          },
          "month": {
            "title": "Month",
            "type": "string"
          },
          "sample": {
            "items": {
              "$ref": "#/components/schemas/SpotItem"
            },
            "title": "Sample",
            "type": "array"
          },
          "source": {
            "enum": [
              "records",
              "invoice"
            ],
            "title": "Source",
            "type": "string"
          },
          "spot": {
            "enum": [
              "pending",
              "passed",
              "failed"
            ],
            "title": "Spot",
            "type": "string"
          },
          "stated": {
            "description": "The customer's own total, stated before it saw Attify's.",
            "title": "Stated",
            "type": "integer"
          },
          "volume": {
            "enum": [
              "passed",
              "failed"
            ],
            "title": "Volume",
            "type": "string"
          },
          "witnessed": {
            "description": "Interactions Attify received for the month.",
            "title": "Witnessed",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "month",
          "stated",
          "source",
          "witnessed",
          "difference",
          "volume",
          "spot",
          "matched",
          "checked",
          "sample",
          "commitment",
          "created_at",
          "completed_at"
        ],
        "title": "ReconciliationOut",
        "type": "object"
      },
      "SpotAnswerIn": {
        "additionalProperties": false,
        "properties": {
          "answer": {
            "enum": [
              "matches",
              "differs",
              "not_found"
            ],
            "title": "Answer",
            "type": "string"
          },
          "interaction": {
            "maxLength": 128,
            "minLength": 1,
            "title": "Interaction",
            "type": "string"
          }
        },
        "required": [
          "interaction",
          "answer"
        ],
        "title": "SpotAnswerIn",
        "type": "object"
      },
      "SpotItem": {
        "additionalProperties": false,
        "properties": {
          "answer": {
            "anyOf": [
              {
                "enum": [
                  "matches",
                  "differs",
                  "not_found"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Answer"
          },
          "by": {
            "anyOf": [
              {
                "enum": [
                  "customer",
                  "connector"
                ],
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Who answered: the customer, or its own connected help desk.",
            "title": "By"
          },
          "claim": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "The outcome the vendor claimed.",
            "title": "Claim"
          },
          "external_ref": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Its id in the customer's own system, as the vendor sent it.",
            "title": "External Ref"
          },
          "handoff": {
            "description": "The stream records a handoff to a person or channel.",
            "title": "Handoff",
            "type": "boolean"
          },
          "interaction": {
            "title": "Interaction",
            "type": "string"
          },
          "started_at": {
            "format": "date-time",
            "title": "Started At",
            "type": "string"
          },
          "transcript": {
            "description": "The interaction as the vendor sent it, redacted; to the customer only.",
            "items": {
              "$ref": "#/components/schemas/TranscriptLine"
            },
            "title": "Transcript",
            "type": "array"
          },
          "why": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Why"
          }
        },
        "required": [
          "interaction",
          "external_ref",
          "started_at",
          "claim",
          "handoff",
          "answer",
          "by",
          "why"
        ],
        "title": "SpotItem",
        "type": "object"
      },
      "TranscriptLine": {
        "additionalProperties": false,
        "properties": {
          "at": {
            "format": "date-time",
            "title": "At",
            "type": "string"
          },
          "role": {
            "title": "Role",
            "type": "string"
          },
          "text": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Text"
          }
        },
        "required": [
          "role",
          "at",
          "text"
        ],
        "title": "TranscriptLine",
        "type": "object"
      }
    },
    "securitySchemes": {
      "ApiKey": {
        "in": "header",
        "name": "X-API-Key",
        "type": "apiKey"
      },
      "Session": {
        "bearerFormat": "JWT",
        "description": "The identity provider's session token (Clerk), for signed-in routes.",
        "scheme": "bearer",
        "type": "http"
      }
    }
  },
  "info": {
    "description": "Witnessed data: an AI agent on its own platform streams each interaction to Attify, signed with its deployment's key (docs/INGEST.md). The event schema is urn:proven:ingest-event:1.",
    "title": "Attify Ingest API (proven.ingest/1)",
    "version": "1.0.0"
  },
  "openapi": "3.1.0",
  "paths": {
    "/v1/deployments": {
      "get": {
        "operationId": "list_deployments_v1_deployments_get",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeploymentList"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "The organization's deployments, with their stream health",
        "tags": [
          "witnessed data"
        ]
      },
      "post": {
        "operationId": "create_deployment_v1_deployments_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeploymentCreate"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeploymentCreated"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Create a deployment: one agent for one customer, streaming through the Ingest API (its key is shown once)",
        "tags": [
          "witnessed data"
        ]
      }
    },
    "/v1/deployments/{deployment_id}": {
      "delete": {
        "operationId": "delete_deployment_v1_deployments__deployment_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "deployment_id",
            "required": true,
            "schema": {
              "title": "Deployment Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Delete a deployment and everything it sent; its customers stop counting",
        "tags": [
          "witnessed data"
        ]
      },
      "get": {
        "operationId": "get_deployment_v1_deployments__deployment_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "deployment_id",
            "required": true,
            "schema": {
              "title": "Deployment Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeploymentOut"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "One deployment: keys, stream health (late events, gaps, breaks), monthly volume, and each customer's consent and reconciliation",
        "tags": [
          "witnessed data"
        ]
      }
    },
    "/v1/deployments/{deployment_id}/keys": {
      "post": {
        "operationId": "new_key_v1_deployments__deployment_id__keys_post",
        "parameters": [
          {
            "in": "path",
            "name": "deployment_id",
            "required": true,
            "schema": {
              "title": "Deployment Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IngestKeyCreated"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "A new key for the deployment (shown once); the old one works until revoked",
        "tags": [
          "witnessed data"
        ]
      }
    },
    "/v1/deployments/{deployment_id}/keys/{key_id}": {
      "delete": {
        "operationId": "revoke_key_v1_deployments__deployment_id__keys__key_id__delete",
        "parameters": [
          {
            "in": "path",
            "name": "deployment_id",
            "required": true,
            "schema": {
              "title": "Deployment Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "key_id",
            "required": true,
            "schema": {
              "title": "Key Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeploymentOut"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Revoke a key: it stops working at once",
        "tags": [
          "witnessed data"
        ]
      }
    },
    "/v1/ingest/events": {
      "post": {
        "operationId": "ingest_events_v1_ingest_events_post",
        "parameters": [
          {
            "in": "header",
            "name": "Proven-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Proven-Timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Proven-Signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "properties": {
                  "events": {
                    "description": "Events (schemas/ingest-event.schema.json, urn:proven:ingest-event:1). Each is validated on its own: one refused event never loses the rest.",
                    "items": {
                      "type": "object"
                    },
                    "maxItems": 500,
                    "minItems": 1,
                    "type": "array"
                  }
                },
                "required": [
                  "events"
                ],
                "type": "object"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IngestResult"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [],
        "summary": "Send events (a batch, or one as it happens), HMAC-signed with the deployment's key",
        "tags": [
          "witnessed data"
        ]
      }
    },
    "/v1/ingest/stream": {
      "post": {
        "operationId": "ingest_stream_v1_ingest_stream_post",
        "parameters": [
          {
            "in": "header",
            "name": "Proven-Key",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Proven-Timestamp",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "header",
            "name": "Proven-Signature",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/x-ndjson": {
              "schema": {
                "type": "string"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IngestResult"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [],
        "summary": "Stream events as NDJSON in one long request; each line is stored when it arrives (handshake signed over \"<timestamp>.stream\")",
        "tags": [
          "witnessed data"
        ]
      }
    },
    "/v1/otlp/v1/traces": {
      "post": {
        "operationId": "otlp_traces_v1_otlp_v1_traces_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object"
              }
            },
            "application/x-protobuf": {
              "schema": {
                "format": "binary",
                "type": "string"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "security": [],
        "summary": "OpenTelemetry traces (OTLP/HTTP, protobuf or JSON) mapped to witnessed events: Authorization: Bearer <deployment key>",
        "tags": [
          "witnessed data"
        ]
      }
    },
    "/v1/reconciliation/{customer_id}": {
      "get": {
        "operationId": "get_reconciliation_v1_reconciliation__customer_id__get",
        "parameters": [
          {
            "in": "path",
            "name": "customer_id",
            "required": true,
            "schema": {
              "title": "Customer Id",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerReconciliation"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "A customer's reconciliation of a vendor's deployment: status, the months open, and every month's volume and spot checks",
        "tags": [
          "witnessed data"
        ]
      },
      "post": {
        "operationId": "submit_reconciliation_v1_reconciliation__customer_id__post",
        "parameters": [
          {
            "in": "path",
            "name": "customer_id",
            "required": true,
            "schema": {
              "title": "Customer Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReconcileIn"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerReconciliation"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "State a month's total from your own records (before seeing Attify's); the spot checks are drawn",
        "tags": [
          "witnessed data"
        ]
      }
    },
    "/v1/reconciliation/{customer_id}/{reconciliation_id}/answers": {
      "post": {
        "operationId": "answer_spot_check_v1_reconciliation__customer_id___reconciliation_id__answers_post",
        "parameters": [
          {
            "in": "path",
            "name": "customer_id",
            "required": true,
            "schema": {
              "title": "Customer Id",
              "type": "string"
            }
          },
          {
            "in": "path",
            "name": "reconciliation_id",
            "required": true,
            "schema": {
              "title": "Reconciliation Id",
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SpotAnswerIn"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerReconciliation"
                }
              }
            },
            "description": "Successful Response"
          },
          "400": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "bad_request"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "unauthorized"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "not_found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "conflict"
          },
          "413": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "too_large"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "invalid_request"
          },
          "429": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "rate_limited"
          },
          "503": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            },
            "description": "Error"
          }
        },
        "summary": "Answer one spot check: matches, differs, or not found in your own systems",
        "tags": [
          "witnessed data"
        ]
      }
    }
  }
}
