agents

Step 2 of agent self-registration; the signed message returns an agent account and an API key (unauthenticated)

Verifies the signed challenge (single use, unexpired, byte-for-byte the message the server wrote, signed by its address) and opens an account tagged account_kind agent, with the wallet as its verified linked wallet and payout destination. Returns an API key with the renter scope (add "host" to scopes to host), shown once. The same wallet again returns the same account (200) and a new key, only with a fresh signature. There is no free credit: fund the account (POST /api/v1/funding-intents) before renting. Refused: a replayed, expired or tampered message (401); a wallet linked to or unlinked from another account, or an account with an authenticator app (409); a suspended account's wallet (403). Rate-limited per source address and per wallet (429). Audited.

post/api/v1/agents/accounts

Request

  • Base URL: https://amplerun-api.spiry.org
  • URL: https://amplerun-api.spiry.org/api/v1/agents/accounts
  • Auth: none required

Request body

messagestring required

The challenge message

signaturestring required

0x-prefixed EIP-191 signature.

scopesstring[]

Response

The agent's account (201 new, 200 existing) and a new API key. The secret is shown only here.

account_idstring required
account_kind'agent' | 'human' required
createdboolean required
addressstring required

Lowercase wallet address.

terms_versionstring required

Example response

{
  "api_key": {
    "key_id": "3f0e2a55-8c1b-4d2e-9a6f-0b7c1d2e3f40"
  }
}

Changes

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