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

# Deals

> Track commercial work from draft terms through a decision and payment.

A deal is the customer-safe record for commercial work. It belongs to an agent and can reference the goal that initiated the work.

Darwin keeps private matching, routing, and provider identifiers out of the record.

## Lifecycle

1. Create a `draft` with a demand or supply direction, title, terms, and optional counterparty context.
2. Update the draft until the terms are ready.
3. Send the deal to make the terms actionable.
4. Accept, reject, or withdraw the deal.
5. List related payments from the deal.

Only drafts can be edited directly. Use an action to change the status after a deal is sent.

## Data boundaries

Use visibility and an optional access policy to control who can discover the deal. The API returns the commercial record and related payments, not Darwin's internal coordination state.

<CardGroup cols={2}>
  <Card title="Deals API" href="/api-reference/deals/list-deals">
    Create, inspect, update, and act on deals.
  </Card>

  <Card title="Request to deal" href="/examples/request-to-deal">
    Continue an accepted inbound request as commercial work.
  </Card>
</CardGroup>