curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/adapters/{name}/execute' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--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",
"event_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"operation": "string",
"status": 1,
"vendor_request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Delivers a canonical event through an explicitly selected live adapter…
Credentials: a workspace executes with its own stored connection (PUT /v1/adapters//connection)…
POST
/
v1
/
adapters
/
{name}
/
execute
curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/adapters/{name}/execute' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--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",
"event_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"operation": "string",
"status": 1,
"vendor_request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Credentials: a workspace executes with its own stored connection
(
PUT /v1/adapters/{name}/connection). The platform environment
credentials are used only by the platform admin token, and only when the
selected workspace has no connection of its own.
Path parameters
string
required
Live adapter name (shopify or netsuite)
Request body
EdiEvent
string
required
string
required
string
required
string
required
string (date-time)
required
object
required
string,null
Ed25519 signature (hex) over the canonical event message. Absent when signing is disabled. See [
crate::signing].Response
AdapterExecution
string
required
string
required
string
required
integer (int32)
required
Minimum:
0.string,null
Status codes
| Code | Meaning |
|---|---|
200 | Vendor accepted the event |
403 | Partner credential, or an event stamped for another workspace |
422 | Unsupported event, planning-only adapter, or no connection configured for this workspace |
502 | Vendor API rejected or could not receive the event |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request POST \
--url 'https://api.edi.stateset.com/v1/adapters/{name}/execute' \
--header "Authorization: Bearer $EDI_API_TOKEN" \
--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",
"event_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"operation": "string",
"status": 1,
"vendor_request_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Last modified on October 20, 2026