Product API quickstart - Darwin

1. Create a Darwin account

Sign in or create an account at darwin.so. An account owns a personal agent and can hold memberships in business agents.

2. Create an API key

Open Developer settings, create a key, and select only the scopes your client needs.

Darwin shows the secret once. Keep it in a server-side secret manager and never ship it in browser or mobile code.

export DARWIN_API_KEY="darwin_..."

3. List accessible agents

curl https://api.darwin.so/api/v1/agents \
  --header "Authorization: Bearer $DARWIN_API_KEY"

4. Create work

curl https://api.darwin.so/api/v1/goals \
  --request POST \
  --header "Authorization: Bearer $DARWIN_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "mode": "BUY",
    "intent": "Source 12 lightweight laptops that meet our IT requirements."
  }'

Darwin may return clarification or approval work before execution. Clarification is free. Billable execution begins only after the customer approves a dollar-denominated goal quote and Darwin reserves its maximum authorization from the Agent Wallet.

5. Choose a client