---
title: "Defer a message to be retried"
method: POST
path: "/v1/queue.defer"
tags: ["Querator V1"]
---

# Defer a message to be retried

`POST /v1/queue.defer`

Defer a message from a reservation. Used to defer a message for (retry) after
the time specified. Once the `offer_at` time has expired, querator will enqueue this
message into the specified queue and the `attempted` counter for this message 
will increment by 1. If the message should not be retried, but failed immediately. Set
`dead: true` and the message be placed in the dead letter queue regardless of the number
of attempts left on the message.

If you wish to fail a message such that it is deleted from the queue, then call
 `/queue.complete` instead.

## Request body

- object

## Response `200`

- object

## Changes

- **2024-09-15** `ba3240950bb2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/kapetan-io/apis/querator-api/changes/v1/queue.defer/post.md)

---

[API](https://skmtc.dev/kapetan-io/apis/querator-api.md) · [All operations](https://skmtc.dev/kapetan-io/apis/querator-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kapetan-io/querator-api/revisions/ba3240950bb2/schema)