JumpCloud API

Directory platform for IT management

docs.jumpcloud.com/api ↗
Version
2.0
OpenAPI
3.0.0
Endpoints
416
Schemas
669
82
Quality
Updated
3 days ago
Identity identity directory it-management
Use this API in your AI agent

Query structured spec data via REST or MCP. Get exactly what your agent needs.

Get API Key

Server URLs

https://console.jumpcloud.com/api/v2

Endpoints

Clear filters

Activedirectory 4 endpoints

GET /activedirectories

This endpoint allows you to list all your Active Directory Instances.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/activedirectories/ \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: activedirectories_list

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /activedirectories
GET /activedirectories/{activedirectory_id}/agents

This endpoint allows you to list all your Active Directory Agents for a given Instance.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/activedirectories/{activedirectory_id}/agents \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: activedirectories_agentsList

Parameters

Name In Required Type Description
activedirectory_id path required string
limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /activedirectories/{activedirectory_id}/agents
GET /activedirectories/{activedirectory_id}/agents/{agent_id}

This endpoint returns an Active Directory agent.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/activedirectories/{activedirectory_id}/agents/{agent_id} \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: activedirectories_agentsGet

Parameters

Name In Required Type Description
activedirectory_id path required string
agent_id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /activedirectories/{activedirectory_id}/agents/{agent_id}
GET /activedirectories/{id}

This endpoint returns a specific Active Directory.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/activedirectories/{ActiveDirectory_ID} \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: activedirectories_get

Parameters

Name In Required Type Description
id path required string

ObjectID of this Active Directory instance.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /activedirectories/{id}

Administrators 2 endpoints

GET /administrators/{id}/organizationlinks

This endpoint returns the association links between an Administrator and Organizations.

operationId: administratorOrganizations_listByAdministrator

Parameters

Name In Required Type Description
id path required string
limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

Responses

200

OK

400
401
403
404
500
GET /administrators/{id}/organizationlinks
GET /organizations/{id}/administratorlinks

This endpoint returns the association links between an Organization and Administrators.

operationId: administratorOrganizations_listByOrganization

Parameters

Name In Required Type Description
id path required string
limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

Responses

200
400
401
403
404
500
GET /organizations/{id}/administratorlinks

Aggregatedpolicystats 1 endpoints

GET /systems/{systemObjectId}/aggregated-policy-stats

Gets the aggregated policy stats for a system.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systems/{system_object_id}/aggregated-policy-stats \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key:{API_KEY}'
operationId: AggregatedPolicyResults_Get

Parameters

Name In Required Type Description
systemObjectId path required string
organizationObjectId query optional string

Responses

default

An unexpected error response.

200

A successful response.

GET /systems/{systemObjectId}/aggregated-policy-stats

Applemdm 7 endpoints

GET /applemdms

Get a list of all Apple MDM configurations. An empty topic indicates that a signed certificate from Apple has not been provided to the PUT endpoint yet.

Note: currently only one MDM configuration per organization is supported.

Sample Request

curl https://console.jumpcloud.com/api/v2/applemdms \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: applemdms_list

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer
skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200
GET /applemdms
GET /applemdms/{apple_mdm_id}/csr

Retrieves an Apple MDM signed CSR Plist for an organization. The user must supply the returned plist to Apple for signing, and then provide the certificate provided by Apple back into the PUT API.

Sample Request

  curl -X GET https://console.jumpcloud.com/api/v2/applemdms/{APPLE_MDM_ID}/csr \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: applemdms_csrget

Parameters

Name In Required Type Description
apple_mdm_id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
400
401
403
404
409
500
GET /applemdms/{apple_mdm_id}/csr
GET /applemdms/{apple_mdm_id}/depkey

Retrieves an Apple MDM DEP Public Key.

Sample Request

curl https://console.jumpcloud.com/api/v2/applemdms/{APPLE_MDM_ID}/depkey \
  -H 'accept: application/x-pem-file' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: applemdms_depkeyget

Parameters

Name In Required Type Description
apple_mdm_id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
400
401
403
404
409
500
GET /applemdms/{apple_mdm_id}/depkey
GET /applemdms/{apple_mdm_id}/devices

Lists all Apple MDM devices.

The filter and sort queries will allow the following fields:
createdAt
depRegistered
enrolled
id
osVersion
serialNumber
udid

Sample Request

  curl -X GET https://console.jumpcloud.com/api/v2/applemdms/{apple_mdm_id}/devices \
  -H 'accept: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -d '{}'
operationId: applemdms_deviceslist

Parameters

Name In Required Type Description
apple_mdm_id path required string
limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-total-count header optional integer

Responses

200

OK

400
401
403
404
409
500
GET /applemdms/{apple_mdm_id}/devices
GET /applemdms/{apple_mdm_id}/devices/{device_id}

Gets a single Apple MDM device.

Sample Request

  curl -X GET https://console.jumpcloud.com/api/v2/applemdms/{apple_mdm_id}/devices/{device_id} \
  -H 'accept: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: applemdms_getdevice

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

apple_mdm_id path required string
device_id path required string

Responses

200

OK

400
401
403
404
409
500
GET /applemdms/{apple_mdm_id}/devices/{device_id}
GET /applemdms/{apple_mdm_id}/enrollmentprofiles

Get a list of enrollment profiles for an apple mdm.

Note: currently only one enrollment profile is supported.

Sample Request

 curl https://console.jumpcloud.com/api/v2/applemdms/{APPLE_MDM_ID}/enrollmentprofiles \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: applemdms_enrollmentprofileslist

Parameters

Name In Required Type Description
apple_mdm_id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /applemdms/{apple_mdm_id}/enrollmentprofiles
GET /applemdms/{apple_mdm_id}/enrollmentprofiles/{id}

Get an enrollment profile

Currently only requesting the mobileconfig is supported.

Sample Request

curl https://console.jumpcloud.com/api/v2/applemdms/{APPLE_MDM_ID}/enrollmentprofiles/{ID} \
  -H 'accept: application/x-apple-aspen-config' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: applemdms_enrollmentprofilesget

Parameters

Name In Required Type Description
apple_mdm_id path required string
id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /applemdms/{apple_mdm_id}/enrollmentprofiles/{id}

Applications 2 endpoints

GET /applications/{application_id}

The endpoint retrieves an Application.

operationId: applications_get

Parameters

Name In Required Type Description
application_id path required string

ObjectID of the Application.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /applications/{application_id}
GET /applications/{application_id}/import/users

Get a list of users to import from an Application IdM service provider.

operationId: import_users

Parameters

Name In Required Type Description
application_id path required string

ObjectID of the Application.

filter query optional string

Filter users by a search term

query query optional string

URL query to merge with the service provider request

sort query optional string

Sort users by supported fields

sortOrder query optional string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

Responses

200

OK

GET /applications/{application_id}/import/users

Authenticationpolicies 2 endpoints

GET /authn/policies

Get a list of all authentication policies.

Sample Request

curl https://console.jumpcloud.com/api/v2/authn/policies \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: authnpolicies_list

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

x-total-count header optional integer
limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

400
401
403
404
409
500
GET /authn/policies
GET /authn/policies/{id}

Return a specific authentication policy.

Sample Request

curl https://console.jumpcloud.com/api/v2/authn/policies/{id} \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: authnpolicies_get

Parameters

Name In Required Type Description
id path required string

Unique identifier of the authentication policy

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

400
401
403
404
409
500
GET /authn/policies/{id}

Bulkjobrequests 3 endpoints

GET /bulk/users/{job_id}/results

This endpoint will return the results of particular user import or update job request.

Sample Request

curl -X GET \
  https://console.jumpcloud.com/api/v2/bulk/users/{ImportJobID}/results \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: bulk_usersCreateResults

Parameters

Name In Required Type Description
job_id path required string
limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /bulk/users/{job_id}/results
GET /bulk/userstates

The endpoint allows you to list scheduled statechange jobs.

Sample Request

curl -X GET "https://console.jumpcloud.com/api/v2/bulk/userstates" \
  -H 'x-api-key: {API_KEY}' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json'
operationId: bulk_userStatesList

Parameters

Name In Required Type Description
limit query optional integer

The number of records to return at once. Limited to 100.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

userid query optional string

The systemuser id to filter by.

Responses

200

OK

400
401
403
404
409
500
GET /bulk/userstates
GET /bulk/userstates/eventlist/next

This endpoint is used to lookup the next upcoming scheduled state change for each user in the
given list. The users parameter is limited to 100 items per request. The results are also limited
to 100 items. This endpoint returns a max of 1 event per state per user. For example, if a user
has 3 ACTIVATED events scheduled it will return the next upcoming activation event. However, if a
user also has a SUSPENDED event scheduled along with the ACTIVATED events it will return the next
upcoming activation event and the next upcoming suspension event.

operationId: bulk_userStatesGetNextScheduled

Parameters

Name In Required Type Description
users query required array

A list of system user IDs, limited to 100 items.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

Responses

200

OK

400
401
403
404
500
GET /bulk/userstates/eventlist/next

Commands 1 endpoints

GET /queuedcommand/workflows

This endpoint will return all queued Commands for an Organization.

Each element will contain the workflow ID, the command name, the launch type (e.g. manual, triggered, or scheduled), the target OS, the number of assigned devices, and the number of pending devices that have not yet ran the command.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/queuedcommand/workflows \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: commands_getQueuedCommandsByWorkflow

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer
filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

search query optional string

The search string to query records

Responses

200

OK

400
401
403
404
409
500
GET /queuedcommand/workflows

Customemails 2 endpoints

GET /customemails/{custom_email_type}

Get the custom email configuration for the specified custom email type

operationId: customEmails_read

Parameters

Name In Required Type Description
custom_email_type path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

400
401
403
404
409
500
GET /customemails/{custom_email_type}
GET /customemail/templates

Get the list of custom email templates

operationId: customEmails_getTemplates

Responses

200

OK

400
401
403
500
GET /customemail/templates

Directories 1 endpoints

GET /directories

This endpoint returns all active directories (LDAP, O365 Suite, G-Suite).

Sample Request

 curl -X GET https://console.jumpcloud.com/api/v2/directories \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: directories_list

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

limit query optional integer

The number of records to return at once. Limited to 100.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

default

Unexpected error

200

OK

GET /directories

Duo 4 endpoints

GET /duo/accounts

This endpoint returns all the Duo accounts for your organization. Note: There can currently only be one Duo account for your organization.

Sample Request

curl https://console.jumpcloud.com/api/v2/duo/accounts \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: duo_accountList

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /duo/accounts
GET /duo/accounts/{account_id}/applications

This endpoint returns all the Duo applications for the specified Duo account. Note: There can currently only be one Duo application for your organization.

Sample Request

  curl https://console.jumpcloud.com/api/v2/duo/accounts/{ACCOUNT_ID}/applications \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: duo_applicationList

Parameters

Name In Required Type Description
account_id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
400
401
403
404
409
500
GET /duo/accounts/{account_id}/applications
GET /duo/accounts/{account_id}/applications/{application_id}

This endpoint returns a specific Duo application that is associated with the specified Duo account.

Sample Request

  curl https://console.jumpcloud.com/api/v2/duo/accounts/{ACCOUNT_ID}/applications/{APPLICATION_ID} \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: duo_applicationGet

Parameters

Name In Required Type Description
account_id path required string
application_id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
400
401
403
404
409
500
GET /duo/accounts/{account_id}/applications/{application_id}
GET /duo/accounts/{id}

This endpoint returns a specific Duo account.

Sample Request

curl https://console.jumpcloud.com/api/v2/duo/accounts/{id} \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: duo_accountGet

Parameters

Name In Required Type Description
id path required string

ObjectID of the Duo Account

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /duo/accounts/{id}

Featuretrials 1 endpoints

GET /featureTrials/{feature_code}

This endpoint get’s the current state of a feature trial for an org.

Sample Request

  curl -X GET \
  https://console.jumpcloud.local/api/v2/featureTrials/zeroTrust \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: featureTrials_getFeatureTrials

Parameters

Name In Required Type Description
feature_code path required string

Responses

200

OK

401
404
500
GET /featureTrials/{feature_code}

Gsuite 7 endpoints

GET /gsuites/{gsuite_id}/import/jumpcloudusers

Lists available G Suite users for import, translated to the Jumpcloud user schema.

operationId: gsuites_listImportJumpcloudUsers

Parameters

Name In Required Type Description
gsuite_id path required string
allowEmptyFields query optional boolean

[EXPERIMENTAL] Allow empty fields of the user object to be sent in the response

maxResults query optional integer

Google Directory API maximum number of results per page. See https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list.

orderBy query optional string

Google Directory API sort field parameter. See https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list.

pageToken query optional string

Google Directory API token used to access the next page of results. See https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list.

query query optional string

Google Directory API search parameter. See https://developers.google.com/admin-sdk/directory/v1/guides/search-users.

sortOrder query optional string

Google Directory API sort direction parameter. See https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list.

Responses

200

OK

GET /gsuites/{gsuite_id}/import/jumpcloudusers
GET /gsuites/{gsuite_id}/import/users

Lists G Suite users available for import.

operationId: gsuites_listImportUsers

Parameters

Name In Required Type Description
gsuite_id path required string
limit query optional integer

The number of records to return at once. Limited to 100.

maxResults query optional integer

Google Directory API maximum number of results per page. See https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list.

orderBy query optional string

Google Directory API sort field parameter. See https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list.

pageToken query optional string

Google Directory API token used to access the next page of results. See https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list.

query query optional string

Google Directory API search parameter. See https://developers.google.com/admin-sdk/directory/v1/guides/search-users.

sortOrder query optional string

Google Directory API sort direction parameter. See https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list.

Responses

200

OK

GET /gsuites/{gsuite_id}/import/users
GET /gsuites/{gsuite_id}/domains

List the domains configured for a specific Google Workspace directory sync integration instance.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/gsuites/{gsuite_id}/domains \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: GSuite_configuredDomainsList

Parameters

Name In Required Type Description
gsuite_id path required string

Id for the specific Google Workspace directory sync integration instance..

limit query optional string

The number of records to return at once. Limited to 100.

skip query optional string

The offset into the records to return.

Responses

default

An unexpected error response.

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

GET /gsuites/{gsuite_id}/domains
GET /gsuites/{gsuite_id}/import/schedules

Endpoint to list scheduled jobs for specified Google Workspace integration.

operationId: GSuite_listImportSchedules

Parameters

Name In Required Type Description
gsuite_id path required string

ObjectID of the Google Workspace integration

Responses

default

An unexpected error response.

200

OK

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

GET /gsuites/{gsuite_id}/import/schedules
GET /gsuites/{gsuite_id}/translationrules

This endpoint returns all graph translation rules for a specific G Suite instance. These rules specify how JumpCloud attributes translate to G Suite Admin SDK attributes.

Sample Request
curl -X GET  https://console.jumpcloud.com/api/v2/gsuites/{gsuite_id}/translationrules \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: translationRules_gSuiteList

Parameters

Name In Required Type Description
gsuite_id path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200
GET /gsuites/{gsuite_id}/translationrules
GET /gsuites/{gsuite_id}/translationrules/{id}

This endpoint returns a specific translation rule for a specific G Suite instance. These rules specify how JumpCloud attributes translate to G Suite Admin SDK attributes.

Sample Request
  curl -X GET https://console.jumpcloud.com/api/v2/gsuites/{gsuite_id}/translationrules/{id} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: translationRules_gSuiteGet

Parameters

Name In Required Type Description
gsuite_id path required string
id path required string

Responses

200
GET /gsuites/{gsuite_id}/translationrules/{id}
GET /gsuites/{id}

This endpoint returns a specific G Suite.

Sample Request
 curl -X GET https://console.jumpcloud.com/api/v2/gsuites/{GSUITE_ID} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: gsuites_get

Parameters

Name In Required Type Description
id path required string

Unique identifier of the GSuite.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /gsuites/{id}

Googleemm 6 endpoints

GET /google-emm/devices/{deviceId}

Gets a Google EMM enrolled device details.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/google-emm/devices/{deviceId} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
operationId: Devices_GetDevice

Parameters

Name In Required Type Description
deviceId path required string

Responses

200

A successful response.

GET /google-emm/devices/{deviceId}
GET /google-emm/devices/{deviceId}/policy_results

Gets an android JSON policy for a Google EMM enrolled device.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/google-emm/devices/{deviceId}/policy_results \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
operationId: Devices_GetDeviceAndroidPolicy

Parameters

Name In Required Type Description
deviceId path required string

Responses

200

A successful response.

GET /google-emm/devices/{deviceId}/policy_results
GET /google-emm/enterprises

Lists all Google EMM enterprises. An empty list indicates that the Organization is not configured with a Google EMM enterprise yet.

Note: Currently only one Google Enterprise per Organization is supported.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/google-emm/enterprises \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
operationId: Enterprises_ListEnterprises

Parameters

Name In Required Type Description
limit query optional string

The number of records to return at once. Limited to 100.

skip query optional string

The offset into the records to return.

Responses

200

A successful response.

GET /google-emm/enterprises
GET /google-emm/enterprises/{enterpriseId}/connection-status

Gives a connection status between JumpCloud and Google.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/google-emm/devices/{enterpriseId}/connection-status \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
operationId: Enterprises_GetConnectionStatus

Parameters

Name In Required Type Description
enterpriseId path required string

Responses

200

A successful response.

GET /google-emm/enterprises/{enterpriseId}/connection-status
GET /google-emm/enterprises/{enterpriseObjectId}/devices

Lists google EMM enrolled devices.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/google-emm/enterprises/{enterprise_object_id}/devices \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
operationId: Devices_ListDevices

Parameters

Name In Required Type Description
enterpriseObjectId path required string
limit query optional string

The number of records to return at once. Limited to 100.

skip query optional string

The offset into the records to return.

filter query optional array

Responses

200

A successful response.

GET /google-emm/enterprises/{enterpriseObjectId}/devices
GET /google-emm/enterprises/{enterpriseObjectId}/enrollment-tokens

Lists active, unexpired enrollement tokens for a given enterprise.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/google-emm/enterprises/{enterprise_object_id}/enrollment-tokens \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
operationId: EnrollmentTokens_ListEnrollmentTokens

Parameters

Name In Required Type Description
enterpriseObjectId path required string
limit query optional string

The number of records to return at once. Limited to 100.

skip query optional string

The offset into the records to return.

filter query optional array
sort query optional string

Use space separated sort parameters to sort the collection. Default sort is ascending. Prefix with - to sort descending.

Responses

200

A successful response.

GET /google-emm/enterprises/{enterpriseObjectId}/enrollment-tokens

Graph 75 endpoints

GET /activedirectories/{activedirectory_id}/associations

This endpoint returns the direct associations of this Active Directory instance.

A direct association can be a non-homogeneous relationship between 2 different objects, for example Active Directory and Users.

Sample Request

curl -X GET 'https://console.jumpcloud.com/api/v2/activedirectories/{ActiveDirectory_ID}/associations?targets=user \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_activeDirectoryAssociationsList

Parameters

Name In Required Type Description
activedirectory_id path required string
targets query optional array

Targets which a “active_directory” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /activedirectories/{activedirectory_id}/associations
GET /activedirectories/{activedirectory_id}/usergroups

This endpoint will return all Users Groups bound to an Active Directory instance, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Active Directory instance to the corresponding User Group; this array represents all grouping and/or associations that would have to be removed to deprovision the User Group from this Active Directory instance.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/activedirectories/{ActiveDirectory_ID}/usergroups \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_activeDirectoryTraverseUserGroup

Parameters

Name In Required Type Description
activedirectory_id path required string

ObjectID of the Active Directory instance.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200
GET /activedirectories/{activedirectory_id}/usergroups
GET /activedirectories/{activedirectory_id}/users

This endpoint will return all Users bound to an Active Directory instance, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Active Directory instance to the corresponding User; this array represents all grouping and/or associations that would have to be removed to deprovision the User from this Active Directory instance.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/activedirectories/{ActiveDirectory_ID}/users \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_activeDirectoryTraverseUser

Parameters

Name In Required Type Description
activedirectory_id path required string

ObjectID of the Active Directory instance.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

Responses

200
GET /activedirectories/{activedirectory_id}/users
GET /applications/{application_id}/associations

This endpoint will return the direct associations of an Application. A direct association can be a non-homogeneous relationship between 2 different objects, for example Applications and User Groups.

Sample Request

curl -X GET 'https://console.jumpcloud.com/api/v2/applications/{Application_ID}/associations?targets=user_group \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_applicationAssociationsList

Parameters

Name In Required Type Description
application_id path required string

ObjectID of the Application.

targets query optional array

Targets which a “application” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /applications/{application_id}/associations
GET /applications/{application_id}/usergroups

This endpoint will return all Users Groups bound to an Application, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Application to the corresponding User Group; this array represents all grouping and/or associations that would have to be removed to deprovision the User Group from this Application.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/applications/{Application_ID}/usergroups \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_applicationTraverseUserGroup

Parameters

Name In Required Type Description
application_id path required string

ObjectID of the Application.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /applications/{application_id}/usergroups
GET /applications/{application_id}/users

This endpoint will return all Users bound to an Application, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Application to the corresponding User; this array represents all grouping and/or associations that would have to be removed to deprovision the User from this Application.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/applications/{Application_ID}/users \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_applicationTraverseUser

Parameters

Name In Required Type Description
application_id path required string

ObjectID of the Application.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /applications/{application_id}/users
GET /commands/{command_id}/associations

This endpoint will return the direct associations of this Command.

A direct association can be a non-homogeneous relationship between 2 different objects, for example Commands and User Groups.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/commands/{Command_ID}/associations?targets=system_group \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_commandAssociationsList

Parameters

Name In Required Type Description
command_id path required string

ObjectID of the Command.

targets query optional array

Targets which a “command” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /commands/{command_id}/associations
GET /commands/{command_id}/systemgroups

This endpoint will return all System Groups bound to a Command, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Command to the corresponding System Group; this array represents all grouping and/or associations that would have to be removed to deprovision the System Group from this Command.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/commands/{Command_ID}/systemgroups \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_commandTraverseSystemGroup

Parameters

Name In Required Type Description
command_id path required string

ObjectID of the Command.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /commands/{command_id}/systemgroups
GET /commands/{command_id}/systems

This endpoint will return all Systems bound to a Command, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Command to the corresponding System; this array represents all grouping and/or associations that would have to be removed to deprovision the System from this Command.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/commands/{Command_ID}/systems \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_commandTraverseSystem

Parameters

Name In Required Type Description
command_id path required string

ObjectID of the Command.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /commands/{command_id}/systems
GET /gsuites/{gsuite_id}/associations

This endpoint returns the direct associations of this G Suite instance.

A direct association can be a non-homogeneous relationship between 2 different objects, for example G Suite and Users.

Sample Request

curl -X GET 'https://console.jumpcloud.com/api/v2/gsuites/{Gsuite_ID}/associations?targets=user_group \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_gSuiteAssociationsList

Parameters

Name In Required Type Description
gsuite_id path required string

ObjectID of the G Suite instance.

targets query optional array

Targets which a “g_suite” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /gsuites/{gsuite_id}/associations
GET /gsuites/{gsuite_id}/usergroups

This endpoint will return all User Groups bound to an G Suite instance, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this G Suite instance to the corresponding User Group; this array represents all grouping and/or associations that would have to be removed to deprovision the User Group from this G Suite instance.

See /members and /associations endpoints to manage those collections.

Sample Request

  curl -X GET https://console.jumpcloud.com/api/v2/gsuites/{GSuite_ID}/usergroups \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_gSuiteTraverseUserGroup

Parameters

Name In Required Type Description
gsuite_id path required string

ObjectID of the G Suite instance.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /gsuites/{gsuite_id}/usergroups
GET /gsuites/{gsuite_id}/users

This endpoint will return all Users bound to a G Suite instance, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this G Suite instance to the corresponding User; this array represents all grouping and/or associations that would have to be removed to deprovision the User from this G Suite instance.

See /members and /associations endpoints to manage those collections.

Sample Request

  curl -X GET https://console.jumpcloud.com/api/v2/gsuites/{Gsuite_ID}/users \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_gSuiteTraverseUser

Parameters

Name In Required Type Description
gsuite_id path required string

ObjectID of the G Suite instance.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /gsuites/{gsuite_id}/users
GET /identity-provider/policies/{idp_routing_policy_id}/associations

This endpoint returns the direct associations of a Routing Policy.

A direct association can be a non-homogeneous relationship between 2 different objects, for example a Routing Policy and Users.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/identity-provider/policies/{IDP_ROUTING_POLICY_ID}/associations?targets=user_group \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_idpRoutingPolicyAssociationsList

Parameters

Name In Required Type Description
idp_routing_policy_id path required string

ObjectID of the Routing Policy.

targets query optional array

Targets which a “idp_routing_policy” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /identity-provider/policies/{idp_routing_policy_id}/associations
GET /identity-provider/policies/{idp_routing_policy_id}/associations/usergroups

This endpoint will return all Users Groups bound to a routing policy, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this routing policy instance to the corresponding User Group; this array represents all grouping and/or associations that would have to be removed to deprovision the User Group from this routing policy.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/identity-provider/policies/{id}/associations/usergroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_idpRoutingPolicyTraverseUserGroup

Parameters

Name In Required Type Description
idp_routing_policy_id path required string

ObjectID of the Routing Policy.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /identity-provider/policies/{idp_routing_policy_id}/associations/usergroups
GET /identity-provider/policies/{idp_routing_policy_id}/associations/users

This endpoint will return all Users bound to a routing policy, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this routing policy to the corresponding User; this array represents all grouping and/or associations that would have to be removed to deprovision the User from this routing policy.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/identity-provider/policies/{id}/associations/users \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_idpRoutingPolicyTraverseUser

Parameters

Name In Required Type Description
idp_routing_policy_id path required string

ObjectID of the Routing Policy.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /identity-provider/policies/{idp_routing_policy_id}/associations/users
GET /ldapservers/{ldapserver_id}/associations

This endpoint returns the direct associations of this LDAP Server.

A direct association can be a non-homogeneous relationship between 2 different objects, for example LDAP and Users.

Sample Request

 curl -X GET 'https://console.jumpcloud.com/api/v2/ldapservers/{LDAP_ID}/associations?targets=user_group \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_ldapServerAssociationsList

Parameters

Name In Required Type Description
ldapserver_id path required string

ObjectID of the LDAP Server.

targets query optional array

Targets which a “ldap_server” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /ldapservers/{ldapserver_id}/associations
GET /ldapservers/{ldapserver_id}/usergroups

This endpoint will return all Users Groups bound to a LDAP Server, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this LDAP server instance to the corresponding User Group; this array represents all grouping and/or associations that would have to be removed to deprovision the User Group from this LDAP server instance.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/ldapservers/{LDAP_ID}/usergroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_ldapServerTraverseUserGroup

Parameters

Name In Required Type Description
ldapserver_id path required string

ObjectID of the LDAP Server.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /ldapservers/{ldapserver_id}/usergroups
GET /ldapservers/{ldapserver_id}/users

This endpoint will return all Users bound to an LDAP Server, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this LDAP server instance to the corresponding User; this array represents all grouping and/or associations that would have to be removed to deprovision the User from this LDAP server instance.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/ldapservers/{LDAP_ID}/users \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_ldapServerTraverseUser

Parameters

Name In Required Type Description
ldapserver_id path required string

ObjectID of the LDAP Server.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /ldapservers/{ldapserver_id}/users
GET /office365s/{office365_id}/associations

This endpoint returns direct associations of an Office 365 instance.

A direct association can be a non-homogeneous relationship between 2 different objects, for example Office 365 and Users.

Sample Request

curl -X GET 'https://console.jumpcloud.com/api/v2/office365s/{OFFICE365_ID}/associations?targets=user_group' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_office365AssociationsList

Parameters

Name In Required Type Description
office365_id path required string

ObjectID of the Office 365 instance.

targets query optional array

Targets which a “office_365” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /office365s/{office365_id}/associations
GET /office365s/{office365_id}/usergroups

This endpoint will return all Users Groups bound to an Office 365 instance, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Office 365 instance to the corresponding User Group; this array represents all grouping and/or associations that would have to be removed to deprovision the User Group from this Office 365 instance.

See /members and /associations endpoints to manage those collections.

Sample Request

  curl -X GET https://console.jumpcloud.com/api/v2/office365s/{OFFICE365_ID/usergroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_office365TraverseUserGroup

Parameters

Name In Required Type Description
office365_id path required string

ObjectID of the Office 365 suite.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /office365s/{office365_id}/usergroups
GET /office365s/{office365_id}/users

This endpoint will return all Users bound to an Office 365 instance, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Office 365 instance to the corresponding User; this array represents all grouping and/or associations that would have to be removed to deprovision the User from this Office 365 instance.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/office365s/{OFFICE365_ID}/users \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_office365TraverseUser

Parameters

Name In Required Type Description
office365_id path required string

ObjectID of the Office 365 suite.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /office365s/{office365_id}/users
GET /policies/{policy_id}/associations

This endpoint returns the direct associations of a Policy.

A direct association can be a non-homogeneous relationship between 2 different objects, for example Policies and Systems.

Sample Request

curl -X GET 'https://console.jumpcloud.com/api/v2/policies/{Policy_ID}/associations?targets=system_group \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_policyAssociationsList

Parameters

Name In Required Type Description
policy_id path required string

ObjectID of the Policy.

targets query optional array

Targets which a “policy” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /policies/{policy_id}/associations
GET /policies/{policy_id}/memberof

This endpoint returns all the Policy Groups a Policy is a member of.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/policies/{Policy_ID}/memberof \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_policyMemberOf

Parameters

Name In Required Type Description
policy_id path required string

ObjectID of the Policy.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

Date header optional string

Current date header for the System Context API

Authorization header optional string

Authorization header for the System Context API

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /policies/{policy_id}/memberof
GET /policies/{policy_id}/systemgroups

This endpoint will return all Systems Groups bound to a Policy, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Policy to the corresponding System Group; this array represents all grouping and/or associations that would have to be removed to deprovision the System Group from this Policy.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET  https://console.jumpcloud.com/api/v2/policies/{Policy_ID}/systemgroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_policyTraverseSystemGroup

Parameters

Name In Required Type Description
policy_id path required string

ObjectID of the Command.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /policies/{policy_id}/systemgroups
GET /policies/{policy_id}/systems

This endpoint will return all Systems bound to a Policy, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Policy to the corresponding System; this array represents all grouping and/or associations that would have to be removed to deprovision the System from this Policy.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/policies/{Policy_ID}/systems \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_policyTraverseSystem

Parameters

Name In Required Type Description
policy_id path required string

ObjectID of the Command.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /policies/{policy_id}/systems
GET /systems/{system_id}/policystatuses

This endpoint returns the policy results for a particular system.

Sample Request
curl -X GET https://console.jumpcloud.com/api/v2/systems/{System_ID}/policystatuses \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: policystatuses_systemsList

Parameters

Name In Required Type Description
system_id path required string

ObjectID of the System.

fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /systems/{system_id}/policystatuses
GET /policygroups/{group_id}/associations

This endpoint returns the direct associations of this Policy Group.

A direct association can be a non-homogeneous relationship between 2 different objects, for example Policy Groups and Policies.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/policygroups/{GroupID}/associations?targets=system \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_policyGroupAssociationsList

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the Policy Group.

targets query optional array

Targets which a “policy_group” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /policygroups/{group_id}/associations
GET /policygroups/{group_id}/systemgroups

This endpoint will return all System Groups bound to a Policy Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Policy Group to the corresponding System Group; this array represents all grouping and/or associations that would have to be removed to deprovision the System Group from this Policy Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/policygroups/{GroupID}/systemgroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_policyGroupTraverseSystemGroup

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the Policy Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /policygroups/{group_id}/systemgroups
GET /policygroups/{group_id}/systems

This endpoint will return all Systems bound to a Policy Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Policy Group to the corresponding System; this array represents all grouping and/or associations that would have to be removed to deprovision the System from this Policy Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/policygroups/{GroupID}/systems \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_policyGroupTraverseSystem

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the Policy Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /policygroups/{group_id}/systems
GET /policygroups/{group_id}/members

This endpoint returns the Policy members of a Policy Group.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/policygroups/{GroupID}/members \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_policyGroupMembersList

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the Policy Group.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /policygroups/{group_id}/members
GET /policygroups/{group_id}/membership

This endpoint returns all Policy members that are a member of this Policy Group.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/policygroups/{GroupID}/membership \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_policyGroupMembership

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the Policy Group.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /policygroups/{group_id}/membership
GET /radiusservers/{radiusserver_id}/associations

This endpoint returns the direct associations of a Radius Server.

A direct association can be a non-homogeneous relationship between 2 different objects, for example Radius Servers and Users.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/radiusservers/{RADIUS_ID}/associations?targets=user_group \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_radiusServerAssociationsList

Parameters

Name In Required Type Description
radiusserver_id path required string

ObjectID of the Radius Server.

targets query optional array

Targets which a “radius_server” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /radiusservers/{radiusserver_id}/associations
GET /radiusservers/{radiusserver_id}/usergroups

This endpoint will return all Users Groups bound to a RADIUS Server, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this RADIUS server instance to the corresponding User Group; this array represents all grouping and/or associations that would have to be removed to deprovision the User Group from this RADIUS server instance.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/radiusservers/{RADIUS_ID}/usergroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_radiusServerTraverseUserGroup

Parameters

Name In Required Type Description
radiusserver_id path required string

ObjectID of the Radius Server.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /radiusservers/{radiusserver_id}/usergroups
GET /radiusservers/{radiusserver_id}/users

This endpoint will return all Users bound to a RADIUS Server, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this RADIUS server instance to the corresponding User; this array represents all grouping and/or associations that would have to be removed to deprovision the User from this RADIUS server instance.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/ldapservers/{LDAP_ID}/users \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_radiusServerTraverseUser

Parameters

Name In Required Type Description
radiusserver_id path required string

ObjectID of the Radius Server.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /radiusservers/{radiusserver_id}/users
GET /softwareapps/{software_app_id}/associations

This endpoint will return the direct associations of a Software Application. A direct association can be a non-homogeneous relationship between 2 different objects, for example Software Application and System Groups.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/softwareapps/{software_app_id}/associations?targets=system_group \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_softwareappsAssociationsList

Parameters

Name In Required Type Description
software_app_id path required string

ObjectID of the Software App.

targets query optional array

Targets which a “software_app” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /softwareapps/{software_app_id}/associations
GET /softwareapps/{software_app_id}/systemgroups

This endpoint will return all Systems Groups bound to a Software App, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Software App to the corresponding System Group; this array represents all grouping and/or associations that would have to be removed to deprovision the System Group from this Software App.

See /associations endpoint to manage those collections.

Sample Request

curl -X GET  https://console.jumpcloud.com/api/v2/softwareapps/{software_app_id}/systemgroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_softwareappsTraverseSystemGroup

Parameters

Name In Required Type Description
software_app_id path required string

ObjectID of the Software App.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /softwareapps/{software_app_id}/systemgroups
GET /softwareapps/{software_app_id}/systems

This endpoint will return all Systems bound to a Software App, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this Software App to the corresponding System; this array represents all grouping and/or associations that would have to be removed to deprovision the System from this Software App.

See /associations endpoint to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/softwareapps/{software_app_id}/systems \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_softwareappsTraverseSystem

Parameters

Name In Required Type Description
software_app_id path required string

ObjectID of the Software App.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /softwareapps/{software_app_id}/systems
GET /systemgroups/{group_id}/associations

This endpoint returns the direct associations of a System Group.

A direct association can be a non-homogeneous relationship between 2 different objects, for example System Groups and Users.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{GroupID}/associations?targets=user \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_systemGroupAssociationsList

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the System Group.

targets query optional array

Targets which a “system_group” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /systemgroups/{group_id}/associations
GET /systemgroups/{group_id}/policies

This endpoint will return all Policies bound to a System Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this System Group to the corresponding Policy; this array represents all grouping and/or associations that would have to be removed to deprovision the Policy from this System Group.

See /members and /associations endpoints to manage those collections.

This endpoint is not public yet as we haven’t finished the code.

Sample Request
curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{GroupID}/policies \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_systemGroupTraversePolicy

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the System Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /systemgroups/{group_id}/policies
GET /systemgroups/{group_id}/policygroups

This endpoint will return all Policy Groups bound to a System Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this System Group to the corresponding Policy Group; this array represents all grouping and/or associations that would have to be removed to deprovision the Policy Group from this System Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{GroupID}/policygroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemGroupTraversePolicyGroup

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the System Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /systemgroups/{group_id}/policygroups
GET /systemgroups/{group_id}/usergroups

This endpoint will return all User Groups bound to a System Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this System Group to the corresponding User Group; this array represents all grouping and/or associations that would have to be removed to deprovision the User Group from this System Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{GroupID}/usergroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemGroupTraverseUserGroup

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the System Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /systemgroups/{group_id}/usergroups
GET /systemgroups/{group_id}/users

This endpoint will return all Users bound to a System Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this System Group to the corresponding User; this array represents all grouping and/or associations that would have to be removed to deprovision the User from this System Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{GroupID}/users \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_systemGroupTraverseUser

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the System Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /systemgroups/{group_id}/users
GET /systemgroups/{group_id}/commands

This endpoint will return all Commands bound to a System Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the group’s type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this System Group to the corresponding Command; this array represents all grouping and/or associations that would have to be removed to deprovision the Command from this System Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{GroupID}/commands \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_systemGroupTraverseCommand

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the System Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

details query optional string

This will provide detail descriptive response for the request.

Responses

200

OK

GET /systemgroups/{group_id}/commands
GET /systemgroups/{group_id}/members

This endpoint returns the system members of a System Group.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{Group_ID}/members \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemGroupMembersList

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the System Group.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /systemgroups/{group_id}/members
GET /systemgroups/{group_id}/membership

This endpoint returns all Systems that are a member of this System Group.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{Group_ID/membership \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemGroupMembership

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the System Group.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /systemgroups/{group_id}/membership
GET /systems/{system_id}/associations

This endpoint returns the direct associations of a System.

A direct association can be a non-homogeneous relationship between 2 different objects, for example Systems and Users.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systems/{System_ID}/associations?targets=user \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemAssociationsList

Parameters

Name In Required Type Description
system_id path required string

ObjectID of the System.

targets query optional array

Targets which a “system” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

Date header optional string

Current date header for the System Context API

Authorization header optional string

Authorization header for the System Context API

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /systems/{system_id}/associations
GET /systems/{system_id}/commands

This endpoint will return all Commands bound to a System, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this System to the corresponding Command; this array represents all grouping and/or associations that would have to be removed to deprovision the Command from this System.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systems/{System_ID}/commands \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemTraverseCommand

Parameters

Name In Required Type Description
system_id path required string

ObjectID of the System.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

details query optional string

This will provide detail descriptive response for the request.

Responses

200

OK

GET /systems/{system_id}/commands
GET /systems/{system_id}/memberof

This endpoint returns all the System Groups a System is a member of.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systems/{System_ID}/memberof \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemMemberOf

Parameters

Name In Required Type Description
system_id path required string

ObjectID of the System.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

Date header optional string

Current date header for the System Context API

Authorization header optional string

Authorization header for the System Context API

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /systems/{system_id}/memberof
GET /systems/{system_id}/policies

This endpoint will return all Policies bound to a System, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this System to the corresponding Policy; this array represents all grouping and/or associations that would have to be removed to deprovision the Policy from this System.

See /members and /associations endpoints to manage those collections.

This endpoint is not yet public as we have finish the code.

Sample Request
curl -X GET https://console.jumpcloud.com/api/v2/{System_ID}/policies \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemTraversePolicy

Parameters

Name In Required Type Description
system_id path required string

ObjectID of the System.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /systems/{system_id}/policies
GET /systems/{system_id}/policygroups

This endpoint will return all Policy Groups bound to a System, either directly or indirectly essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this System to the corresponding Policy Group; this array represents all grouping and/or associations that would have to be removed to deprovision the Policy Group from this System.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systems/{System_ID}/policygroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemTraversePolicyGroup

Parameters

Name In Required Type Description
system_id path required string

ObjectID of the System.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

Date header optional string

Current date header for the System Context API

Authorization header optional string

Authorization header for the System Context API

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /systems/{system_id}/policygroups
GET /systems/{system_id}/usergroups

This endpoint will return all User Groups bound to a System, either directly or indirectly essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this System to the corresponding User Group; this array represents all grouping and/or associations that would have to be removed to deprovision the User Group from this System.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systems/{System_ID}/usergroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemTraverseUserGroup

Parameters

Name In Required Type Description
system_id path required string

ObjectID of the System.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

Date header optional string

Current date header for the System Context API

Authorization header optional string

Authorization header for the System Context API

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /systems/{system_id}/usergroups
GET /systems/{system_id}/users

This endpoint will return all Users bound to a System, either directly or indirectly essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this System to the corresponding User; this array represents all grouping and/or associations that would have to be removed to deprovision the User from this System.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systems/{System_ID}/users \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_systemTraverseUser

Parameters

Name In Required Type Description
system_id path required string

ObjectID of the System.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

Date header optional string

Current date header for the System Context API

Authorization header optional string

Authorization header for the System Context API

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /systems/{system_id}/users
GET /usergroups/{group_id}/activedirectories

This endpoint will return all Active Directory Instances bound to a User Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User Group to the corresponding Active Directory; this array represents all grouping and/or associations that would have to be removed to deprovision the Active Directory from this User Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/activedirectories \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userGroupTraverseActiveDirectory

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200
GET /usergroups/{group_id}/activedirectories
GET /usergroups/{group_id}/applications

This endpoint will return all Applications bound to a User Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User Group to the corresponding Application; this array represents all grouping and/or associations that would have to be removed to deprovision the Application from this User Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/applications \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userGroupTraverseApplication

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /usergroups/{group_id}/applications
GET /usergroups/{group_id}/associations

This endpoint returns the direct associations of this User Group.

A direct association can be a non-homogeneous relationship between 2 different objects, for example User Groups and Users.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/associations?targets=system \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userGroupAssociationsList

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

targets query optional array

Targets which a “user_group” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /usergroups/{group_id}/associations
GET /usergroups/{group_id}/directories

This endpoint will return all Directories bound to a User Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User Group to the corresponding Directory; this array represents all grouping and/or associations that would have to be removed to deprovision the Directories from this User Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/directories \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_userGroupTraverseDirectory

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /usergroups/{group_id}/directories
GET /usergroups/{group_id}/gsuites

This endpoint will return all G Suite Instances bound to a User Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User Group to the corresponding G Suite instance; this array represents all grouping and/or associations that would have to be removed to deprovision the G Suite instance from this User Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID/gsuites \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_userGroupTraverseGSuite

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /usergroups/{group_id}/gsuites
GET /usergroups/{group_id}/ldapservers

This endpoint will return all LDAP Servers bound to a User Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User Group to the corresponding LDAP Server; this array represents all grouping and/or associations that would have to be removed to deprovision the LDAP Server from this User Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/ldapservers \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userGroupTraverseLdapServer

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /usergroups/{group_id}/ldapservers
GET /usergroups/{group_id}/office365s

This endpoint will return all Office 365 instances bound to a User Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User Group to the corresponding Office 365 instance; this array represents all grouping and/or associations that would have to be removed to deprovision the Office 365 instance from this User Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/office365s \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userGroupTraverseOffice365

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /usergroups/{group_id}/office365s
GET /usergroups/{group_id}/radiusservers

This endpoint will return all RADIUS servers bound to a User Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User Group to the corresponding RADIUS Server; this array represents all grouping and/or associations that would have to be removed to deprovision the RADIUS Server from this User Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/radiusservers \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_userGroupTraverseRadiusServer

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /usergroups/{group_id}/radiusservers
GET /usergroups/{group_id}/systemgroups

This endpoint will return all System Groups bound to a User Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User Group to the corresponding System Group; this array represents all grouping and/or associations that would have to be removed to deprovision the System Group from this User Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/systemgroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userGroupTraverseSystemGroup

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /usergroups/{group_id}/systemgroups
GET /usergroups/{group_id}/systems

This endpoint will return all Systems bound to a User Group, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User Group to the corresponding System; this array represents all grouping and/or associations that would have to be removed to deprovision the System from this User Group.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/systems \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userGroupTraverseSystem

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /usergroups/{group_id}/systems
GET /usergroups/{group_id}/members

This endpoint returns the user members of a User Group.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/members \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userGroupMembersList

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /usergroups/{group_id}/members
GET /usergroups/{group_id}/membership

This endpoint returns all users members that are a member of this User Group.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/membership \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userGroupMembership

Parameters

Name In Required Type Description
group_id path required string

ObjectID of the User Group.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /usergroups/{group_id}/membership
GET /users/{user_id}/activedirectories

This endpoint will return all Active Directory Instances bound to a User, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User to the corresponding Active Directory instance; this array represents all grouping and/or associations that would have to be removed to deprovision the Active Directory instance from this User.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/activedirectories \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userTraverseActiveDirectory

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

Responses

200
GET /users/{user_id}/activedirectories
GET /users/{user_id}/applications

This endpoint will return all Applications bound to a User, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User to the corresponding Application; this array represents all grouping and/or associations that would have to be removed to deprovision the Application from this User.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/applications \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userTraverseApplication

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /users/{user_id}/applications
GET /users/{user_id}/associations

This endpoint returns the direct associations of a User.

A direct association can be a non-homogeneous relationship between 2 different objects, for example Users and Systems.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/associations?targets=system_group \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: graph_userAssociationsList

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

targets query optional array

Targets which a “user” can be associated to.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /users/{user_id}/associations
GET /users/{user_id}/directories

This endpoint will return all Directories bound to a User, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User to the corresponding Directory; this array represents all grouping and/or associations that would have to be removed to deprovision the Directory from this User.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/directories \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userTraverseDirectory

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /users/{user_id}/directories
GET /users/{user_id}/gsuites

This endpoint will return all G-Suite Instances bound to a User, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User to the corresponding G Suite instance; this array represents all grouping and/or associations that would have to be removed to deprovision the G Suite instance from this User.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/gsuites \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userTraverseGSuite

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /users/{user_id}/gsuites
GET /users/{user_id}/ldapservers

This endpoint will return all LDAP Servers bound to a User, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User to the corresponding LDAP Server; this array represents all grouping and/or associations that would have to be removed to deprovision the LDAP Server from this User.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/ldapservers \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userTraverseLdapServer

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /users/{user_id}/ldapservers
GET /users/{user_id}/memberof

This endpoint returns all the User Groups a User is a member of.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/memberof \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userMemberOf

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /users/{user_id}/memberof
GET /users/{user_id}/office365s

This endpoint will return all Office 365 Instances bound to a User, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User to the corresponding Office 365 instance; this array represents all grouping and/or associations that would have to be removed to deprovision the Office 365 instance from this User.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/office365s \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userTraverseOffice365

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /users/{user_id}/office365s
GET /users/{user_id}/radiusservers

This endpoint will return all RADIUS Servers bound to a User, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User to the corresponding RADIUS Server; this array represents all grouping and/or associations that would have to be removed to deprovision the RADIUS Server from this User.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/radiusservers \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userTraverseRadiusServer

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /users/{user_id}/radiusservers
GET /users/{user_id}/systemgroups

This endpoint will return all System Groups bound to a User, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User to the corresponding System Group; this array represents all grouping and/or associations that would have to be removed to deprovision the System Group from this User.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/systemgroups\
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userTraverseSystemGroup

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /users/{user_id}/systemgroups
GET /users/{user_id}/systems

This endpoint will return all Systems bound to a User, either directly or indirectly, essentially traversing the JumpCloud Graph for your Organization.

Each element will contain the type, id, attributes and paths.

The attributes object is a key/value hash of compiled graph attributes for all paths followed.

The paths array enumerates each path from this User to the corresponding System; this array represents all grouping and/or associations that would have to be removed to deprovision the System from this User.

See /members and /associations endpoints to manage those collections.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/systems\
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: graph_userTraverseSystem

Parameters

Name In Required Type Description
user_id path required string

ObjectID of the User.

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /users/{user_id}/systems

Groups 1 endpoints

GET /groups

This endpoint returns all Groups that exist in your organization.

Available filter fields:

  • name
  • disabled
  • type

Sample Request

  curl -X GET \
  https://console.jumpcloud.com/api/v2/groups \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: groups_list

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

x-unfiltered-total-count header optional integer

If provided in the request with any non-empty value, this header will be returned on the response populated with the total count of objects without filters taken into account

Responses

default

Unexpected error

200

OK

GET /groups

Iplists 2 endpoints

GET /iplists

Retrieve all IP lists.

Sample Request

curl https://console.jumpcloud.com/api/v2/iplists \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: iplists_list

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

x-total-count header optional integer
limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

400
401
403
404
409
500
GET /iplists
GET /iplists/{id}

Return a specific IP list.

Sample Request

curl https://console.jumpcloud.com/api/v2/iplists/{id} \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: iplists_get

Parameters

Name In Required Type Description
id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

400
401
403
404
409
500
GET /iplists/{id}

Ldapservers 2 endpoints

GET /ldapservers

This endpoint returns the object IDs of your LDAP servers.

Sample Request

```
curl -X GET https://console.jumpcloud.com/api/v2/ldapservers/ \
-H ‘Accept: application/json’ \
-H ‘Content-Type: application/json’ \
-H ‘x-api-key: {API_KEY}’

operationId: ldapservers_list

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /ldapservers
GET /ldapservers/{id}

This endpoint returns a specific LDAP server.

Sample Request
 curl -X GET https://console.jumpcloud.com/api/v2/ldapservers/{LDAP_ID} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: ldapservers_get

Parameters

Name In Required Type Description
id path required string

Unique identifier of the LDAP server.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /ldapservers/{id}

Logos 1 endpoints

GET /logos/{id}

Return the logo image associated with the specified id

operationId: logos_get

Parameters

Name In Required Type Description
id path required string

Responses

200

OK

404
500
GET /logos/{id}

Office365 5 endpoints

GET /office365s/{office365_id}/import/users

Lists Office 365 users available for import.

operationId: office365s_listImportUsers

Parameters

Name In Required Type Description
office365_id path required string
ConsistencyLevel header optional string

Defines the consistency header for O365 requests. See https://docs.microsoft.com/en-us/graph/api/user-list?view=graph-rest-1.0&tabs=http#request-headers

top query optional integer

Office 365 API maximum number of results per page. See https://docs.microsoft.com/en-us/graph/paging.

skipToken query optional string

Office 365 API token used to access the next page of results. See https://docs.microsoft.com/en-us/graph/paging.

filter query optional string

Office 365 API filter parameter. See https://docs.microsoft.com/en-us/graph/api/user-list?view=graph-rest-1.0&tabs=http#optional-query-parameters.

search query optional string

Office 365 API search parameter. See https://docs.microsoft.com/en-us/graph/api/user-list?view=graph-rest-1.0&tabs=http#optional-query-parameters.

orderby query optional string

Office 365 API orderby parameter. See https://docs.microsoft.com/en-us/graph/api/user-list?view=graph-rest-1.0&tabs=http#optional-query-parameters.

count query optional boolean

Office 365 API count parameter. See https://docs.microsoft.com/en-us/graph/api/user-list?view=graph-rest-1.0&tabs=http#optional-query-parameters.

Responses

200

OK

GET /office365s/{office365_id}/import/users
GET /office365s/{office365_id}

This endpoint returns a specific Office 365 instance.

#####

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/office365s/{OFFICE365_ID} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: office365s_get

Parameters

Name In Required Type Description
office365_id path required string

ObjectID of the Office 365 instance.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /office365s/{office365_id}
GET /office365s/{office365_id}/domains

List the domains configured for a specific M365/Azure AD directory sync integration instance.

Sample Request

curl -X POST https://console.jumpcloud.com/api/v2/office365s/{OFFICE365_ID}/domains \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: Domains_List

Parameters

Name In Required Type Description
office365_id path required string

Id for the specific M365/Azure AD directory sync integration instance.

limit query optional string

The number of records to return at once. Limited to 100.

skip query optional string

The offset into the records to return.

Responses

default

An unexpected error response.

200

OK

401
403
404
500
GET /office365s/{office365_id}/domains
GET /office365s/{office365_id}/translationrules

This endpoint returns all translation rules for a specific Office 365 instance. These rules specify how JumpCloud attributes translate to Microsoft Graph attributes.

Sample Request
 curl -X GET  https://console.jumpcloud.com/api/v2/office365s/{office365_id}/translationrules \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: translationRules_office365List

Parameters

Name In Required Type Description
office365_id path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200
GET /office365s/{office365_id}/translationrules
GET /office365s/{office365_id}/translationrules/{id}

This endpoint returns a specific translation rule for a specific Office 365 instance. These rules specify how JumpCloud attributes translate to Microsoft Graph attributes.

Sample Request
  curl -X GET https://console.jumpcloud.com/api/v2/office365s/{office365_id}/translationrules/{id} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: translationRules_office365Get

Parameters

Name In Required Type Description
office365_id path required string
id path required string

Responses

200
GET /office365s/{office365_id}/translationrules/{id}

Organizations 1 endpoints

GET /organizations/cases

This endpoint returns the cases (Support/Feature requests) for the organization

operationId: organizations_orgListCases

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

limit query optional integer

The number of records to return at once. Limited to 100.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /organizations/cases

Passwordmanager 2 endpoints

GET /passwordmanager/devices

List Devices

operationId: DeviceService_ListDevices

Parameters

Name In Required Type Description
limit query optional integer
skip query optional integer
sort query optional string
fields query optional array
filter query optional array

Responses

default

An unexpected error response.

200

A successful response.

GET /passwordmanager/devices
GET /passwordmanager/devices/{UUID}

Get Device

operationId: DeviceService_GetDevice

Parameters

Name In Required Type Description
UUID path required string

Responses

default

An unexpected error response.

200

A successful response.

GET /passwordmanager/devices/{UUID}

Policies 6 endpoints

GET /policies

This endpoint returns all policies.

Sample Request
 curl -X GET  https://console.jumpcloud.com/api/v2/policies \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: policies_list

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

500

Unexpected error.

GET /policies
GET /policies/{id}

This endpoint returns a specific policy.

Sample Request
  curl -X GET https://console.jumpcloud.com/api/v2/policies/{PolicyID} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: policies_get

Parameters

Name In Required Type Description
id path required string

ObjectID of the Policy object.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /policies/{id}
GET /policies/{policy_id}/policyresults

This endpoint returns all policies results for a specific policy.

Sample Request
 curl -X GET https://console.jumpcloud.com/api/v2/policies/{Policy_ID}/policyresults \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: policyresults_list

Parameters

Name In Required Type Description
policy_id path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200
GET /policies/{policy_id}/policyresults
GET /policies/{policy_id}/policystatuses

This endpoint returns the latest policy results for a specific policy.

Sample Request
 curl -X GET https://console.jumpcloud.com/api/v2/policies/{Policy_ID}/policystatuses \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: policystatuses_policiesList

Parameters

Name In Required Type Description
policy_id path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /policies/{policy_id}/policystatuses
GET /policyresults

This endpoint returns all policy results for an organization.

Sample Request
 curl -X GET https://console.jumpcloud.com/api/v2/policyresults \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: Policies_listAllPolicyResults

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200
GET /policyresults
GET /policyresults/{id}

This endpoint will return the policy results for a specific policy.

Sample Request
curl -X GET https://console.jumpcloud.com/api/v2/policyresults/{Policy_ID} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: policyresults_get

Parameters

Name In Required Type Description
id path required string

ObjectID of the Policy Result.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /policyresults/{id}

Policygroups 2 endpoints

GET /policygroups

This endpoint returns all Policy Groups.

Available filter fields:

  • name
  • disabled
  • type

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/policygroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: PolicyGroups_listAll

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

default

Unexpected error

200

OK

GET /policygroups
GET /policygroups/{id}

This endpoint returns the details of a Policy Group.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/policygroups/{GroupID} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: PolicyGroups_getDetails

Parameters

Name In Required Type Description
id path required string

ObjectID of the Policy Group.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /policygroups/{id}

Policytemplates 2 endpoints

GET /policytemplates

This endpoint returns all policy templates.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/policytemplates \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: policytemplates_list

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

500

Unexpected error.

GET /policytemplates
GET /policytemplates/{id}

This endpoint returns a specific policy template.

Sample Request

 curl -X GET https://console.jumpcloud.com/api/v2/policytemplates/{Policy_Template_ID}\
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: policytemplates_get

Parameters

Name In Required Type Description
id path required string

ObjectID of the Policy Template.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /policytemplates/{id}

Providers 43 endpoints

GET /providers/{provider_id}/billing/contract

Retrieve contract for a Provider

operationId: Billing_GetContract

Parameters

Name In Required Type Description
provider_id path required string

Responses

default

An unexpected error response.

200

OK

401
403
404
500
GET /providers/{provider_id}/billing/contract
GET /providers/{provider_id}/billing/details

Retrieve billing details for a Provider

operationId: Billing_GetDetails

Parameters

Name In Required Type Description
provider_id path required string

Responses

default

An unexpected error response.

200

OK

401
403
404
500
GET /providers/{provider_id}/billing/details
GET /providers/{provider_id}/integrations

Retrieves a list of integrations this provider has configured. You must be associated to the provider to use this endpoint.

operationId: providers_retrieveIntegrations

Parameters

Name In Required Type Description
provider_id path required string
filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/integrations
GET /providers/{provider_id}/integrations/autotask/alerts/configuration

Get all Autotask ticketing alert configurations for a provider.

operationId: autotask_retrieveAllAlertConfigurations

Parameters

Name In Required Type Description
provider_id path required string

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/integrations/autotask/alerts/configuration
GET /providers/{provider_id}/integrations/autotask/alerts/configuration/options

Get all Autotask ticketing alert configuration options for a provider.

operationId: autotask_retrieveAllAlertConfigurationOptions

Parameters

Name In Required Type Description
provider_id path required string

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/integrations/autotask/alerts/configuration/options
GET /providers/{provider_id}/integrations/connectwise/alerts/configuration

Get all ConnectWise ticketing alert configurations for a provider.

operationId: connectwise_retrieveAllAlertConfigurations

Parameters

Name In Required Type Description
provider_id path required string

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/integrations/connectwise/alerts/configuration
GET /providers/{provider_id}/integrations/connectwise/alerts/configuration/options

Get all ConnectWise ticketing alert configuration options for a provider.

operationId: connectwise_retrieveAllAlertConfigurationOptions

Parameters

Name In Required Type Description
provider_id path required string

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/integrations/connectwise/alerts/configuration/options
GET /providers/{provider_id}/integrations/syncro/alerts/configuration

Get all Syncro ticketing alert configurations for a provider.

operationId: syncro_retrieveAllAlertConfigurations

Parameters

Name In Required Type Description
provider_id path required string

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/integrations/syncro/alerts/configuration
GET /providers/{provider_id}/integrations/syncro/alerts/configuration/options

Get all Syncro ticketing alert configuration options for a provider.

operationId: syncro_retrieveAllAlertConfigurationOptions

Parameters

Name In Required Type Description
provider_id path required string

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/integrations/syncro/alerts/configuration/options
GET /providers/{provider_id}/integrations/ticketing/alerts

Get all ticketing alerts available for a provider’s ticketing integration.

operationId: mtpIntegration_retrieveAlerts

Parameters

Name In Required Type Description
provider_id path required string

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/integrations/ticketing/alerts
GET /integrations/autotask/{UUID}

Retrieves configuration for given Autotask integration id. You must be associated to the provider the integration is tied to in order to use this api.

operationId: autotask_getConfiguration

Parameters

Name In Required Type Description
UUID path required string

Responses

200

OK

400
401
403
404
500
GET /integrations/autotask/{UUID}
GET /integrations/autotask/{UUID}/companies

Retrieves a list of Autotask companies for the given Autotask id. You must be associated to the same provider as the Autotask integration to use this endpoint.

operationId: autotask_retrieveCompanies

Parameters

Name In Required Type Description
UUID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

400
401
403
404
500
GET /integrations/autotask/{UUID}/companies
GET /integrations/autotask/{UUID}/companytypes

Retrieves a list of user defined company types from Autotask for the given Autotask id.

operationId: autotask_retrieveCompanyTypes

Parameters

Name In Required Type Description
UUID path required string

Responses

200

OK

400
401
403
404
500
GET /integrations/autotask/{UUID}/companytypes
GET /integrations/autotask/{UUID}/contracts

Retrieves a list of Autotask contracts for the given Autotask integration id. You must be associated to the same provider as the Autotask integration to use this endpoint.

operationId: autotask_retrieveContracts

Parameters

Name In Required Type Description
UUID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200
400
401
403
404
500
GET /integrations/autotask/{UUID}/contracts
GET /integrations/autotask/{UUID}/contracts/fields

Retrieves a list of Autotask contract fields for the given Autotask integration id. You must be associated to the same provider as the Autotask integration to use this endpoint.

operationId: autotask_retrieveContractsFields

Parameters

Name In Required Type Description
UUID path required string

Responses

200
400
401
403
404
500
GET /integrations/autotask/{UUID}/contracts/fields
GET /integrations/autotask/{UUID}/contracts/services

Retrieves a list of Autotask contract services for the given Autotask integration id. You must be associated to the same provider as the Autotask integration to use this endpoint.

operationId: autotask_retrieveServices

Parameters

Name In Required Type Description
UUID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200
400
401
403
404
500
GET /integrations/autotask/{UUID}/contracts/services
GET /integrations/autotask/{UUID}/mappings

Retrieves the list of mappings for this Autotask integration. You must be associated to the same provider as the Autotask integration to use this api.

operationId: autotask_retrieveMappings

Parameters

Name In Required Type Description
UUID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

400
401
403
404
500
GET /integrations/autotask/{UUID}/mappings
GET /integrations/autotask/{UUID}/settings

Retrieve the Autotask integration settings. You must be associated to the same provider as the Autotask integration to use this endpoint.

operationId: autotask_retrieveSettings

Parameters

Name In Required Type Description
UUID path required string

Responses

200

OK

400
401
403
404
500
GET /integrations/autotask/{UUID}/settings
GET /integrations/connectwise/{UUID}

Retrieves configuration for given ConnectWise integration id. You must be associated to the provider the integration is tied to in order to use this api.

operationId: connectwise_getConfiguration

Parameters

Name In Required Type Description
UUID path required string

Responses

200

OK

400
401
403
404
500
GET /integrations/connectwise/{UUID}
GET /integrations/connectwise/{UUID}/agreements

Retrieves a list of ConnectWise agreements for the given ConnectWise id. You must be associated to the same provider as the ConnectWise integration to use this endpoint.

operationId: connectwise_retrieveAgreements

Parameters

Name In Required Type Description
UUID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200
400
401
403
404
500
GET /integrations/connectwise/{UUID}/agreements
GET /integrations/connectwise/{UUID}/agreements/{agreement_ID}/additions

Retrieves a list of ConnectWise additions for the given ConnectWise id and Agreement id. You must be associated to the same provider as the ConnectWise integration to use this endpoint.

operationId: connectwise_retrieveAdditions

Parameters

Name In Required Type Description
UUID path required string
agreement_ID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200
400
401
403
404
500
GET /integrations/connectwise/{UUID}/agreements/{agreement_ID}/additions
GET /integrations/connectwise/{UUID}/companies

Retrieves a list of ConnectWise companies for the given ConnectWise id. You must be associated to the same provider as the ConnectWise integration to use this endpoint.

operationId: connectwise_retrieveCompanies

Parameters

Name In Required Type Description
UUID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

400
401
403
404
500
GET /integrations/connectwise/{UUID}/companies
GET /integrations/connectwise/{UUID}/companytypes

Retrieves a list of user defined company types from ConnectWise for the given ConnectWise id.

operationId: connectwise_retrieveCompanyTypes

Parameters

Name In Required Type Description
UUID path required string

Responses

200

OK

400
401
403
404
500
GET /integrations/connectwise/{UUID}/companytypes
GET /integrations/connectwise/{UUID}/mappings

Retrieves the list of mappings for this ConnectWise integration. You must be associated to the same provider as the ConnectWise integration to use this api.

operationId: connectwise_retrieveMappings

Parameters

Name In Required Type Description
UUID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

400
401
403
404
500
GET /integrations/connectwise/{UUID}/mappings
GET /integrations/connectwise/{UUID}/settings

Retrieve the ConnectWise integration settings. You must be associated to the same provider as the ConnectWise integration to use this endpoint.

operationId: connectwise_retrieveSettings

Parameters

Name In Required Type Description
UUID path required string

Responses

200

OK

400
401
403
404
500
GET /integrations/connectwise/{UUID}/settings
GET /integrations/syncro/{UUID}

Retrieves configuration for given Syncro integration id. You must be associated to the provider the integration is tied to in order to use this api.

operationId: syncro_getConfiguration

Parameters

Name In Required Type Description
UUID path required string

Responses

200

OK

400
401
403
404
500
GET /integrations/syncro/{UUID}
GET /integrations/syncro/{UUID}/billing_mapping_configuration_options

Retrieves a list of dependencies for Syncro billing mappings.

operationId: syncro_retrieveBillingMappingConfigurationOptions

Parameters

Name In Required Type Description
UUID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

400
401
403
404
500
GET /integrations/syncro/{UUID}/billing_mapping_configuration_options
GET /integrations/syncro/{UUID}/companies

Retrieves a list of Syncro companies for the given Syncro id. You must be associated to the same provider as the Syncro integration to use this endpoint.

operationId: syncro_retrieveCompanies

Parameters

Name In Required Type Description
UUID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

400
401
403
404
500
GET /integrations/syncro/{UUID}/companies
GET /integrations/syncro/{UUID}/mappings

Retrieves the list of mappings for this Syncro integration. You must be associated to the same provider as the Syncro integration to use this api.

operationId: syncro_retrieveMappings

Parameters

Name In Required Type Description
UUID path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

400
401
403
404
500
GET /integrations/syncro/{UUID}/mappings
GET /integrations/syncro/{UUID}/settings

Retrieve the Syncro integration settings. You must be associated to the same provider as the Syncro integration to use this endpoint.

operationId: syncro_retrieveSettings

Parameters

Name In Required Type Description
UUID path required string

Responses

200

OK

400
401
403
404
500
GET /integrations/syncro/{UUID}/settings
GET /integrations/{integration_type}/{UUID}/errors

Retrieves recent sync errors for given integration type and integration id. You must be associated to the provider the integration is tied to in order to use this api.

operationId: mtpIntegration_retrieveSyncErrors

Parameters

Name In Required Type Description
UUID path required string
integration_type path required string

Responses

200

OK

400
401
403
404
500
GET /integrations/{integration_type}/{UUID}/errors
GET /providers/{provider_id}

This endpoint returns details about a provider

operationId: providers_getProvider

Parameters

Name In Required Type Description
provider_id path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

Responses

200
400
401
403
404
500
GET /providers/{provider_id}
GET /providers/{provider_id}/administrators

This endpoint returns a list of the Administrators associated with the Provider. You must be associated with the provider to use this route.

operationId: providers_listAdministrators

Parameters

Name In Required Type Description
provider_id path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

sortIgnoreCase query optional array

The comma separated fields used to sort the collection, ignoring case.
Default sort is ascending, prefix with - to sort descending.

Responses

200
401
GET /providers/{provider_id}/administrators
GET /providers/{provider_id}/cases

This endpoint returns the cases (Support/Feature requests) for the provider

operationId: providers_providerListCase

Parameters

Name In Required Type Description
provider_id path required string
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

limit query optional integer

The number of records to return at once. Limited to 100.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

GET /providers/{provider_id}/cases
GET /providers/{provider_id}/invoices

Retrieves a list of invoices for this provider. You must be associated to the provider to use this endpoint.

operationId: providers_retrieveInvoices

Parameters

Name In Required Type Description
provider_id path required string
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

limit query optional integer

The number of records to return at once. Limited to 100.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/invoices
GET /providers/{provider_id}/invoices/{ID}

Retrieves an invoice for this provider. You must be associated to the provider to use this endpoint.

operationId: providers_retrieveInvoice

Parameters

Name In Required Type Description
provider_id path required string
ID path required string

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/invoices/{ID}
GET /providers/{provider_id}/organizations

This endpoint returns a list of the Organizations associated with the Provider. You must be associated with the provider to use this route.

operationId: providers_listOrganizations

Parameters

Name In Required Type Description
provider_id path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

sortIgnoreCase query optional array

The comma separated fields used to sort the collection, ignoring case.
Default sort is ascending, prefix with - to sort descending.

Responses

200
400
401
403
404
500
GET /providers/{provider_id}/organizations
GET /cases/metadata

This endpoint returns the metadata for cases

operationId: organizations_casesMetadata

Responses

200

OK

GET /cases/metadata
GET /providers/{provider_id}/configuredpolicytemplates

Retrieves a list of Configured Policy Templates for this provider.

operationId: policyGroupTemplates_listConfiguredPolicyTemplates

Parameters

Name In Required Type Description
provider_id path required string
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

limit query optional integer

The number of records to return at once. Limited to 100.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/configuredpolicytemplates
GET /providers/{provider_id}/configuredpolicytemplates/{id}

Retrieves a Configured Policy Templates for this provider and Id.

operationId: policyGroupTemplates_getConfiguredPolicyTemplate

Parameters

Name In Required Type Description
provider_id path required string
id path required string

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/configuredpolicytemplates/{id}
GET /providers/{provider_id}/policygrouptemplates

Retrieves a list of Policy Group Templates for this provider.

operationId: policyGroupTemplates_list

Parameters

Name In Required Type Description
provider_id path required string
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

limit query optional integer

The number of records to return at once. Limited to 100.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/policygrouptemplates
GET /providers/{provider_id}/policygrouptemplates/{id}

Retrieves a Policy Group Template for this provider.

operationId: policyGroupTemplates_get

Parameters

Name In Required Type Description
provider_id path required string
id path required string

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/policygrouptemplates/{id}
GET /providers/{provider_id}/policygrouptemplates/{id}/members

Retrieves a Policy Group Template’s Members.

operationId: policyGroupTemplates_listMembers

Parameters

Name In Required Type Description
provider_id path required string
id path required string
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

limit query optional integer

The number of records to return at once. Limited to 100.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

Responses

200

OK

400
401
403
404
500
GET /providers/{provider_id}/policygrouptemplates/{id}/members

Pushverification 1 endpoints

GET /pushendpoints/verifications/{verificationId}

Endpoint for retrieving a verification push notification status

operationId: PushVerifications_Get

Parameters

Name In Required Type Description
verificationId path required string

Responses

default

An unexpected error response.

200

OK

400

Bad Request

401

Unauthorized

403

Forbidden

429

Too Many Requests

500

Internal Server Error

GET /pushendpoints/verifications/{verificationId}

Sambadomains 2 endpoints

GET /ldapservers/{ldapserver_id}/sambadomains

This endpoint returns all samba domains for an LDAP server.

Sample Request
curl -X GET https://console.jumpcloud.com/api/v2/ldapservers/{LDAP_ID}/sambadomains \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: ldapservers_sambaDomainsList

Parameters

Name In Required Type Description
ldapserver_id path required string

Unique identifier of the LDAP server.

fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

default
200
GET /ldapservers/{ldapserver_id}/sambadomains
GET /ldapservers/{ldapserver_id}/sambadomains/{id}

This endpoint returns a specific samba domain for an LDAP server.

Sample Request
curl -X GET \
  https://console.jumpcloud.com/api/v2/ldapservers/ldapservers/{LDAP_ID}/sambadomains/{SAMBA_ID} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: ldapservers_sambaDomainsGet

Parameters

Name In Required Type Description
ldapserver_id path required string

Unique identifier of the LDAP server.

id path required string

Unique identifier of the samba domain.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /ldapservers/{ldapserver_id}/sambadomains/{id}

Softwareapps 3 endpoints

GET /softwareapps

This endpoint allows you to get all configured Software Applications that will be managed by JumpCloud on associated JumpCloud systems.
The optional isConfigEnabled and appConfiguration apple_vpp attributes are not included in the response.

Sample Request

$ curl -X GET https://console.jumpcloud.com/api/v2/softwareapps \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
operationId: softwareApps_list

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

GET /softwareapps
GET /softwareapps/{id}

Retrieves a Software Application.
The optional isConfigEnabled and appConfiguration apple_vpp attributes are populated in this response.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/softwareapps/{id} \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: softwareApps_get

Parameters

Name In Required Type Description
id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

400
401
403
404
409
500
GET /softwareapps/{id}
GET /softwareapps/{software_app_id}/statuses

This endpoint allows you to get the status of the provided Software Application on associated JumpCloud systems.

Sample Request

$ curl -X GET https://console.jumpcloud.com/api/v2/softwareapps/{software_app_id}/statuses \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
operationId: softwareAppStatuses_list

Parameters

Name In Required Type Description
software_app_id path required string

ObjectID of the Software App.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

GET /softwareapps/{software_app_id}/statuses

Subscriptions 1 endpoints

GET /subscriptions

This endpoint returns all pricing & packaging subscriptions.

Sample Request
 curl -X GET  https://console.jumpcloud.com/api/v2/subscriptions \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: subscriptions_get

Responses

200

OK

GET /subscriptions

Systemgroups 3 endpoints

GET /systemgroups

This endpoint returns all System Groups.

Available filter fields:

  • name
  • disabled
  • type
  • membershipMethod

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: SystemGroups_listAll

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

default

Unexpected error

200

OK

GET /systemgroups
GET /systemgroups/{group_id}/suggestions

This endpoint returns available suggestions for a given system group

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{GroupID}/suggestions \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: SystemGroups_listSuggestions

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

group_id path required string

ID of the group

Responses

200

OK

GET /systemgroups/{group_id}/suggestions
GET /systemgroups/{id}

This endpoint returns the details of a System Group.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systemgroups/{Group_ID} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: SystemGroups_viewDetails

Parameters

Name In Required Type Description
id path required string

ObjectID of the System Group.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /systemgroups/{id}

Systeminsights 60 endpoints

GET /systeminsights/alf

Valid filter fields are system_id and global_state.

operationId: SystemInsights_listAlf

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

limit query optional integer

Responses

200
GET /systeminsights/alf
GET /systeminsights/alf_exceptions

Valid filter fields are system_id and state.

operationId: SystemInsights_listAlfExceptions

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

limit query optional integer

Responses

200
GET /systeminsights/alf_exceptions
GET /systeminsights/alf_explicit_auths

Valid filter fields are system_id and process.

operationId: SystemInsights_listAlfExplicitAuths

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

limit query optional integer

Responses

200
GET /systeminsights/alf_explicit_auths
GET /systeminsights/appcompat_shims

Valid filter fields are system_id and enabled.

operationId: SystemInsights_listAppcompatShims

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/appcompat_shims
GET /systeminsights/apps

Lists all apps for macOS devices. For Windows devices, use List System Insights Programs.

Valid filter fields are system_id and bundle_name.

operationId: SystemInsights_listApps

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/apps
GET /systeminsights/authorized_keys

Valid filter fields are system_id and uid.

operationId: SystemInsights_listAuthorizedKeys

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/authorized_keys
GET /systeminsights/azure_instance_metadata

Valid filter fields are system_id.

operationId: SystemInsights_listAzureInstanceMetadata

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
400
GET /systeminsights/azure_instance_metadata
GET /systeminsights/azure_instance_tags

Valid filter fields are system_id.

operationId: SystemInsights_listAzureInstanceTags

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
400
GET /systeminsights/azure_instance_tags
GET /systeminsights/battery

Valid filter fields are system_id and health.

operationId: SystemInsights_listBatteryData

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/battery
GET /systeminsights/bitlocker_info

Valid filter fields are system_id and protection_status.

operationId: SystemInsights_listBitlockerInfo

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/bitlocker_info
GET /systeminsights/browser_plugins

Valid filter fields are system_id and name.

operationId: SystemInsights_listBrowserPlugins

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/browser_plugins
GET /systeminsights/certificates

Valid filter fields are system_id and common_name.

operationId: SystemInsights_listCertificates

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3
Note: You can only filter by system_id and common_name

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/certificates
GET /systeminsights/chassis_info

Valid filter fields are system_id.

operationId: SystemInsights_getChassisInfo

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
400
GET /systeminsights/chassis_info
GET /systeminsights/chrome_extensions

Valid filter fields are system_id and name.

operationId: SystemInsights_listChromeExtensions

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/chrome_extensions
GET /systeminsights/connectivity

The only valid filter field is system_id.

operationId: SystemInsights_listConnectivity

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/connectivity
GET /systeminsights/crashes

Valid filter fields are system_id and identifier.

operationId: SystemInsights_listCrashes

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/crashes
GET /systeminsights/cups_destinations

Valid filter fields are system_id and name.

operationId: SystemInsights_listCupsDestinations

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/cups_destinations
GET /systeminsights/disk_encryption

Valid filter fields are system_id and encryption_status.

operationId: SystemInsights_listDiskEncryption

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/disk_encryption
GET /systeminsights/disk_info

Valid filter fields are system_id and disk_index.

operationId: SystemInsights_getDiskInfo

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/disk_info
GET /systeminsights/dns_resolvers

Valid filter fields are system_id and type.

operationId: SystemInsights_listDnsResolvers

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/dns_resolvers
GET /systeminsights/etc_hosts

Valid filter fields are system_id and address.

operationId: SystemInsights_listEtcHosts

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/etc_hosts
GET /systeminsights/firefox_addons

Valid filter fields are system_id and name.

operationId: SystemInsights_listFirefoxAddons

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/firefox_addons
GET /systeminsights/groups

Valid filter fields are system_id and groupname.

operationId: SystemInsights_listGroups

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/groups
GET /systeminsights/ie_extensions

Valid filter fields are system_id and name.

operationId: SystemInsights_getIEExtensionsList

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/ie_extensions
GET /systeminsights/interface_addresses

Valid filter fields are system_id and address.

operationId: SystemInsights_listInterfaceAddresses

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/interface_addresses
GET /systeminsights/interface_details

Valid filter fields are system_id and interface.

operationId: SystemInsights_listInterfaceDetails

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/interface_details
GET /systeminsights/kernel_info

Valid filter fields are system_id and version.

operationId: SystemInsights_getKernelInfo

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/kernel_info
GET /systeminsights/launchd

Valid filter fields are system_id and name.

operationId: SystemInsights_listLaunchd

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/launchd
GET /systeminsights/linux_packages

Lists all programs for Linux devices. For macOS devices, use List System Insights System Apps. For windows devices, use List System Insights System Apps.

Valid filter fields are name and package_format.

operationId: SystemInsights_listLinuxPackages

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/linux_packages
GET /systeminsights/logged_in_users

Valid filter fields are system_id and user.

operationId: SystemInsights_listLoggedInUsers

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/logged_in_users
GET /systeminsights/logical_drives

Valid filter fields are system_id and device_id.

operationId: SystemInsights_listLogicalDrives

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/logical_drives
GET /systeminsights/managed_policies

Valid filter fields are system_id and domain.

operationId: SystemInsights_listManagedPolicies

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/managed_policies
GET /systeminsights/mounts

Valid filter fields are system_id and path.

operationId: SystemInsights_listMounts

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/mounts
GET /systeminsights/os_version

Valid filter fields are system_id and version.

operationId: SystemInsights_getOsVersion

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/os_version
GET /systeminsights/patches

Valid filter fields are system_id and hotfix_id.

operationId: SystemInsights_listPatches

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/patches
GET /systeminsights/programs

Lists all programs for Windows devices. For macOS devices, use List System Insights Apps.

Valid filter fields are system_id and name.

operationId: SystemInsights_listPrograms

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/programs
GET /systeminsights/python_packages

Valid filter fields are system_id and name.

operationId: SystemInsights_listPythonPackages

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/python_packages
GET /systeminsights/safari_extensions

Valid filter fields are system_id and name.

operationId: SystemInsights_listSafariExtensions

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/safari_extensions
GET /systeminsights/scheduled_tasks

Valid filter fields are system_id and enabled.

operationId: SystemInsights_listScheduledTasks

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/scheduled_tasks
GET /systeminsights/secureboot

Valid filter fields are system_id.

operationId: SystemInsights_listSecureBoot

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
400
GET /systeminsights/secureboot
GET /systeminsights/services

Valid filter fields are system_id and name.

operationId: SystemInsights_listServices

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/services
GET /systeminsights/shadow

Valid filter fields are system_id and username.

operationId: SystemInsights_listShadowData

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/shadow
GET /systeminsights/shared_folders

Valid filter fields are system_id and name.

operationId: SystemInsights_listSharedFolders

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/shared_folders
GET /systeminsights/shared_resources

Valid filter fields are system_id and type.

operationId: SystemInsights_listSharedResources

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/shared_resources
GET /systeminsights/sharing_preferences

Only valid filed field is system_id.

operationId: SystemInsights_listSharingPreferences

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/sharing_preferences
GET /systeminsights/sip_config

Valid filter fields are system_id and enabled.

operationId: SystemInsights_getSipConfig

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/sip_config
GET /systeminsights/startup_items

Valid filter fields are system_id and name.

operationId: SystemInsights_listStartupItems

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/startup_items
GET /systeminsights/system_controls

Valid filter fields are system_id and name.

operationId: SystemInsights_listSystemControls

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3
Note: You can only filter by system_id and name

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/system_controls
GET /systeminsights/system_info

Valid filter fields are system_id and cpu_subtype.

operationId: SystemInsights_getSystemInfoList

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/system_info
GET /systeminsights/tpm_info

Valid filter fields are system_id.

operationId: SystemInsights_getTpmInfo

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
400
GET /systeminsights/tpm_info
GET /systeminsights/uptime

Valid filter fields are system_id and days.

operationId: SystemInsights_listUptime

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, gte, in. e.g:
Filter for single value:
filter=field:gte:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/uptime
GET /systeminsights/usb_devices

Valid filter fields are system_id and model.

operationId: SystemInsights_listUsbDevices

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/usb_devices
GET /systeminsights/user_groups

Only valid filter field is system_id.

operationId: SystemInsights_getUserGroups

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/user_groups
GET /systeminsights/user_ssh_keys

Valid filter fields are system_id and uid.

operationId: SystemInsights_listUserSshKeys

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

limit query optional integer

Responses

200
GET /systeminsights/user_ssh_keys
GET /systeminsights/userassist

Valid filter fields are system_id.

operationId: SystemInsights_listUserAssist

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
400
GET /systeminsights/userassist
GET /systeminsights/users

Valid filter fields are system_id and username.

operationId: SystemInsights_listUsers

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/users
GET /systeminsights/wifi_networks

Valid filter fields are system_id and security_type.

operationId: SystemInsights_listWifiNetworks

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/wifi_networks
GET /systeminsights/wifi_status

Valid filter fields are system_id and security_type.

operationId: SystemInsights_listWifiStatus

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/wifi_status
GET /systeminsights/windows_security_center

Valid filter fields are system_id.

operationId: SystemInsights_listWindowsSecurityCenter

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
400
GET /systeminsights/windows_security_center
GET /systeminsights/windows_security_products

Valid filter fields are system_id and state.

operationId: SystemInsights_listWindowsSecurityProducts

Parameters

Name In Required Type Description
skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending. e.g:
Sort by single field:
sort=field
Sort descending by single field:
sort=-field
Sort by multiple fields:
sort=field1,-field2,field3

filter query optional array

Supported operators are: eq, in. e.g:
Filter for single value:
filter=field:eq:value
Filter for any value in a list: (note “pipe” character: | separating values)
filter=field:in:value1|value2|value3

x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

Responses

200
GET /systeminsights/windows_security_products

Systems 3 endpoints

GET /systems/{system_id}/softwareappstatuses

This endpoint returns all the statuses of the associated Software Applications from the provided JumpCloud system ID.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/systems/{system_id}/softwareappstatuses \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: systems_ListSoftwareAppsWithStatuses

Parameters

Name In Required Type Description
system_id path required string

ObjectID of the System.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

Responses

200

OK

GET /systems/{system_id}/softwareappstatuses
GET /accessrequests/{accessId}

Endpoint for getting all access requests by access id

operationId: AccessRequestApi_GetAccessRequest

Parameters

Name In Required Type Description
accessId path required string

Responses

default

An unexpected error response.

200

A successful response.

GET /accessrequests/{accessId}
GET /systems/{system_id}/fdekey

This endpoint will return the current (latest) fde key saved for a system.

operationId: systems_getFDEKey

Parameters

Name In Required Type Description
system_id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
400
401
403
404
409
500
GET /systems/{system_id}/fdekey

Systemsorganizationsettings 2 endpoints

GET /devices/settings/defaultpasswordsync

Gets the Default Password Sync Setting for an Organization.

operationId: SystemsOrgSettings_GetDefaultPasswordSyncSettings

Parameters

Name In Required Type Description
organizationObjectId query optional string

Responses

default

An unexpected error response.

200

Setting successfully retrieved.

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

GET /devices/settings/defaultpasswordsync
GET /devices/settings/signinwithjumpcloud

Gets the Sign In with JumpCloud Settings for an Organization.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/devices/settings/signinwithjumpcloud \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key:{API_KEY}'
operationId: SystemsOrgSettings_GetSignInWithJumpCloudSettings

Parameters

Name In Required Type Description
organizationObjectId query optional string

Responses

default

An unexpected error response.

200

Settings successfully retrieved.

400

Bad Request

401

Unauthorized

403

Forbidden

404

Not Found

500

Internal Server Error

GET /devices/settings/signinwithjumpcloud

Usergroups 3 endpoints

GET /usergroups

This endpoint returns all User Groups.

Available filter fields:

  • name
  • disabled
  • type
  • membershipMethod
  • suggestionCounts.add
  • suggestionCounts.remove
  • suggestionCounts.total
  • attributes.sudo.enabled
  • attributes.sudo.withoutPassword

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: UserGroups_listAll

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

default

Unexpected error

200

OK

GET /usergroups
GET /usergroups/{group_id}/suggestions

This endpoint returns available suggestions for a given group

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID}/suggestions \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'

operationId: UserGroups_getSuggestions

Parameters

Name In Required Type Description
x-org-id header optional string

Organization identifier that can be obtained from console settings.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

group_id path required string

ID of the group

Responses

200

OK

GET /usergroups/{group_id}/suggestions
GET /usergroups/{id}

This endpoint returns the details of a User Group.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/usergroups/{GroupID} \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: UserGroups_getDetails

Parameters

Name In Required Type Description
id path required string

ObjectID of the User Group.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

GET /usergroups/{id}

Users 2 endpoints

GET /users/{user_id}/pushendpoints

This endpoint returns the list of push endpoints associated with a user.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/users/{UserID}/pushendpoints \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: ${API_KEY}'
operationId: pushEndpoints_list

Parameters

Name In Required Type Description
user_id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

400
401
403
404
409
500
GET /users/{user_id}/pushendpoints
GET /users/{user_id}/pushendpoints/{push_endpoint_id}

This endpoint will retrieve a push endpoint associated with a user.

operationId: pushEndpoints_get

Parameters

Name In Required Type Description
user_id path required string
push_endpoint_id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200

OK

400
401
403
404
409
500
GET /users/{user_id}/pushendpoints/{push_endpoint_id}

Workdayimport 4 endpoints

GET /workdays

This endpoint will return all the available information about all your instances of Workday.

Sample Request
curl -X GET https://console.jumpcloud.com/api/v2/workdays/ \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: workdays_list

Parameters

Name In Required Type Description
fields query optional array

The comma separated fields included in the returned records.
If omitted, the default list of fields will be returned.

limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

filter query optional array

A filter to apply to the query.

Filter structure: <field>:<operator>:<value>.

field = Populate with a valid field from an endpoint response.

operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in.
Note: v1 operators differ from v2 operators.

value = Populate with the value you want to search for. Is case sensitive. Supports wild cards.

EX: GET /api/v2/groups?filter=name:eq:Test+Group

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /workdays
GET /workdays/{id}

This endpoint will return all the available information about an instance of Workday.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/workdays/ \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: workdays_get

Parameters

Name In Required Type Description
id path required string
x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /workdays/{id}
GET /workdays/{id}/import/{job_id}/results

This endpoint provides a list of job results from the workday import and will contain all imported data from Workday.

Sample Request

curl -X GET https://console.jumpcloud.com/api/v2/workdays/{WorkdayID}/import/{ImportJobID}/results \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'
operationId: workdays_importresults

Parameters

Name In Required Type Description
id path required string
job_id path required string
limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /workdays/{id}/import/{job_id}/results
GET /workdays/{workday_id}/workers

This endpoint will return all of the data in your WorkDay Custom Report that has been associated with your WorkDay Instance in JumpCloud.

Sample Request
curl -X GET https://console.jumpcloud.com/api/v2/workdays/{WorkDayID}/workers \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}'


operationId: workdays_workers

Parameters

Name In Required Type Description
workday_id path required string
limit query optional integer

The number of records to return at once. Limited to 100.

skip query optional integer

The offset into the records to return.

sort query optional array

The comma separated fields used to sort the collection.
Default sort is ascending, prefix with - to sort descending.

x-org-id header optional string

Organization identifier that can be obtained from console settings.

Responses

200
GET /workdays/{workday_id}/workers

Schemas

object ADE
{
  "type": "object",
  "title": "ADE",
  "properties": {
    "setupOptions": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/SetupAssistantOption"
      },
      "description": "A list of configured setup options for this enrollment."
    },
    "welcomeScreen": {
      "$ref": "#/components/schemas/DEPWelcomeScreen"
    },
    "setupAssistantOptions": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/DEPSetupAssistantOption"
      },
      "description": "A Setup Option wrapped as an object",
      "x-deprecated": true
    },
    "enableZeroTouchEnrollment": {
      "type": "boolean",
      "description": "A toggle to determine if ADE registered devices should go through JumpCloud Zero Touch Enrollment."
    },
    "defaultDeviceGroupObjectIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "nullable": true,
      "description": "An array of ObjectIDs identifying the default device groups for this specific type (based on the OS family) of automated device enrollment. Currently, only a single DeviceGroupID is supported."
    }
  }
}
object ADES
{
  "type": "object",
  "title": "ADES",
  "properties": {
    "ios": {
      "$ref": "#/components/schemas/ADE"
    },
    "macos": {
      "$ref": "#/components/schemas/ADE"
    }
  }
}
object AccessRequestApiRevokeAccessRequestResponse
{
  "type": "object",
  "example": {},
  "properties": {}
}
object AccessRequestApiUpdateAccessRequestRequest
{
  "type": "object",
  "properties": {
    "expiry": {
      "type": "string",
      "format": "date-time"
    },
    "remarks": {
      "type": "string"
    },
    "additionalAttributes": {
      "type": "object"
    },
    "organizationObjectId": {
      "type": "string",
      "format": "byte"
    }
  }
}
object AccessRequestApiUpdateAccessRequestResponse
{
  "type": "object",
  "example": {},
  "properties": {}
}
array ActivedirectoriesAgentsListResponse
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/active-directory-agent-list"
  }
}
array ActivedirectoriesListResponse
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/active-directory"
  }
}
object Address
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "type": {
      "type": "string",
      "maxLength": 1024
    },
    "poBox": {
      "type": "string",
      "maxLength": 1024
    },
    "region": {
      "type": "string",
      "maxLength": 1024
    },
    "country": {
      "type": "string",
      "maxLength": 1024
    },
    "locality": {
      "type": "string",
      "maxLength": 1024
    },
    "postalCode": {
      "type": "string",
      "maxLength": 1024
    },
    "streetAddress": {
      "type": "string",
      "maxLength": 1024
    },
    "extendedAddress": {
      "type": "string",
      "maxLength": 1024
    }
  }
}
object Administrator
{
  "type": "object",
  "title": "Administrator",
  "example": {
    "id": "0123456789abcdef01234567",
    "email": "joe@example.com",
    "lastname": "Blough",
    "firstname": "Joe",
    "registered": false,
    "enableMultiFactor": true
  },
  "properties": {
    "id": {
      "type": "string"
    },
    "role": {
      "type": "string"
    },
    "email": {
      "type": "string"
    },
    "lastname": {
      "type": "string"
    },
    "roleName": {
      "type": "string"
    },
    "apiKeySet": {
      "type": "boolean"
    },
    "firstname": {
      "type": "string"
    },
    "suspended": {
      "type": "boolean"
    },
    "registered": {
      "type": "boolean"
    },
    "apiKeyAllowed": {
      "type": "boolean"
    },
    "enableMultiFactor": {
      "type": "boolean"
    },
    "organizationAccessTotal": {
      "type": "number"
    }
  }
}
object AdministratorOrganizationLink
{
  "type": "object",
  "title": "AdministratorOrganizationLink",
  "example": {
    "organization": "6230a0d26a4e4bc86c6b36f1",
    "administrator": "6230a0c233a6cbea7c470398"
  },
  "properties": {
    "organization": {
      "type": "string",
      "description": "The identifier for an organization"
    },
    "administrator": {
      "type": "string",
      "description": "The identifier for an administrator"
    }
  }
}
object AdministratorOrganizationLinkReq
{
  "type": "object",
  "title": "AdministratorOrganizationLinkReq",
  "example": {
    "organization": "6230a0d26a4e4bc86c6b36f1"
  },
  "properties": {
    "organization": {
      "type": "string",
      "description": "The identifier for an organization to link this administrator to."
    }
  }
}
array AdministratorOrganizationsListByAdministratorResponse
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/AdministratorOrganizationLink"
  }
}
array AdministratorOrganizationsListByOrganizationResponse
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/AdministratorOrganizationLink"
  }
}
object AnyValue
{
  "description": "Can be any value - string, number, boolean, array or object."
}
object AppleMDM
{
  "type": "object",
  "title": "AppleMDM",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "ObjectId uniquely identifying an MDM Enrollment,"
    },
    "dep": {
      "$ref": "#/components/schemas/DEP"
    },
    "ades": {
      "$ref": "#/components/schemas/ADES"
    },
    "name": {
      "type": "string",
      "maxLength": 255,
      "description": "A friendly name to identify this enrollment.  Not required to be unique."
    },
    "organization": {
      "type": "string",
      "description": "The identifier for an organization"
    },
    "apnsPushTopic": {
      "type": "string",
      "description": "The push topic assigned to this enrollment by Apple after uploading the Signed CSR plist."
    },
    "apnsCertExpiry": {
      "type": "string",
      "description": "The expiration date and time for the APNS Certificate."
    },
    "depServerTokenState": {
      "enum": [
        "unknown",
        "missing",
        "valid",
        "expired"
      ],
      "type": "string",
      "description": "The state of the dep server token, presence and expiry."
    },
    "defaultSystemGroupID": {
      "type": "string",
      "description": "ObjectId uniquely identifying the MDM default System Group.",
      "x-deprecated": true
    },
    "depAccessTokenExpiry": {
      "type": "string",
      "description": "The expiration date and time for the DEP Access Token. This aligns with the DEP Server Token State."
    },
    "appleCertSerialNumber": {
      "type": "string",
      "description": "The serial number of the Apple signed certificate associated to the Device Manager."
    },
    "appleCertCreatorAppleID": {
      "type": "string",
      "description": "The Apple ID of the admin who created the Apple signed certificate associated to the Device Manager."
    },
    "allowMobileUserEnrollment": {
      "type": "boolean",
      "description": "A toggle to allow mobile device enrollment for an organization."
    },
    "defaultIosUserEnrollmentDeviceGroupID": {
      "type": "string",
      "description": "ObjectId uniquely identifying the MDM default iOS user enrollment device group."
    }
  }
}
object ApplemdmsDevicesClearActivationLock500Response
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDevicesClearActivationLockResponse
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDevicesOsUpdateStatusResponse
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDevicesRefreshActivationLockInformation500Response
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDevicesRefreshActivationLockInformationResponse
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDevicesScheduleOsUpdateResponse
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDeviceserase500Response
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDeviceseraseRequest
{
  "type": "object",
  "properties": {
    "pin": {
      "type": "string",
      "example": "123456",
      "pattern": "^[0-9]{6}$",
      "description": "6-digit PIN, required for MacOS, to erase the device"
    }
  }
}
object ApplemdmsDeviceseraseResponse
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
array ApplemdmsDeviceslistResponse
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/apple-mdm-device"
  }
}
object ApplemdmsDeviceslock500Response
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDeviceslockRequest
{
  "type": "object",
  "properties": {
    "pin": {
      "type": "string",
      "example": "123456",
      "pattern": "^[0-9]{6}$",
      "description": "6-digit PIN, required for MacOS, to lock the device"
    }
  }
}
object ApplemdmsDeviceslockResponse
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDevicesrestart500Response
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDevicesrestartRequest
{
  "type": "object",
  "properties": {
    "kextPaths": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The string to pass when doing a restart and performing a RebuildKernelCache."
    }
  }
}
object ApplemdmsDevicesrestartResponse
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDevicesshutdown500Response
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsDevicesshutdownResponse
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
array ApplemdmsEnrollmentprofileslistResponse
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/AppleMDM"
  }
}
array ApplemdmsListResponse
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/AppleMDM"
  }
}
object ApplemdmsRefreshdepdevices500Response
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplemdmsRefreshdepdevicesResponse
{
  "type": "object",
  "properties": {
    "message": {
      "type": "string"
    }
  }
}
object ApplicationsGetResponse
{
  "type": "object",
  "example": {},
  "properties": {}
}
object ApplicationsPostLogoRequest
{
  "type": "object",
  "properties": {
    "image": {
      "type": "string",
      "format": "binary",
      "description": "The file to upload."
    }
  }
}
array Apps
{
  "type": "array",
  "items": {
    "type": "object",
    "properties": {
      "osId": {
        "type": "integer",
        "format": "int32",
        "example": 1
      },
      "appVersion": {
        "type": "string",
        "example": "1.1.1"
      }
    }
  }
}
object AuthnPolicy
{
  "type": "object",
  "title": "AuthnPolicy",
  "properties": {
    "id": {
      "type": "string",
      "readOnly": true
    },
    "name": {
      "type": "string"
    },
    "type": {
      "$ref": "#/components/schemas/AuthnPolicyType"
    },
    "effect": {
      "$ref": "#/components/schemas/AuthnPolicyEffect"
    },
    "targets": {
      "$ref": "#/components/schemas/AuthnPolicyTargets"
    },
    "disabled": {
      "type": "boolean"
    },
    "conditions": {
      "type": "object",
      "description": "Conditions may be added to an authentication policy using the following conditional language:\n\n```\n<conditions> ::= <expression>\n<expression> ::= <deviceEncrypted> | <deviceManaged> | <ipAddressIn> |\n                 <locationIn> | <notExpression> | <allExpression> |\n                 <anyExpression>\n<deviceEncrypted> ::= { \"deviceEncrypted\": <boolean> }\n<deviceManaged> ::= { \"deviceManaged\": <boolean> }\n<ipAddressIn> ::= { \"ipAddressIn\": [ <objectId>, ... ] }\n<locationIn> ::= { \"locationIn\": {\n                     \"countries\": [\n                       <iso_3166_country_code>, ...\n                     ]\n                   }\n                 }\n<notExpression> ::= { \"not\": <expression> }\n<allExpression> ::= { \"all\": [ <expression>, ... ] }\n<anyExpression> ::= { \"any\": [ <expression>, ... ] }\n```\n\nFor example, to add a condition that applies to IP addresses in a given list, the following condition can be added:\n\n```\n{\"ipAddressIn\": [ <ip_list_object_id> ]}\n```\n\nIf you would rather exclude IP addresses in the given lists, the following condition could be added:\n\n```\n{\n  \"not\": {\n    \"ipAddressIn\": [ <ip_list_object_id_1>, <ip_list_object_id_2> ]\n  }\n}\n```\n\nYou may also include more than one condition and choose whether \"all\" or \"any\" of them must be met for the policy to apply:\n\n```\n{\n  \"all\": [\n    {\n      \"ipAddressIn\": [ <ip_list_object_id>, ... ]\n    },\n    {\n      \"deviceManaged\": true\n    },\n    {\n      \"locationIn\": {\n        countries: [ <iso_3166_country_code>, ... ]\n      }\n    }\n  ]\n}\n```"
    },
    "description": {
      "type": "string"
    }
  },
  "description": "This represents an authentication policy.  See the details of each field for valid values and restrictions."
}
object AuthnPolicyEffect
{
  "type": "object",
  "title": "AuthnPolicyEffect",
  "required": [
    "action"
  ],
  "properties": {
    "action": {
      "enum": [
        "allow",
        "deny",
        "unknown"
      ],
      "type": "string"
    },
    "obligations": {
      "$ref": "#/components/schemas/AuthnPolicyObligations"
    }
  },
  "x-examples": {
    "example-deny": {
      "action": "deny"
    },
    "example-allow": {
      "action": "allow"
    },
    "example-allow-with-mfa": {
      "action": "allow",
      "obligations": {
        "mfa": {
          "required": true
        }
      }
    }
  }
}
object AuthnPolicyObligations
{
  "type": "object",
  "title": "AuthnPolicyObligations",
  "properties": {
    "mfa": {
      "type": "object",
      "properties": {
        "required": {
          "type": "boolean"
        }
      }
    },
    "userVerification": {
      "type": "object",
      "properties": {
        "requirement": {
          "enum": [
            "none",
            "optional",
            "required"
          ],
          "type": "string"
        }
      }
    }
  }
}
object AuthnPolicyResourceTarget
{
  "type": "object",
  "title": "AuthnPolicyResourceTarget",
  "required": [
    "type"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Object ID of the resource target. If undefined, then all resources of the given type are targeted."
    },
    "type": {
      "enum": [
        "user_portal",
        "application",
        "ldap"
      ],
      "type": "string"
    }
  }
}
object AuthnPolicyTargets
{
  "type": "object",
  "title": "AuthnPolicyTargets",
  "properties": {
    "users": {
      "$ref": "#/components/schemas/AuthnPolicyUserTarget"
    },
    "resources": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/AuthnPolicyResourceTarget"
      }
    },
    "userGroups": {
      "$ref": "#/components/schemas/AuthnPolicyUserGroupTarget"
    },
    "userAttributes": {
      "$ref": "#/components/schemas/AuthnPolicyUserAttributeTarget"
    }
  }
}
string AuthnPolicyType
{
  "enum": [
    "user_portal",
    "application",
    "ldap"
  ],
  "type": "string",
  "title": "AuthnPolicyType",
  "default": "user_portal"
}
object AuthnPolicyUserAttributeFilter
{
  "type": "object",
  "title": "AuthnPolicyUserAttributeFilter",
  "properties": {
    "field": {
      "type": "string",
      "description": "The only field that is currently supported is ldap_binding_user"
    },
    "value": {
      "$ref": "#/components/schemas/AnyValue"
    },
    "operator": {
      "enum": [
        "EQ"
      ],
      "type": "string"
    }
  }
}
object AuthnPolicyUserAttributeTarget
{
  "type": "object",
  "title": "AuthnPolicyUserAttributeTarget",
  "properties": {
    "exclusions": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/AuthnPolicyUserAttributeFilter"
      }
    },
    "inclusions": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/AuthnPolicyUserAttributeFilter"
      }
    }
  },
  "description": "User attribute targets are currently only supported for LDAP policies."
}
object AuthnPolicyUserGroupTarget
{
  "type": "object",
  "title": "AuthnPolicyUserGroupTarget",
  "properties": {
    "exclusions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "inclusions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}
object AuthnPolicyUserTarget
{
  "type": "object",
  "title": "AuthnPolicyUserTarget",
  "properties": {
    "inclusions": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

Versions

Version Endpoints Schemas Ingested Status
2.0 416 669 2026-05-11 current
2.0 416 669 2026-04-20
2.0 416 669 2026-04-20
2.0 416 669 2026-04-16