Authorizations
You can get Service Token from SuprSend dashboard -> Account Settings -> Service Tokens section.
Path Parameters
Workspace slug (staging, production, etc.)
Unique identifier of the schema
Query Parameters
Set to true to commit the schema immediately after creation/update
Commit message describing the changes (required when commit=true)
Body
Human-readable name of the schema
"Order Placed Event"
Structure of the workflow or event payload. Follows standard json schema specification. You can link this schema to a workflow or event to validate their input payload in API response. Same schema can be linked to multiple workflows and events.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": ["order_id", "amount"],
"properties": {
"order_id": { "type": "string" },
"amount": { "type": "string" }
},
"additionalProperties": true
}
Description of the schema. Can be used to describe which action this schema is linked to.
"Schema for order placement action"
Response
Successfully retrieved schema object
Unique identifier for the schema
"new-order-placed"
Human-readable name of the schema
"Order Placed Event"
Description of the schema
"Schema for order placement action"
Status of returned schema. By default, draft version is returned. You can set mode=live
to fetch the live schema.
draft
, live
"draft"
Git-like hash for version tracking
"382b707d4b1f8999a1xxxxxxxx"
JSON schema passed in the request body.
When the schema was created
"2025-08-27T09:30:57.945326Z"
When the schema was last updated
"2025-08-29T15:37:37.650177Z"
Commit result when commit=true is passed in query parameter
{
"is_committed": false,
"errors": ["hash: no uncommitted changes found"]
}