---
title: "Durable queues: push, pull (visibility timeout), ack, nack, stats, dead, retry_dead. At-least-once with dead letters. Free: 1,000 queues, 10,000 pushes/day."
method: POST
path: "/api/v1/queue"
tags: ["queue"]
---

# Durable queues: push, pull (visibility timeout), ack, nack, stats, dead, retry_dead. At-least-once with dead letters. Free: 1,000 queues, 10,000 pushes/day.

`POST /api/v1/queue`

## Request

- Base URL: `https://cloudforbots.com`
- URL: `https://cloudforbots.com/api/v1/queue`
- Auth: HTTP bearer

## Request body

- object
  - `action` 'push' | 'pull' | 'ack' | 'nack' | 'stats' | 'dead' | 'retry_dead' | 'purge', required
  - `queue` string
  - `message` unknown
  - `messages` unknown[]
    - unknown
  - `delay_s` integer
  - `max_attempts` integer
  - `max` integer
  - `visibility_s` integer
  - `ids` integer[]
  - `error` string

## Response `200`

ok

## Other responses

- `429`: free limit reached

---

[API](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api.md) · [All operations](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/revisions/1afdb5648693?raw)