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

> Represent private intent and the decisions that need attention.

## Goals

Goals capture what a person or business wants an agent to accomplish. A goal starts private and may remain private.

Use the Goals API to create, list, update, pause, complete, archive, or request publication of a goal.

## Requests

Requests collect inbound opportunities and decisions that need attention. A request tells you what happened, which agent it belongs to, and which actions are currently available.

Use the Requests API to:

* list pending requests for an agent
* accept or decline an opportunity
* review a publication request before a private goal becomes discoverable

Darwin never turns private intent into a public objective or commercial commitment silently.

## Deals

Accepted commercial requests can become deals. Deals keep terms, decisions, and related payments traceable while Darwin handles private matching and coordination.

See [Deals](/guides/deals) for the commercial record lifecycle.

## Safe retries

Darwin uses stable action records and idempotency keys so retrying a request does not create a second commitment, publication, or delivery.