See Stacksync in action with a solution architect. Book a demo ↗
Queues

Queues

List a queue's waiting records

GET
/v1/workspaces/{workspace_id}/queues/{workflows_app_queue_id}/records

The records waiting in the queue, oldest or newest first, with their payload, and how many wait in total.

Authorization

Authorizationstringheaderrequired

Bearer <key>, where <key> is a workspace API key or a user API key. See Authentication.

Path Parameters

workspace_id*integer

The workspace. List the ones your key can reach with GET /v1/workspaces.

workflows_app_queue_id*string

The queue.

Formatuuid

Query Parameters

limit?Limit

Maximum number of records returned, at most 100

Range1 <= value <= 100
Default20
offset?Offset

Number of items skipped before the first one returned

Range0 <= value
Default0
region*Regions

Data region of the resources: besg (Europe) or usnv (United States), as GET /v1/regions lists them.

Value in"besg""usnv"
order?QueueRecordOrder

Which waiting records come first: the oldest (the next to be flushed) or the newest

Default"oldest"
Value in"oldest""newest"

Response Body

OK

application/json
  1. response
data*array<>
has_more*Has More

Whether more items follow this page: request the next one with offset + limit

limit*Limit
offset*Offset
waiting_record_count*Waiting Record Count

Every record waiting in the queue, not only this page

List a queue's waiting records
curl -X GET 'https://api.stacksync.com/v1/workspaces/0/queues/497f6eca-6276-4993-bfeb-53cbbbba6f08/records?region=besg'
{  "data": [    {      "record_id": "<record_id>",      "created_time": "<created_time>",      "process_start_time": "<process_start_time>",      "is_to_retry": false,      "data": "<data>"    }  ],  "has_more": false,  "limit": 0,  "offset": 0,  "waiting_record_count": 0}