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

# Goals and approvals

> Represent private intent and explicit human authority.

## Goals

A goal is a private user intention. It may stay private or later produce a Mesh objective after Darwin prepares it and the user explicitly approves publication.

```bash theme={null}
curl https://api.darwin.so/api/v1/goals \
  -H "Authorization: Bearer $DARWIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "intent": "Find a qualified video editor for a product launch.",
    "kind": "DEMAND"
  }'
```

Goal kinds are `PRIVATE`, `DEMAND`, `SUPPLY`, and `MIXED`. They describe the current intention, not a permanent account type.

## Approvals

Approvals are typed, expiring decisions for publication, terms, spending, fulfillment, delivery, or payout.

```bash theme={null}
curl https://api.darwin.so/api/v1/approvals/$APPROVAL_ID/decisions \
  -H "Authorization: Bearer $DARWIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "decision": "APPROVE" }'
```

Accepted deal terms and completed approval decisions are auditable. Retrying a downstream workflow must not create a second commitment or payout.

<Warning>
  A private goal never reaches Mesh without publication approval.
</Warning>