Create Truth Claim
Truth Claims & Documents
Create Truth Claim
Submit a new truth claim from a machine agent for verification
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
RequiresX-API-Key header or Bearer JWT token. Tenant-scoped via X-Tenant-ID.
Request Body
string
required
The identifier of the agent making the claim. The agent must be registered and
active within the tenant. Format:
maip-agent:ULID.string
required
Classification of the claim. Common types include: -
identity — claims
about agent or entity identity - integrity — claims about data or document
integrity - provenance — claims about data origin or chain of custody -
compliance — claims about regulatory compliance - capability — claims
about an agent’s capabilities or certificationsstring
required
The entity or resource the claim is about. This could be an agent ID, document
hash, URL, or any URI-formatted identifier.
string
required
The human-readable assertion being made. Maximum 2,000 characters. This is the
core statement that will be verified.
string[]
List of URLs pointing to supporting evidence for the claim. Each URL must be
HTTPS and accessible to the verification pipeline.
number
The claiming agent’s self-reported confidence in the assertion, as a float
between
0.0 and 1.0. This does not influence verification but is recorded
for analytics.object
Arbitrary key-value metadata to attach to the claim. Useful for correlation
IDs, source system references, or domain-specific context. Maximum 10 keys, 1
KB total.
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
API key for machine-to-machine authentication
Body
application/json

