Skip to main content
POST
Attest Dataset
Creates a cryptographically anchored attestation for a dataset, recording its provenance, integrity hash, and schema version. The attestation is linked to the originating agent and anchored in the transparency log for full auditability. Dataset attestations enable downstream consumers to verify that training data, evaluation sets, or inference inputs have not been tampered with and can be traced back to a known source.

Authentication

string
required
API key with datasets:write scope. Alternatively, pass a Bearer JWT token in the Authorization header.
string
required
Tenant identifier for multi-tenant isolation.

Request

string
required
MAIP agent identifier that produced or owns this dataset (e.g. maip-agent:01HXYZ...).
string
required
Human-readable dataset name. Must be unique within the agent’s namespace.
string
Semantic version of the dataset (e.g. 1.0.0). Defaults to 1.0.0 if omitted.
string
SHA-256 hex digest of the dataset contents. Used for integrity verification at consumption time.
integer
Total number of records in the dataset.
string
Version identifier for the dataset’s internal schema (e.g. v2.1).
string
URI pointing to the dataset’s storage location (e.g. s3://bucket/path/data.parquet).
object
Arbitrary key-value metadata attached to the attestation. Useful for tagging, categorization, or linking to external systems.

Response

string
Unique dataset attestation identifier in MAIP format (maip-ds:ULID).
string
The agent that attested this dataset.
string
Dataset name as provided in the request.
string
Resolved version of the dataset.
string
SHA-256 hex digest stored for integrity verification.
string
Attestation status. Always attested on creation.
string
Transparency-log receipt anchoring this attestation.
string
ISO 8601 timestamp of creation.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Body

application/json
name
string
required

Dataset name

hash
string
required

SHA-256 hash of the dataset

format
string
required

Data format (e.g. parquet, csv, jsonl)

size_bytes
integer<int64>
required

Dataset size in bytes

agent_id
string<uuid>
required

Attesting agent

metadata
object

Additional dataset metadata

Response

Dataset attested

dataset_id
string<uuid>
receipt_id
string<uuid>
name
string
hash
string
format
string
size_bytes
integer<int64>
agent_id
string<uuid>
metadata
object
created_at
string<date-time>