Skip to content
Console
On this page

Send a queue

Enqueues messages directly, without a Subscription.

Enqueues messages directly, without a Subscription.

  • Path POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues/queue:send
  • Scope events:publish
  • Effect write — a successful call changes state.
  • Collection queues

Request

FieldTypeWhat it is
namestringThe name of the queue. Required.
eventsCloudEvent[]The messages, at most 100. Required.
delaydurationHide the messages this long before their first lease.

CloudEvent

FieldTypeWhat it is
idstringUnique per source; with source it is the dedupe key. Required.
sourcestringThe producer's URI-reference. Required.
typestringThe event type, for example com.example.order.created. Required.
subjectstringThe subject within the source.
event_timetimestampWhen the occurrence happened.
data_content_typestringThe payload media type; default application/json.
data_schemastringThe payload schema URI.
datavalueThe payload.
extensionsmap<string, string>Extension attributes, at most 64.

Response

FieldTypeWhat it is
message_idsstring[]The message ids, in request order.

Errors

Every error arrives in the body Errors describes.

Examples

curl -X POST "https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues/queue:send" \
  -H "Authorization: Bearer $SYLPHX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"events":[{"id":"…","source":"…","type":"…"}]}'