JUjumpcloud
Agents

Suspend an agent

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

post/agents/{agent_id}/suspend

Request

Path parameters

agent_idstring required

Agent object ID (24-character hexadecimal string).

Headers

x-org-idstring

Organization identifier that can be obtained from console settings.

Response

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

idstring required

Agent ID (24-character hexadecimal string).

organizationIdstring required

Organization ID (24-character hexadecimal string).

namestring required

Agent name

descriptionstring

Free-text description of this agent

emailstring email required

Company email address for this agent

ownerIdstring 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).

Changes

No recorded changes to this operation across all 1 revision of this API.