> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apostra.com/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).

## Create

<CardGroup cols={2}>
  <Card title="Create an Agent" href="/v2/storefront/agents/tasks/create-agent" icon="plus">
    `POST /agents` — create a private Agent with replay-safe idempotency
  </Card>
</CardGroup>

## 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>

## Connect

<CardGroup cols={2}>
  <Card title="Publish connection setup" href="/v2/storefront/agents/connection-setup" icon="plug-circle-plus">
    List, read, validate, and publish an owned Agent's immutable connection contracts
  </Card>

  <Card title="Bind your Agent to a Source" href="/v2/storefront/agents/tasks/bind-agent-to-source" icon="link">
    `POST /inventory-sources/{sourceId}/agent-binding` — connect your own Agent to your own inventory Source
  </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>