---
title: "Set the configuration for a Task Queue."
method: POST
path: "/management/v1/warehouse/{warehouse_id}/task-queue/tabular_purge/config"
tags: ["tasks"]
---

# Set the configuration for a Task Queue.

`POST /management/v1/warehouse/{warehouse_id}/task-queue/tabular_purge/config`

## Request

- Base URL: `https://localhost`
- URL: `https://localhost/management/v1/warehouse/{warehouse_id}/task-queue/tabular_purge/config`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/docs/management/v1/warehouse/:warehouse_id/task-queue/tabular_purge/config/post.ts> (a function with typed inputs; its response is checked against the schema)

These configurations are global per warehouse and shared across all instances of this kind of task.

## Path parameters

- `warehouse_id` string, uuid, required

## Request body

- SetPurgeQueueConfig
  - `max-seconds-since-last-heartbeat` integer, nullable
  - `queue-config` PurgeQueueConfig, required

## Response `204`

Task queue config set successfully

## Other responses

- `4XX`

---

[API](https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api.md) - [All operations](https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lakekeeper/apis/lakekeeper-management-api/revisions/c5cb9a12a98c?raw)