curl --request POST \
--url 'https://edi.stateset.com/v1/adapters/plan' \
--header "Authorization: Bearer $STATESET_EDI_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"
}'
[
{
"adapter": "string",
"entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"entity_type": "string",
"event_type": "string",
"operation": "string",
"target_system": "string"
}
]
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).
POST
/
v1
/
adapters
/
plan
curl --request POST \
--url 'https://edi.stateset.com/v1/adapters/plan' \
--header "Authorization: Bearer $STATESET_EDI_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"
}'
[
{
"adapter": "string",
"entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"entity_type": "string",
"event_type": "string",
"operation": "string",
"target_system": "string"
}
]
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
string
required
string
required
string
required
string
required
string (date-time)
required
object
required
string
Ed25519 signature (hex) over the canonical event message. Absent when signing is disabled. See [
crate::signing].Response
AdapterAction[] — each element:
string
required
string
required
string
required
string
required
string
required
Human-readable operation, e.g.
create sales order.string
required
Status codes
| Code | Meaning |
|---|---|
200 | Planned back-end actions |
422 | Unparseable event |
curl --request POST \
--url 'https://edi.stateset.com/v1/adapters/plan' \
--header "Authorization: Bearer $STATESET_EDI_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"
}'
[
{
"adapter": "string",
"entity_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"entity_type": "string",
"event_type": "string",
"operation": "string",
"target_system": "string"
}
]
Last modified on August 31, 2026