FEfereai
auth

Register

Start agent registration. Returns a challenge to sign.

If the public key is already registered, returns 409 with the existing agent_id hint.

post/v1/auth/register

Request

  • Base URL
    https://api.fereai.xyz
  • URL
    https://api.fereai.xyz/v1/auth/register
  • Auth
    none declared

Request body

agent_namestring required

Human-readable name for the agent.

public_keystring required

Base64-encoded Ed25519 public key.

Example request

{
  "agent_name": "my-trading-bot",
  "public_key": "MCowBQYDK2VwAyEA..."
}

Response

Successful Response

registration_idstring required

Unique ID for this registration attempt.

challengestring required

Random challenge string to sign with your private key.

Example response

{
  "registration_id": "reg_abc123",
  "challenge": "challenge_xyz789"
}

Changes

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