Examples

Minimal Sync

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

Expected shape: 200 with output and usage_applications, plus optional exact_bridge.

{
  "output": {
    "request_id": "req_example_sync_001",
    "trace_id": "trace_example_sync_001",
    "status": "completed"
  },
  "usage_applications": []
}

Minimal Async

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

Expected shape: 202 with workflow_id, stream_url, query_url, and cancel_url.

Extended Request with scopes, attachments, and structured_input

{
  "domain": "zhenins",
  "execution_mode": "async",
  "required_scopes": ["scope.required.by.your.integration"],
  "request_id": "req_example_001",
  "trace_id": "trace_example_001",
  "idempotency_key": "idem_example_001",
  "attachments": [
    {
      "attachment_id": "att_policy_001",
      "kind": "document",
      "url": "https://example.com/policy-summary.pdf",
      "metadata": {
        "filename": "policy-summary.pdf"
      }
    }
  ],
  "structured_input": {
    "protocol_context": {
      "demand": {
        "identity": {
          "demand_id": "dm_example_extended_001",
          "protocol_version": "c2ai2x-core/v1",
          "created_at": "2026-07-10T00:00:00Z",
          "source_surface": "partner_api",
          "source_type": "api"
        },
        "intent": {
          "category": "service_request",
          "goal": "review_coverage",
          "requested_outcome": "next_best_action",
          "priority": "normal",
          "urgency": "medium",
          "budget": {},
          "timeline": {},
          "region": "US-CA"
        },
        "input_context": {
          "raw_input": "Please review my existing coverage and suggest next steps.",
          "structured_summary": "User wants a review of current coverage and recommended next actions.",
          "conversation_refs": [],
          "attachment_refs": ["att_policy_001"],
          "external_refs": []
        },
        "constraints": {},
        "authorization": {
          "redaction_policy": "default_redact_contact",
          "revocable": true
        },
        "state": {
          "demand_state": "submitted",
          "routing_status": "pending",
          "execution_status": "not_started",
          "settlement_status": "not_applicable"
        }
      },
      "authorization_grant": {
        "grant_id": "grant_example_001",
        "demand_id": "dm_example_extended_001",
        "status": "issued",
        "grantor": {
          "actor_type": "requester",
          "actor_id": "user_001",
          "actor_role": "requester"
        },
        "grantee": {
          "actor_type": "service",
          "actor_id": "partner_app",
          "actor_role": "integrator"
        },
        "data_scope": ["read_summary"],
        "action_scope": ["execute"],
        "automation_policy": "human_confirmation_required",
        "redaction_policy": "default_redact_contact",
        "constraints": {},
        "issued_at": "2026-07-10T00:00:00Z"
      }
    }
  }
}

In the current live contract, Demand and AuthorizationGrant are shown here only as protocol-layer objects carried through structured_input. Platform admission still decides whether the request is allowed to execute.