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

# Create Goal

> Create a goal, review its quote, fund its authorization, and begin execution.

## 1. Choose the agent

List the agents the current account can access and select the owner of the work. Pass that `agentId` when you create the goal.

## 2. Create the goal

Send the desired outcome, mode, visibility, and any known constraints to `POST /goals`. Use `BUY`, `SELL`, or `CHAT`; do not create separate resource types for each workflow.

Use an idempotency key when retrying creation so a network failure cannot create duplicate goals.

## 3. Answer clarification requests

Darwin may return questions or requests before it can quote the work. Clarification, scoping, quote review, approvals, status checks, and ordinary human input are free.

## 4. Review and approve the quote

The versioned quote separates seller estimates, Agent usage, Darwin's transaction-fee rate, and the maximum authorization. Approve the exact quote version you reviewed.

## 5. Fund and begin

Darwin reserves the maximum authorization from the Agent Wallet. If funds are unavailable, handle `funding_required`, complete an owner-controlled top up, and retry the approval idempotently.

During execution, handle `overage_approval_required` before additional spending. Darwin never silently exceeds the approved ceiling.

<Card title="Goals" href="/product/goals">
  Review goal modes, lifecycle states, and recurring behavior.
</Card>
