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

# introduction

The Darwin API exposes authenticated access to a user's personal agent, conversations, goals, approvals, integrations, and supported platform workflows.

## Base URL

```text theme={null}
https://api.darwin.so/api/v1
```

## OpenAPI

The reviewed machine-readable contract is published at:

```text theme={null}
https://api.darwin.so/api/v1/openapi.json
```

This document powers the Mintlify API reference and Fern-generated SDKs, keeping documentation and client libraries aligned with the same reviewed contract.

## Authentication

Server-to-server requests use a scoped bearer token:

```http theme={null}
Authorization: Bearer <DARWIN_API_KEY>
```

MCP clients use OAuth. Messaging and first-party clients exchange their channel or application session for the same owner-scoped Darwin identity.

## Action results

Agent actions return a successful sanitized result or a structured state such as:

* `connection_required`
* `approval_required`
* `insufficient_authority`
* `provider_unavailable`

Every attempted consequential action is evaluated against the authenticated owner and current grant. The API derives ownership from verified context, not request parameters supplied by the model.

<Card title="Authentication" icon="key" href="/authentication">
  Learn how Darwin authenticates API and MCP clients.
</Card>