KeelsonDocs
    Judge Mode

    API reference Evidence

    Store sealed evidence

    POST/v1/evidence

    Stores what the agent saw at decision time for an active mandate of an operator this client linked or, for an app acting for a user, one that user approved for the app. The manifest is rebuilt from the items and must match, every item has its own salt, no public item may still hold an email address or phone number, and every .original must open with the evidence identity. A countersign may only bind a stored root, once.

    Headers

    Content-Typeapplication/jsonRequired
    idempotency-keystringRequired
    Idempotency-KeystringRequired
    1 to 255 characters. A retry with the same key returns the first answer.

    Request body

    application/json

    mandateIdstringRequired
    manifestobjectRequired
    Type, media type and salted leaf of every item, in order; root is the RFC 6962 tree hash of the leaves and the evidenceRoot. Content hashes and salts are only given in a disclosure.
    itemsarray of objectRequired

    Responses

    • 201Stored
    • 404No such mandate of an operator this client linked
    • 409The mandate is not active, holds the most bundles it may, or the root is stored for another mandate
    • 413The bundle is larger than 16 MiB
    • 422The items do not build the manifest, a public item holds PII, or an original does not open
    • 429Too many uploads for this mandate

    201 response

    evidenceRootstringRequired