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

# API Reference

> Darwin's focused Search and Action API.

Darwin's primary public API is deliberately small: one Search endpoint and six Action endpoints.

| Operation                          | Job                                                      |
| ---------------------------------- | -------------------------------------------------------- |
| `POST /search`                     | Find, browse, or inspect executable public capabilities. |
| `POST /actions`                    | Start an Action from an exact Search result.             |
| `GET /actions/{actionId}`          | Get one Action's current state.                          |
| `GET /actions`                     | List current Actions.                                    |
| `PATCH /actions/{actionId}`        | Add information to an Action.                            |
| `POST /actions/{actionId}/approve` | Decide an exact reviewed approval.                       |
| `POST /actions/{actionId}/stop`    | Stop the current queued or running Turn.                 |

All operations are served under `https://api.darwin.so/api/v2`. The npm and PyPI SDKs are generated from this same contract, and MCP exposes the same operation names.

An API key belongs on a trusted server. OAuth grants are bound to the authorized user and AI; sending a user ID never grants authority. Darwin checks scopes, ownership, capability revisions, approval digests, and Turn eligibility on every request.

Read the [API guide](/docs/surfaces/api) for REST and SDK quickstarts.