First Request

Endpoint

• POST /api/execute
• auth: Bearer
• current public phase: phase 1

Smallest Working Request

{
  "domain": "zhenins",
  "execution_mode": "sync",
  "required_scopes": [],
  "text": "I need an insurance consultation."
}

Notes:

• if you call the route with an api_key bearer, key_id is derived from the bearer and does not need to be repeated in the body
• if you call the route with an admin bearer, the current live contract requires a body key_id
• if you need to preserve neutral Demand or AuthorizationGrant objects, carry them inside structured_input rather than treating them as the frozen top-level HTTP request shape

Success Shapes

• 200: synchronous completion returns output, usage_applications, and optional exact_bridge
• 202: accepted into async workflow

Next Reads

• quickstart.md
• execution-lifecycle.md
• api-reference.md