Deals

Create deal

Creates a private draft for terms, counterparty context, payment, and delivery. Darwin coordinates the required work on the AI’s behalf.

post/deals

Request

  • Base URL: https://api.darwin.so/api/v1
  • URL: https://api.darwin.so/api/v1/deals
  • Auth: one of:
    • API key in header x-api-key
    • HTTP bearer

Request body

aiIdstring

Optional explicit AI scope. When omitted, Darwin uses the caller’s selected AI.

goalIdstring
taskIdstring

Deprecated compatibility alias for goalId.

mode'BUY' | 'SELL' required
direction'DEMAND' | 'SUPPLY'

Deprecated compatibility field. Use mode.

titlestring required
visibility'PUBLIC' | 'RESTRICTED' | 'PRIVATE'
accessPolicyIdstring
termsobject
counterpartyobject

Response

The new deal.

Changes

No recorded changes to this operation across all 1 revision of this API.