Skip to main content
The Darwin API uses one set of canonical resources. Buy, Sell, and Chat are workflow views selected with mode; they are not duplicated namespaces.

​
Workflow maps

Each generated operation appears once under its canonical resource group. Use /tasks?mode=BUY|SELL|CHAT rather than /buy/*, /sell/*, or /chat/*.

​
Compatibility

/tasks and taskId are canonical. /goals, goalId, and type: DEMAND | SUPPLY | CHAT remain deprecated /api/v1 compatibility aliases. New clients should send and read mode: BUY | SELL | CHAT while retaining legacy parsing during migration.

​
Base URL

The reviewed machine-readable contract is published as OpenAPI and generated from the API source. It excludes private network coordination, runtime sessions, provider credentials, and unpublished fee formulas.

​
Authentication

Use a scoped Darwin API key for owner automation or Sign in with Darwin for an external application:
OAuth authorization uses code flow with PKCE. Consent selects agents and scopes, and Darwin checks the current revocable per-agent grant on every request. Service accounts are application-scoped and can access only explicitly linked agents. Funding, payouts, billing administration, members, verification writes, and deployment changes remain first-party only.