Create Goal

​

1. Choose the agent

List the agents the current account can access and select the owner of the work. Pass that agentId when you create the goal.

​

2. Create the goal

Send the desired outcome, mode, visibility, and any known constraints to POST /goals. Use BUY, SELL, or CHAT; do not create separate resource types for each workflow. Use an idempotency key when retrying creation so a network failure cannot create duplicate goals.

​

3. Answer clarification requests

Darwin may return questions or requests before it can quote the work. Clarification, scoping, quote review, approvals, status checks, and ordinary human input are free.

​

4. Review and approve the quote

The versioned quote separates seller estimates, Agent usage, Darwin’s transaction-fee rate, and the maximum authorization. Approve the exact quote version you reviewed.

​

5. Fund and begin

Darwin reserves the maximum authorization from the Agent Wallet. If funds are unavailable, handle funding_required, complete an owner-controlled top up, and retry the approval idempotently. During execution, handle overage_approval_required before additional spending. Darwin never silently exceeds the approved ceiling.