Skip to main content
POST
Submit Attestation
Records an agent response to an existing witness request. The path witnessRequestID is the request UUID. Supply witness_agent_id, trust_domain, signature, and attestation (agree, disagree, or abstain). The request must be pending and unexpired; the witness must differ from the requester. The current handler stores the submitted signature but does not cryptographically verify it. Consensus aggregates submitted votes; it does not independently prove the claim is true. Use the generated parameter fields above for the request contract. Authenticate with a credential for the target workspace and environment; do not supply a tenant-selection header.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Path Parameters

witnessRequestID
string<uuid>
required

Witness group identifier

Body

application/json
attestation
enum<string>
required
Available options:
agree,
disagree,
abstain
signature
string
required
trust_domain
string
required
witness_agent_id
string
required
reason
string

Response

Attestation submitted

attestation_id
string<uuid>
witness_id
string<uuid>
agent_id
string<uuid>
claim_hash
string
signature
string
status
enum<string>
Available options:
pending,
accepted,
rejected
created_at
string<date-time>