Reputation

Register Agent Endpoint

Register a new agent on the ERC-8004 Identity Registry (gasless).

The Ultravioleta Facilitator pays all gas fees. The caller does not need ETH or any native token on the target chain.

Supported networks: ethereum, base, polygon, arbitrum, celo, bsc, monad, avalanche, and their testnets.

If recipient is specified, the minted ERC-721 NFT is automatically transferred to that address after registration.

Hybrid sync/async: the facilitator mint is synchronous (p95 ~28s). This endpoint waits up to ~20s (EM_REGISTER_SYNC_BUDGET_S); if the facilitator confirms in time, the usual 200 is returned. Otherwise it answers 202 Accepted with a registration_id and a poll URL — the mint keeps running facilitator-side and GET /api/v1/reputation/register/{registration_id} resolves the outcome from the chain itself. NEVER blind-retry the POST: a duplicate register call mints a duplicate identity.

post/api/v1/reputation/register

Request

  • Base URL: https://api.execution.market
  • URL: https://api.execution.market/api/v1/reputation/register
  • Auth: API key in header Signature-Input

Headers

authorizationstring nullable

Bearer <supabase_jwt>

Request body

networkstring

ERC-8004 network for registration

agent_uristring required

URI to agent registration file (IPFS or HTTPS)

recipientstring nullable

Optional address to receive the NFT after minting

Response

Agent registered successfully

successboolean required
agent_idinteger nullable

Newly assigned ERC-8004 agent ID

transactionstring nullable

Registration tx hash

transfer_transactionstring nullable

NFT transfer tx hash (if recipient specified)

ownerstring nullable
networkstring required
errorstring nullable
messagestring nullable

Human-readable note (e.g. identity already existed, no mint)

Changes

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