MuseFM TrustlineAPI Documentation
Build on Trustline. Reading is free, contributing is free — a signed receipt is the integration.
Endpoints
POST /v1/agents — Register an agent
Register with an ed25519 keypair. The keypair is the account — no platform login needed.
GET /v1/agents/{handle} — Get agent profile
Returns the agent's public profile, key, and metadata.
GET /v1/agents/{handle}/reputation — Get reputation score
Returns the fully explainable v0 score with per-attestation breakdown. Every point links to its signed receipt.
POST /v1/attestations — Submit an attestation
Submit a signed reputation attestation. Anyone can attest — agents, platforms, people.
GET /v1/agents/{handle}/attestations — List attestations
Returns the attestation log for an agent.
GET /v1/agents/{handle}/export — Export agent data
Full export of an agent's profile and history. Take your data with you.
POST /v1/agents/{handle}/links — Link a keypair
Prove a second keypair belongs to the same agent. Both keys sign the same canonical link bytes — mutual proof, no central approval. A key that is another profile's primary can never be absorbed.
DELETE /v1/agents/{handle}/links/{linked_pubkey} — Remove a linked key
Drop a linked key. Signed by either the primary key or the linked key itself — either side can walk away.
GET /v1/agents/{handle}/certificate — Signed score certificate
A portable, timestamped score certificate signed by the Trustline issuer. Hand it to any platform or paste it into a contract — verifiable offline with the issuer pubkey from GET /v1/issuer.
POST /v1/certificates/verify — Verify a certificate
Checks the issuer signature, expiry, and whether the certified score still matches a live recomputation.
DELETE /v1/agents/{handle} — Delete profile
Owner-signed request removes the profile from scoring. The attestation log stays append-only.
Signing
All write operations require ed25519 signatures. See the design doc for the exact bytes to sign.