---
title: "Suspend an agent"
method: POST
path: "/agents/{agent_id}/suspend"
tags: ["Agents"]
---

# Suspend an agent

`POST /agents/{agent_id}/suspend`

## Request

- Base URL: `https://console.jumpcloud.com/api/v2`
- URL: `https://console.jumpcloud.com/api/v2/agents/{agent_id}/suspend`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/docs/agents/:agent_id/suspend/post.ts> (a function with typed inputs; its response is checked against the schema)

Suspends an agent in your organization. Suspended agents are blocked from accessing JumpCloud resources.

## Path parameters

- `agent_id` string, required

## Headers

- `x-org-id` string

## Response `200`

Agent suspended successfully. Already-issued gateway access tokens stay valid until they expire or are revoked.

- Agent: An agent — a non-human identity that can access applications assigned to it. Properties marked read-only are returned on read responses and must not be sent on create or update.
  - `id` string, required: Agent ID (24-character hexadecimal string).
  - `organizationId` string, required: Organization ID (24-character hexadecimal string).
  - `name` string, required: Agent name
  - `description` string: Free-text description of this agent
  - `email` string, email, required: Company email address for this agent
  - `ownerId` string, nullable: ID of the human user who owns this agent. Required at creation; becomes null only if the owning user is later deleted.
  - `state` 'active' | 'suspended', required: Lifecycle state (`active` or `suspended`).

## Other responses

- `401`: Unauthenticated
- `404`: Not Found
- `default`: Unexpected error

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)