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
Must be
"userAgents".string
required
Your master account ID. Returns all agent slots associated with this account.
Response
Agent Fields
string
The wallet address of the agent. 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 (counts against the named agent quota). false if this agent occupies an anonymous slot (counts against the anonymous agent quota). Named and anonymous agents draw from separate quota pools.