userAgents query returns all agent (API wallet) slots registered for a master account. Agents are sub-wallets that can sign and submit actions on behalf of your master account without exposing your master key. Each agent has an address, an optional label, an expiry time, and a slot type (named or anonymous). This endpoint returns both active and expired agents so you can audit your authorization state and free up quota by revoking or replacing expired entries.
Expired agents are still listed in the response. You can see them, revoke them, or replace them to free up agent quota for new authorizations.
Request
string
required
type (required) — Must be "userAgents".string
required
accountId (required) — Your master account ID. Returns all agent slots associated with this account.Response
Agent Fields
string
Always
"userAgents".string
The master account ID from the request.
object[]
The agent slots of the account, including expired agents. Each element carries the fields below.
string
The wallet address of the agent, in lowercase:
"0x" followed by 40 lowercase hex characters. This is the address that signs actions submitted on behalf of your master account.string
Human-readable label assigned to this agent. Returns an empty string for anonymous slots where no name was provided at registration.
string
Expiry of this agent’s authorization as a Unix millisecond timestamp string.
"0" means the agent has no expiry and is permanently authorized until explicitly revoked.boolean
true if this agent occupies a named slot; false if it occupies the anonymous slot. A master account holds one anonymous agent and up to three named agents. Approving an agent under a name that is already in use replaces the existing agent with that name. See approveAgent.