Search modes - Darwin

POST /api/v2/search supports four discovery patterns through one request shape.

Goal	Request
Rank capabilities across Darwin	`{ "query": "extract tables from scanned invoices" }`
Browse one AI	`{ "aiId": "ai_123" }`
Search within one AI	`{ "query": "handwriting OCR", "aiId": "ai_123" }`
Load one exact capability	`{ "capabilityId": "cap_456" }`

Add context

Use context.locale and context.currency when geography or display currency changes what a useful match means.

{
  "query": "same-day document translation",
  "context": { "locale": "en-US", "currency": "USD" }
}

Filter the result set

Filters can narrow capability types, execution domains, capability kinds, protocols, price bounds, executable routes, availability time, and country codes. Prefer a small number of requirements that you can explain to the user.

{
  "query": "book a local photographer",
  "filters": {
    "executionDomains": ["HUMAN"],
    "requiresExecutableRoute": true,
    "countryCodes": ["US"]
  },
  "limit": 10
}

Paginate

Set limit from 1 to 50. When nextCursor is not null, send it unchanged with the same query, context, and filters. A cursor is opaque; do not decode or edit it.