---
# @generated by sylphx-gen 0.1.0 from contracts@e145cc7cf1bc9605f2b27439e5e17ed76a1a2fd7e7021906a013f7565e4a0cd5. Do not edit.
title: "Queues"
description: "The `queues` collection of Sylphx Events: A Queue holds messages for pull consumers."
type: reference
product: queues
summary: "A Queue holds messages for pull consumers."
updated: 2026-09-28
order: 900
---

> **This method is not served on the public API.** `api.sylphx.com` does not route this call: its backend is not deployed behind the public API, or does not implement the call. This page documents the contract. It is kept out of the sidebar and of search engines.

A Queue holds messages for pull consumers. A consumer leases messages for a visibility timeout, then acks or nacks them; a lease is fenced, so a stale holder cannot ack a message someone else holds. A message leased `max_deliveries` times moves to the dead-letter queue.

**Service** Sylphx Events · **Resource type** `events.sylphx.com/Queue` · **Name pattern** `orgs/{org}/projects/{project}/envs/{env}/queues/{queue}` · **Shape** `spec_status`

## Fields

| Field | Type | What it is |
| --- | --- | --- |
| `name` | `string` | `orgs/{org}/projects/{project}/envs/{env}/queues/{queue}`. |
| `uid` | `string` | `que_<cell><ulid>`; never reused. Output only. |
| `meta` | `ResourceMeta` | Resource metadata. |
| `spec` | `QueueSpec` | Desired state. Required. |
| `status` | `QueueStatus` | Observed state. Output only. |

## Methods

Every method of the collection, in the registry's order, with the scope it
needs. The full request, response and examples are one link away.

| Method | Call | What it does |
| --- | --- | --- |
| `GET` | [`get`](/docs/api/queues#get) | Gets a queue. |
| `GET` | [`list`](/docs/api/queues#list) | Lists queues. |
| `POST` | [`create`](/docs/api/queues#create) | Creates a queue. |
| `PATCH` | [`update`](/docs/api/queues#update) | Updates a queue. |
| `DELETE` | [`delete`](/docs/api/queues#delete) | Deletes a queue. |
| `POST` | [`send`](/docs/api/queues#send) | Enqueues messages directly, without a Subscription. |
| `POST` | [`lease`](/docs/api/queues#lease) | Leases up to `max_messages` ready messages for the visibility timeout. |
| `POST` | [`ack`](/docs/api/queues#ack) | Acknowledges leased messages; each is removed. A lease that is stale (expired or superseded) is reported, not applied. |
| `POST` | [`nack`](/docs/api/queues#nack) | Returns leased messages to the Queue after `delay`; each nack counts as a delivery. |
| `POST` | [`replay`](/docs/api/queues#replay) | Moves dead-lettered messages, optionally bounded by dead-letter time, back to ready. |

## get

Gets a queue.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues/queue` · scope `events:read` · effect `read` · [Request, response and examples](/docs/api/queues/get)

## list

Lists queues.

`GET https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues` · scope `events:read` · effect `read` · paginated · [Request, response and examples](/docs/api/queues/list)

## create

Creates a queue.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/queues/create)

## update

Updates a queue.

`PATCH https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues/queue` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/queues/update)

## delete

Deletes a queue.

`DELETE https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues/queue` · scope `events:write` · effect `destructive` · [Request, response and examples](/docs/api/queues/delete)

## send

Enqueues messages directly, without a Subscription.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues/queue:send` · scope `events:publish` · effect `write` · [Request, response and examples](/docs/api/queues/send)

## lease

Leases up to `max_messages` ready messages for the visibility timeout.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues/queue:lease` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/queues/lease)

## ack

Acknowledges leased messages; each is removed. A lease that is stale (expired or superseded) is reported, not applied.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues/queue:ack` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/queues/ack)

## nack

Returns leased messages to the Queue after `delay`; each nack counts as a delivery.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues/queue:nack` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/queues/nack)

## replay

Moves dead-lettered messages, optionally bounded by dead-letter time, back to ready.

`POST https://api.sylphx.com/v1/orgs/acme/projects/shop/envs/production/queues/queue:replay` · scope `events:write` · effect `write` · [Request, response and examples](/docs/api/queues/replay)