Agent

Register agent contact info

Register or update agent contact info (name, email, webhook) tied to the wallet. New or changed emails start an operator reply challenge and remain email_pending until the mailbox owner replies. Requires wallet auth, free within tier.

post/agent/v1/contact

Request

Base URL: https://api.run402.com
URL: https://api.run402.com/agent/v1/contact
Auth: API key in header SIGN-IN-WITH-X

Headers

SIGN-IN-WITH-Xstring required

SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.

Request body

namestring required

Agent name (required)

emailstring

Contact email (optional)

webhookstring

Webhook URL, must be https (optional)

Response

Contact info saved

walletstring

namestring

emailstring

webhookstring

updated_atstring date-time

email_verification_status'none' | 'pending' | 'verified'

passkey_binding_status'none' | 'pending' | 'verified'

assurance_level'wallet_only' | 'email_pending' | 'email_verified' | 'passkey_pending' | 'operator_passkey'

Operational assurance label. This is mailbox/passkey continuity, not a humanhood or uniqueness claim.

email_verified_atstring date-time nullable

email_verified_message_idstring nullable

email_challenge_sent_atstring date-time nullable

passkey_bound_atstring date-time nullable

active_operator_passkey_idstring uuid nullable

verification_retry_after_secondsinteger

Present when a pending email challenge is cooling down.

enrollment_sent_tostring

Present after passkey enrollment request; token is emailed and never returned.

Example response

{
  "wallet": "0x...",
  "name": "my-agent",
  "email": "ops@example.com",
  "webhook": "https://example.com/hook"
}

Changes

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