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

# Storefront tasks

> Per-operation reference for the buyer storefronts API

Each page below documents a single storefront operation — request, parameters, response shape, and errors. Browse storefronts, inspect connection and capability state, then register credentials per source so discovery and media buys flow. For the conceptual model — sources, connection state, and OAuth — see the [Storefront object guide](/v2/object-guides/storefront).

## Browse

<CardGroup cols={2}>
  <Card title="List storefronts" href="/v2/buyer/storefronts/tasks/list-storefronts" icon="list">
    `GET /storefronts` — paginated summaries
  </Card>

  <Card title="Get storefront" href="/v2/buyer/storefronts/tasks/get-storefront" icon="magnifying-glass">
    `GET /storefronts/:storefrontId` — rolled-up connection state
  </Card>

  <Card title="Get storefront capabilities" href="/v2/buyer/storefronts/tasks/get-storefront-capabilities" icon="signal">
    `GET /storefronts/:storefrontId/capabilities` — source diagnostics
  </Card>
</CardGroup>

## Selection

<CardGroup cols={2}>
  <Card title="Update selection override" href="/v2/buyer/storefronts/tasks/update-selection-override" icon="toggle-on">
    `PUT /storefronts/:storefrontId/selection-override` — set Default, Always
    include, or Always exclude
  </Card>

  <Card title="Update advertiser Seller preference" href="/v2/buyer/storefronts/tasks/update-advertiser-activation-preference" icon="sliders">
    Set Inherit, On, or Off for one advertiser without changing account
    selection
  </Card>
</CardGroup>

## Billing

<CardGroup cols={2}>
  <Card title="Update billing policy" href="/v2/buyer/storefronts/tasks/update-billing-policy" icon="file-invoice-dollar">
    `PUT /storefronts/:storefrontId/billing-policy` — choose unlocked
    consolidated or direct billing
  </Card>

  <Card title="Approve direct billing" href="/v2/buyer/storefronts/tasks/accept-direct-billing" icon="file-signature">
    `POST /storefronts/:storefrontId/direct-billing-acceptance` — approve direct
    billing account-wide
  </Card>
</CardGroup>

## Reporting

<CardGroup cols={2}>
  <Card title="Set Enhanced Reporting" href="/v2/buyer/storefronts/tasks/set-enhanced-reporting" icon="chart-line">
    Enable or disable reporting and history for one exact connected account
  </Card>
</CardGroup>

## Credentials

<CardGroup cols={2}>
  <Card title="List credentials" href="/v2/buyer/storefronts/tasks/list-credentials" icon="key">
    `GET /storefronts/credentials` — all your registered credentials
  </Card>

  <Card title="Register source credentials" href="/v2/buyer/storefronts/tasks/register-source-credentials" icon="user-lock">
    `POST /storefronts/:storefrontId/sources/:sourceId/credentials` — connect a
    source
  </Card>

  <Card title="Refresh provider accounts" href="/v2/buyer/storefronts/tasks/refresh-provider-accounts" icon="arrows-rotate">
    `POST /storefront-connections/:connectionId/accounts/refresh` — rediscover
    accounts with the saved credential
  </Card>

  <Card title="Connect an AdCP source (alpha)" href="/v2/buyer/storefronts/tasks/connect-adcp-storefront" icon="link">
    Project a mapped source account into tracked campaigns
  </Card>
</CardGroup>

## Presences (alpha)

<CardGroup cols={2}>
  <Card title="List account presences" href="/v2/buyer/storefronts/tasks/list-account-presences" icon="satellite-dish">
    `GET /storefront-connections/:connectionId/accounts/:accountId/presences` —
    tracked and pushed audiences/event sources
  </Card>
</CardGroup>