NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
JumpCloud connects to a Nagent workspace with an API key. Once it is connected, agents can call 2 JumpCloud actions: "Create System" and "Delete Role". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against JumpCloud, with input parameters and output schema.
JUMPCLOUD_CREATE_SYSTEMValidates credentials and provides guidance for enrolling systems in JumpCloud. Important: JumpCloud does not support creating systems via REST API. Systems must be enrolled by installing the JumpCloud Agent on each device. This action performs a credential validation check and returns detailed instructions for agent-based system enrollment, including documentation links and Connect key guidance. Use this action when you need to: - Understand how to enroll new systems in JumpCloud - Validate API credentials before system management operations - Get documentation links for the JumpCloud Agent installation process
Input parameters
Organization ID for multi-tenant admin accounts. Only required if managing multiple organizations. Sends as 'x-org-id' header to scope the request to a specific organization.
Custom text to append to the enrollment guidance message. Use this to add organization-specific instructions or contact information. Supports unicode characters and emojis.
JumpCloud resource type to query for credential validation. Use 'systems' for v1 API validation or 'systemgroups' for v2 API validation. Defaults to 'systems' if not specified.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
JUMPCLOUD_DELETE_ROLEDeletes a specific custom role from JumpCloud by its ID. This action permanently removes a custom role. Built-in system roles (Administrator, Read Only, Manager, etc.) cannot be deleted. Before deleting a role, ensure it is not currently assigned to any administrators. The operation is idempotent - attempting to delete a non-existent role returns success (404 treated as successful deletion).
Input parameters
The unique identifier (UUID) of the role to delete. Only custom roles can be deleted; built-in system roles cannot be removed.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 2 JumpCloud actions on Nagent: "Create System" and "Delete Role". Create System: Validates credentials and provides guidance for enrolling systems in JumpCloud. Each action is listed on this page with its input parameters and its output.
JumpCloud connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
It also takes 3 optional inputs: x-org-id, message_template and preflight_resource. It returns data, error and successful.