Skip to main content

OpenAPI

Darwin publishes its reviewed OpenAPI 3.1 contract at:
The documentation also publishes surface-specific contracts:

Download the OpenAPI specification

Use the same public contract that powers the API reference and generated SDKs.
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 provides a concise page index.
  • llms-full.txt provides the complete documentation corpus.
  • 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

TypeScript SDK

Generated JavaScript and TypeScript client for the public API.

Darwin Studios

Browse Darwin’s public organization and released developer tooling.
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

Darwin status

View current availability and incident updates for Darwin services.
For API failures, preserve the response request ID, status code, operation, and safe error code. Consult 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.