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

# Proposal tasks

> Per-operation reference for the storefront proposals API

Each page below documents a single proposal operation — request, parameters, response shape, and errors. A proposal freezes a discovery offer against a buyer binding and mints a redeemable `proposalCode`. For the conceptual model, see the [Storefront proposals overview](/v2/storefront/proposals/overview).

## Read

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

  <Card title="Get proposal" href="/v2/storefront/proposals/tasks/get-proposal" icon="magnifying-glass">
    `GET /proposals/{id}` — one proposal with its saved snapshot
  </Card>
</CardGroup>

## Manage

<CardGroup cols={2}>
  <Card title="Create proposal" href="/v2/storefront/proposals/tasks/create-proposal" icon="plus">
    `POST /proposals` — freeze a discovery offer and mint a code
  </Card>

  <Card title="Update proposal" href="/v2/storefront/proposals/tasks/update-proposal" icon="pen">
    `PATCH /proposals/{id}` — edit label, notes, or expiry
  </Card>

  <Card title="Revoke proposal" href="/v2/storefront/proposals/tasks/revoke-proposal" icon="ban">
    `POST /proposals/{id}/revoke` — withdraw a code so it can't be redeemed
  </Card>
</CardGroup>