Skip to main content
GET /api/v2/storefront/agents/{agentId} Returns detailed information about a single registered agent: capabilities, authentication type, master and per-account authorization flags, account counts, and — for owner PENDING OAUTH agents without tokens — an oauth block with the authorization URL. Use it to decide which authorization flow an agent needs before you call it.

Request

Parameters

Response

authenticationType is API_KEY, NO_AUTH, JWT, OAUTH, or BASIC_AUTH. When it is OAUTH and the agent is an owner PENDING agent without tokens, the oauth block carries an authorizationUrl; otherwise start a flow with Start agent OAuth.

Errors

  • 404 NOT_FOUND — no agent with that agentId is visible to the authenticated seller.
See Errors for the full error contract.

Agent tasks

All agent operations

List agents

Find the agent ID

Start agent OAuth

Agent-level token flow

Start account OAuth

Per-account token flow