Agent Passport

Issue an Agent Passport

Issues a hybrid-signed (ES256 + ML-DSA-65) Agent Passport that binds an agent to its controller and wallet. The passport signs identity only; the mandate is a separate, unsigned, mutable config. Persists the passport, seeds the Trust Graph, and returns a public resolvable id. Free and per-IP rate limited.

post/api/passport

Request

  • Base URL: https://flint.network
  • URL: https://flint.network/api/passport
  • Auth: none required

Request body

supersede_management_tokenstring

Optional. The management_token (raw claim token) of a specific prior UNCLAIMED passport with the same agent_id and controller_id. Presenting it authorizes superseding that prior passport at mint even with no authenticated session, since it proves possession of that prior's own claim link. Without it, and without a session whose controller_assurance is verified or command, a remint that reuses a prior's agent_id and controller_id does not supersede that prior; the prior is left alone and reported back in related_passports with a warning instead.

Response

Passport issued.

passport_idstring

kya_ prefix + ULID.

flint_agent_idstring

Trust Graph node key (faid_ prefix).

mint_srcstring

Sanitized mint source label.

ownedboolean

Top-level mirror of ownership.owned, for cheap assertions.

unclaimedboolean

Top-level mirror of ownership.unclaimed.

claim_state'claimed' | 'pending' | 'superseded' | 'none'

Top-level mirror of ownership.claim_state.

superseded_bystring nullable

Top-level mirror of ownership.superseded_by.

claim_urlstring

One-time claim link. Present only on an anonymous (unowned) mint whose claim token was stored successfully. Absent on an owned mint.

existing_claimed_passportsstring[]

passport_id values for prior CLAIMED passports with the same controller_id and agent_id that a remint left alone (never superseded automatically). Present only when at least one exists.

warningsstring[]

Response-level warnings, such as an existing_claimed_passports notice.

mandate_warningsstring[]

Copy of mandate.mandate_warnings, surfaced at the top level for convenience.

Example response

{
  "passport": {
    "envelope_version": "hybrid-v0"
  },
  "identity": {
    "record_type": "agent_passport",
    "record_version": "1.0",
    "issuer": "flint",
    "status": "stamped"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.