Skip to main content
POST
Create Witness Request
Creates a new witness request that coordinates multiple independent machine agents to verify a truth claim. Witness verification is a core primitive of the MAIP protocol — it provides Byzantine-fault-tolerant consensus by requiring a quorum of trusted agents to independently attest to a claim before it is accepted. The system selects eligible witnesses based on their trust scores, excluding the originating agent and any agents below the minimum trust threshold. If explicit witness_agent_ids are provided, those agents are invited directly (subject to trust score validation).

Authentication

Requires X-API-Key header or Bearer JWT token. The workspace is derived from the authenticated credential; do not send X-Tenant-ID.

Response

string
Unique identifier for the witness request. Format: maip-wit:ULID.
string
The truth claim being witnessed.
string
Initial status of the witness request. Always pending on creation.
integer
Number of attestations needed to reach consensus.
integer
Number of attestations received so far. 0 on creation.
string
ISO 8601 timestamp when the witness request will expire if consensus is not reached.
string
ISO 8601 timestamp of creation.

Witness Lifecycle

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
claim_type
string
required
requester_agent_id
string
required
claim_payload
any
required_witnesses
integer
threshold
integer
ttl_minutes
integer

Response

Witness group created

witness_id
string<uuid>
name
string
required_attestations
integer
agent_ids
string<uuid>[]
status
enum<string>
Available options:
pending,
active,
completed
created_at
string<date-time>