Queue
| Name (singular): | Queue |
| Name (plural): | Queues |
| Alias (uri): | queue |
| Identifier (ID): | cerb.contexts.queue |
Usage tracking
Queue worklists offer a 'Activity' sparklines column charting done, failed, and open messages, with a 2h/1d/30d range toggle. A matching activity: quick search filter queries the same data – for instance, activity:(since:today).
Records API
These fields are available in the Records API and packages:
| Req'd | Field | Type | Notes |
|---|---|---|---|
claim_window_secs |
number | The number of seconds before a stalled in_flight message is reclaimed. Default: 3600 (1 hour). Use 0 to never reclaim. |
|
created_at |
timestamp | The date/time when this record was created | |
| x | extension_id |
text | The ID of the consumer extension that routes messages from this queue (e.g. cerb.queue.consumer.internal) |
links |
links | An array of record type:id tuples to link to. Prefix with - to unlink. |
|
| x | name |
text | The name of this queue |
retry_max |
number | The maximum number of retries for a failed message (0 to 16). Default: 0 (never retry). |
|
retry_window_secs |
number | The total number of seconds that retries are spread across. Default: 86400 (24 hours). |
|
updated_at |
timestamp | The date/time when this record was last modified |
Dictionary Placeholders
These placeholders are available in dictionaries for automations, snippets, and API responses:
| Field | Type | Description |
|---|---|---|
_context |
text | Record type extension ID |
_label |
text | Label |
_type |
text | Record type alias |
claim_window_secs |
number | Claim window in seconds |
created_at |
date | Created |
extension_id |
text | Consumer extension |
id |
number | Id |
name |
text | Name |
record_url |
text | Record Url |
retry_max |
number | Maximum retries |
retry_window_secs |
number | Retry window in seconds |
updated_at |
date | Updated |
These optional placeholders are also available with key expansion in dictionaries and the API:
| Field | Type | Description |
|---|---|---|
comment_count |
number | Comment count on the record |
comments |
comments | Comments |
custom_<id> |
mixed | Custom Fields |
links |
links | Links |
watchers |
watchers | Watchers |
Search Query Fields
These filters are available in queue search queries:
| Field | Type | Description |
|---|---|---|
claim.window: |
number | Claim window in seconds. Accepts durations (e.g. claim.window:>1h, claim.window:0) |
created: |
date | Created |
extension: |
text | Consumer extension ID |
fieldset: |
record | Fieldset |
id: |
number | Id |
links: |
links | Record Links |
name: |
text | Name |
retry.max: |
number | Maximum retries (e.g. retry.max:0, retry.max:>0) |
retry.window: |
number | Retry window in seconds. Accepts durations (e.g. retry.window:<1d, retry.window:>30m) |
updated: |
date | Updated |
watchers: |
record | Watchers |
Worklist Columns
These columns are available on queue worklists:
| Column | Description |
|---|---|
cf_<id> |
Custom Field |
q_claim_window_secs |
Claim window |
q_created_at |
Created |
q_extension_id |
Consumer extension |
q_id |
Id |
q_name |
Name |
q_retry_max |
Retry max |
q_retry_window_secs |
Retry window |
q_updated_at |
Updated |
q_retry_max and q_retry_window_secs are part of the default column set. q_claim_window_secs is available but isn't displayed by default – add it from the column picker.