---
title: "Complete reserved items"
method: POST
path: "/v1/queue.complete"
tags: ["Querator V1"]
---

# Complete reserved items

`POST /v1/queue.complete`

Mark `reserved` items as `completed`. The item can then be removed from the queue by Querator and will not be offered to any other consumers.

If any of the ids provided cannot be marked as `completed` then the entire request will be rejected with a code `453 Request Failed`. It is the responsibility of the client to remove the offending id and try again.

### Timeout Semantics
The call will return when the id(s) provided are completed to storage or when `request_timeout` has been reached. If the call returns with a non 200 response code, the client should consider the items provided as not completed to the queue. The client should NOT cancel the request before `request_timeout` has been reached. If the call fails to return after `request_timeout` is reached the client can safely cancel the request.

## Request body

- QueueCompleteRequest
  - `queue_name` string, required — The name of the queue these ids are from
  - `partition` integer, required — The Partition these ids are from
  - `request_timeout` string, required — The duration this request should block before the client will cancel the request
  - `ids` string[], required — A list of the item ids to mark as complete

## Response `200`

- QueueCompleteResponse
  - `code` integer, required — The response code
  - `code_text` string — The text explaination of the code
  - `message` string — The message that contains details explaining the reason for the code

## Changes

- **2024-09-15** `ba3240950bb2` — 1 info
  - request body became optional

[Change history](https://skmtc.dev/kapetan-io/apis/querator-api/changes/v1/queue.complete/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)