---
title: "Pause an agent deployment"
method: POST
path: "/v1/agents/{id}/pause"
tags: ["Managed agents"]
---

# Pause an agent deployment

`POST /v1/agents/{id}/pause`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/agents/{id}/pause`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object

## Response `200`

Success

- ManagedAgent
  - `attempt_budget_usd` number, nullable: Fixed attempt reservation from the current accepted revision. Absent for the legacy allocation policy.
  - `id` string, required
  - `name` string, required
  - `status` 'active' | 'paused', required
  - `current_revision` integer, required
  - `budget_usd` number: Deprecated compatibility field. Customer spending limits are not enforced.
  - `cost_usd` number, required
  - `reserved_usd` number, required
  - `min_workers` integer
  - `max_workers` integer
  - `workers` object, required
    - `starting` integer
    - `running` integer
    - `idle` integer
    - `stopping` integer
    - `unresolved` integer
    - `ready` integer: Unused current-revision workers with successful setup, available to compatible independent work.
    - `waiting` integer: Workers retained by waiting logical runs.
  - `created_at` string, date-time
  - `url` string
  - `queued` integer: Accepted queued or recovering runs.
  - `assistant_template` 'nodus:claude-assistant-v1' | 'nodus:claude-assistant-v2': Qualified built-in assistant from assistant_templates in the managed model catalog. Supplies its installed entrypoint and environment. No project, setup command or provider credential is required.
  - `model` string: Qualified Messages model accepted for this revision. Provider credentials stay in Nodus.
  - `model_max_output_tokens` integer: Per-call output bound for hosted model access. Omission uses the selected model maximum from the current catalog. An explicit value must fit that model. Accepted revisions retain their resolved limit.

## Other responses

- `default`: Operation refused with a diagnostic and next action

## Changes

- **2026-10-01** `24ef3f281240`: 1 info
  - the `model_max_output_tokens` response's property default value `1024` was removed for the status `200`
- **2026-10-01** `50087398f13a`: 1 warning
  - added the new `nodus:claude-assistant-v2` enum value to the `assistant_template` response property for the response status `200`
- **2026-10-01** `ba84c74aeec8`: 1 breaking, 5 info
  - the response property `budget_usd` became optional for the status `200`
  - added the optional property `assistant_template` to the response with the `200` status
  - added the optional property `attempt_budget_usd` to the response with the `200` status
  - added the optional property `model` to the response with the `200` status
  - …2 more
- **2026-10-01** `544fef290a54`: 4 warning, 2 info
  - removed the optional property `assistant_template` from the response with the `200` status
  - removed the optional property `attempt_budget_usd` from the response with the `200` status
  - removed the optional property `model` from the response with the `200` status
  - removed the optional property `model_max_output_tokens` from the response with the `200` status
  - …2 more
- **2026-09-30** `018b4077e3c1`: 1 info
  - the `model_max_output_tokens` response's property default value `1024` was removed for the status `200`

[Operation history](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/changes/v1/agents/:id/pause/post.md)

---

[API](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api.md) - [All operations](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nodus-compute/apis/nodus-infrastructure-execution-api/revisions/a59210899d95?raw)