---
title: "Enable or disable command queue."
method: PUT
path: "/v1/agents/{agentId}/command-queue"
tags: ["Agents"]
---

# Enable or disable command queue.

`PUT /v1/agents/{agentId}/command-queue`

Use this endpoint to enable or disable the command queue of an agent.

## Path parameters

- `agentId` string, uuid, required

## Request body

- object
  - `enabled` boolean, required — Enable or disable the command queue for the agent

## Response `200`

Successful response with updated command queue details

- object
  - `enabled` boolean — Indicates whether the command queue is enabled.
  - `name` string — The URL of the command queue. It is returned only for an enabled queue.
  - `visibilityTimeout` integer — The visibility timeout for messages in the command queue. It is returned only for an enabled queue.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/tetrascience/apis/tetra-data-lake.md) · [All operations](https://skmtc.net/tetrascience/apis/tetra-data-lake/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tetrascience/tetra-data-lake/revisions/0205e2bace53/schema)