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

# Developer resources

> Download the public contract, use AI-readable documentation, find source repositories, and check service health.

## OpenAPI

Darwin publishes its reviewed OpenAPI 3.1 contract at:

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

The documentation also publishes surface-specific contracts:

* [`product-openapi.json`](https://docs.darwin.so/product-openapi.json)
* [`connect-openapi.json`](https://docs.darwin.so/connect-openapi.json)

<Card title="Download the OpenAPI specification" icon="download" href="https://docs.darwin.so/openapi.json">
  Use the same public contract that powers the API reference and generated SDKs.
</Card>

The specification includes supported `/api/v1` developer operations only. Internal controllers, network coordination, provider credentials, and private runtime contracts are deliberately excluded. Operation IDs are stable SDK-generation inputs; deprecated `/goals` compatibility operations remain marked as deprecated.

## AI-readable documentation

Use these indexes with coding agents and language models:

* [`llms.txt`](https://docs.darwin.so/llms.txt) provides a concise page index.
* [`llms-full.txt`](https://docs.darwin.so/llms-full.txt) provides the complete documentation corpus.
* [`openapi.json`](https://docs.darwin.so/openapi.json) remains authoritative for endpoint schemas, parameters, scopes, and response codes.

Documentation prose explains intent and invariants; OpenAPI defines the transport contract. Do not infer undocumented request fields from examples.

## GitHub

<CardGroup cols={2}>
  <Card title="TypeScript SDK" icon="js" href="https://github.com/darwin-studios/darwin-node">
    Generated JavaScript and TypeScript client for the public API.
  </Card>

  <Card title="Darwin Studios" icon="github" href="https://github.com/darwin-studios">
    Browse Darwin's public organization and released developer tooling.
  </Card>
</CardGroup>

Generated clients follow the reviewed OpenAPI contract. Keep custom wrappers thin, preserve idempotency and request IDs, and avoid depending on private response fields.

## Service status

<Card title="Darwin status" icon="activity" href="https://status.darwin.so">
  View current availability and incident updates for Darwin services.
</Card>

For API failures, preserve the response request ID, status code, operation, and safe error code. Consult [Errors](/errors) before retrying. Retry only failures marked as transient, apply exponential backoff with jitter, and keep the same idempotency key for the same logical write.