> ## Documentation Index
> Fetch the complete documentation index at: https://docs.interchange.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent tasks

> Per-operation reference for the storefront agents API

Each page below documents a single agent operation — request, parameters, response shape, and errors. Read endpoints list and inspect the agents registered to your storefront; the OAuth endpoints start the consent flows for agents that need them. For the conceptual model, see the [Storefront agents overview](/v2/storefront/agents/overview).

## Read

<CardGroup cols={2}>
  <Card title="List agents" href="/v2/storefront/agents/tasks/list-agents" icon="list">
    `GET /agents` — registered agents, filterable by type, status, and relationship
  </Card>

  <Card title="Get agent" href="/v2/storefront/agents/tasks/get-agent" icon="magnifying-glass">
    `GET /agents/{agentId}` — full agent detail with account flags
  </Card>
</CardGroup>

## Authorize

<CardGroup cols={2}>
  <Card title="Start agent OAuth" href="/v2/storefront/agents/tasks/start-agent-oauth" icon="key">
    `POST /agents/{agentId}/oauth/authorize` — agent-level token flow
  </Card>

  <Card title="Start account OAuth" href="/v2/storefront/agents/tasks/start-account-oauth" icon="user-lock">
    `POST /agents/{agentId}/accounts/oauth/authorize` — per-account token flow
  </Card>
</CardGroup>