> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stateset.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Plans the back-end actions a canonical event would trigger across every

> catalogued adapter that consumes it — the routing preview for the event stream. Body is a VES event (event_type, entity_type, entity_id).

catalogued adapter that consumes it — the routing preview for the event
stream. Body is a VES event (`event_type`, `entity_type`, `entity_id`).

### Request body

`EdiEvent`

<ParamField body="entity_id" type="string" required />

<ParamField body="entity_type" type="string" required />

<ParamField body="event_id" type="string" required />

<ParamField body="event_type" type="string" required />

<ParamField body="occurred_at" type="string (date-time)" required />

<ParamField body="payload" type="object" required />

<ParamField body="signature" type="string">
  Ed25519 signature (hex) over the canonical event message. Absent when signing is disabled. See \[`crate::signing`].
</ParamField>

### Response

`AdapterAction[]` — each element:

<ResponseField name="adapter" type="string" required />

<ResponseField name="entity_id" type="string" required />

<ResponseField name="entity_type" type="string" required />

<ResponseField name="event_type" type="string" required />

<ResponseField name="operation" type="string" required>
  Human-readable operation, e.g. `create sales order`.
</ResponseField>

<ResponseField name="target_system" type="string" required />

### Status codes

| Code  | Meaning                  |
| ----- | ------------------------ |
| `200` | Planned back-end actions |
| `422` | Unparseable event        |

<RequestExample>
  ```bash cURL theme={null}
  curl --request POST \
    --url 'https://edi.stateset.com/v1/adapters/plan' \
    --header 'Authorization: Bearer YOUR_API_KEY' \
    --header 'Content-Type: application/json' \
    --data '{
    "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "entity_type": "string",
    "event_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "event_type": "string",
    "occurred_at": "2026-08-31T14:22:05Z",
    "payload": {},
    "signature": "sha256:9f86d081884c7d659a2feaa0c55ad015"
  }'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  [
    {
      "adapter": "string",
      "entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "entity_type": "string",
      "event_type": "string",
      "operation": "string",
      "target_system": "string"
    }
  ]
  ```
</ResponseExample>