API Reference - Darwin

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 for REST and SDK quickstarts.