Skip to main content
POST
Create Truth Claim
Creates a new truth claim — a formal assertion made by a machine agent about a subject. Truth claims are the foundational data objects in the MAIP verification pipeline. Once created, a claim can be routed through witness verification, AI analysis, or human review before receiving a final determination. Claims are immutable once created. The status field tracks the claim through its lifecycle from pending to a terminal state (verified, disputed, or rejected). A receipt is automatically minted when the claim reaches a terminal state.

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 truth claim. Format: maip-tc:ULID.
string
The agent that created the claim.
string
The classification of the claim.
string
The entity or resource the claim is about.
string
The assertion being made.
string
Initial status. Always pending on creation.
string
ISO 8601 timestamp of creation.

Claim Lifecycle

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
agent_id
string<uuid>
required

Claiming agent

claim_type
string
required

Classification of the claim (e.g. data_integrity, model_accuracy)

claim_value
string
required
confidence
number
evidence_refs
string[]
metadata
any
methodology
string

Response

Truth claim created

claim_id
string<uuid>
agent_id
string<uuid>
claim_type
string
payload
object
evidence
object[]
status
enum<string>
Available options:
pending,
verified,
rejected,
expired
receipt_id
string<uuid>
attestations
object[]
verified_at
string<date-time>
created_at
string<date-time>