Query structured spec data via REST or MCP. Get exactly what your agent needs.
https://console.jumpcloud.com/api/v2
/activedirectories
This endpoint allows you to list all your Active Directory Instances.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
GET /activedirectories
/activedirectories/{activedirectory_id}/agents
This endpoint allows you to list all your Active Directory Agents for a given Instance.
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}'
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
GET /activedirectories/{activedirectory_id}/agents
/activedirectories/{activedirectory_id}/agents/{agent_id}
This endpoint returns an Active Directory agent.
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}'
| 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. |
GET /activedirectories/{activedirectory_id}/agents/{agent_id}
/activedirectories/{id}
This endpoint returns a specific Active Directory.
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}'
| 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. |
GET /activedirectories/{id}
/administrators/{id}/organizationlinks
This endpoint returns the association links between an Administrator and Organizations.
| 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. |
OK
GET /administrators/{id}/organizationlinks
/organizations/{id}/administratorlinks
This endpoint returns the association links between an Organization and Administrators.
| 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. |
GET /organizations/{id}/administratorlinks
/systems/{systemObjectId}/aggregated-policy-stats
Gets the aggregated policy stats for a system.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| systemObjectId | path | required | string | — |
| organizationObjectId | query | optional | string | — |
An unexpected error response.
A successful response.
GET /systems/{systemObjectId}/aggregated-policy-stats
/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.
curl https://console.jumpcloud.com/api/v2/applemdms \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
GET /applemdms
/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.
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}'
| 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. |
GET /applemdms/{apple_mdm_id}/csr
/applemdms/{apple_mdm_id}/depkey
Retrieves an Apple MDM DEP Public Key.
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}'
| 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. |
GET /applemdms/{apple_mdm_id}/depkey
/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
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 '{}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| sort | query | optional | array | The comma separated fields used to sort the collection. |
| x-total-count | header | optional | integer | — |
OK
GET /applemdms/{apple_mdm_id}/devices
/applemdms/{apple_mdm_id}/devices/{device_id}
Gets a single Apple MDM device.
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}'
| 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 | — |
OK
GET /applemdms/{apple_mdm_id}/devices/{device_id}
/applemdms/{apple_mdm_id}/enrollmentprofiles
Get a list of enrollment profiles for an apple mdm.
Note: currently only one enrollment profile is supported.
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}'
| 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. |
GET /applemdms/{apple_mdm_id}/enrollmentprofiles
/applemdms/{apple_mdm_id}/enrollmentprofiles/{id}
Get an enrollment profile
Currently only requesting the mobileconfig is supported.
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}'
| 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. |
GET /applemdms/{apple_mdm_id}/enrollmentprofiles/{id}
/applications/{application_id}
The endpoint retrieves an Application.
| 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. |
OK
GET /applications/{application_id}
/applications/{application_id}/import/users
Get a list of users to import from an Application IdM service provider.
| 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. |
OK
GET /applications/{application_id}/import/users
/authn/policies
Get a list of all authentication policies.
curl https://console.jumpcloud.com/api/v2/authn/policies \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| sort | query | optional | array | The comma separated fields used to sort the collection. |
OK
GET /authn/policies
/authn/policies/{id}
Return a specific authentication policy.
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}'
| 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. |
OK
GET /authn/policies/{id}
/bulk/users/{job_id}/results
This endpoint will return the results of particular user import or update job 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}'
| 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. |
GET /bulk/users/{job_id}/results
/bulk/userstates
The endpoint allows you to list scheduled statechange jobs.
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'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /bulk/userstates
/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.
| 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. |
OK
GET /bulk/userstates/eventlist/next
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| skip | query | optional | integer | The offset into the records to return. |
| sort | query | optional | array | The comma separated fields used to sort the collection. |
| search | query | optional | string | The search string to query records |
OK
GET /queuedcommand/workflows
/customemails/{custom_email_type}
Get the custom email configuration for the specified custom email type
| 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. |
OK
GET /customemails/{custom_email_type}
/customemail/templates
Get the list of custom email templates
OK
GET /customemail/templates
/directories
This endpoint returns all active directories (LDAP, O365 Suite, G-Suite).
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| 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. |
| 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. |
Unexpected error
OK
GET /directories
/duo/accounts
This endpoint returns all the Duo accounts for your organization. Note: There can currently only be one Duo account for your organization.
curl https://console.jumpcloud.com/api/v2/duo/accounts \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
GET /duo/accounts
/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.
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}'
| 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. |
GET /duo/accounts/{account_id}/applications
/duo/accounts/{account_id}/applications/{application_id}
This endpoint returns a specific Duo application that is associated with the specified Duo account.
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}'
| 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. |
GET /duo/accounts/{account_id}/applications/{application_id}
/duo/accounts/{id}
This endpoint returns a specific Duo account.
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}'
| 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. |
GET /duo/accounts/{id}
/featureTrials/{feature_code}
This endpoint get’s the current state of a feature trial for an org.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| feature_code | path | required | string | — |
OK
GET /featureTrials/{feature_code}
/gsuites/{gsuite_id}/import/jumpcloudusers
Lists available G Suite users for import, translated to the Jumpcloud user schema.
| 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. |
OK
GET /gsuites/{gsuite_id}/import/jumpcloudusers
/gsuites/{gsuite_id}/import/users
Lists G Suite users available for import.
| 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. |
OK
GET /gsuites/{gsuite_id}/import/users
/gsuites/{gsuite_id}/domains
List the domains configured for a specific Google Workspace directory sync integration instance.
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}'
| 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. |
An unexpected error response.
OK
Unauthorized
Forbidden
Not Found
Internal Server Error
GET /gsuites/{gsuite_id}/domains
/gsuites/{gsuite_id}/import/schedules
Endpoint to list scheduled jobs for specified Google Workspace integration.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| gsuite_id | path | required | string | ObjectID of the Google Workspace integration |
An unexpected error response.
OK
Unauthorized
Forbidden
Not Found
Internal Server Error
GET /gsuites/{gsuite_id}/import/schedules
/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.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| gsuite_id | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
GET /gsuites/{gsuite_id}/translationrules
/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.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| gsuite_id | path | required | string | — |
| id | path | required | string | — |
GET /gsuites/{gsuite_id}/translationrules/{id}
/gsuites/{id}
This endpoint returns a specific G Suite.
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}'
| 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. |
GET /gsuites/{id}
/google-emm/devices/{deviceId}
Gets a Google EMM enrolled device details.
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}' \
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| deviceId | path | required | string | — |
A successful response.
GET /google-emm/devices/{deviceId}
/google-emm/devices/{deviceId}/policy_results
Gets an android JSON policy for a Google EMM enrolled device.
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}' \
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| deviceId | path | required | string | — |
A successful response.
GET /google-emm/devices/{deviceId}/policy_results
/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.
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}' \
| 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. |
A successful response.
GET /google-emm/enterprises
/google-emm/enterprises/{enterpriseId}/connection-status
Gives a connection status between JumpCloud and Google.
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}' \
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| enterpriseId | path | required | string | — |
A successful response.
GET /google-emm/enterprises/{enterpriseId}/connection-status
/google-emm/enterprises/{enterpriseObjectId}/devices
Lists google EMM enrolled devices.
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}' \
| 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 | — |
A successful response.
GET /google-emm/enterprises/{enterpriseObjectId}/devices
/google-emm/enterprises/{enterpriseObjectId}/enrollment-tokens
Lists active, unexpired enrollement tokens for a given enterprise.
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}' \
| 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. |
A successful response.
GET /google-emm/enterprises/{enterpriseObjectId}/enrollment-tokens
/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.
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}'
| 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. |
GET /activedirectories/{activedirectory_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
GET /activedirectories/{activedirectory_id}/usergroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
GET /activedirectories/{activedirectory_id}/users
/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.
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}'
| 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. |
OK
GET /applications/{application_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /applications/{application_id}/usergroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /applications/{application_id}/users
/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.
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}'
| 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. |
OK
GET /commands/{command_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /commands/{command_id}/systemgroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /commands/{command_id}/systems
/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.
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}'
| 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. |
OK
GET /gsuites/{gsuite_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /gsuites/{gsuite_id}/usergroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /gsuites/{gsuite_id}/users
/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.
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}'
| 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. |
OK
GET /identity-provider/policies/{idp_routing_policy_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /identity-provider/policies/{idp_routing_policy_id}/associations/usergroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /identity-provider/policies/{idp_routing_policy_id}/associations/users
/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.
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}'
| 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. |
OK
GET /ldapservers/{ldapserver_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /ldapservers/{ldapserver_id}/usergroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /ldapservers/{ldapserver_id}/users
/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.
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}'
| 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. |
OK
GET /office365s/{office365_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /office365s/{office365_id}/usergroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /office365s/{office365_id}/users
/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.
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}'
| 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. |
OK
GET /policies/{policy_id}/associations
/policies/{policy_id}/memberof
This endpoint returns all the Policy Groups a Policy is a member of.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
GET /policies/{policy_id}/memberof
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /policies/{policy_id}/systemgroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /policies/{policy_id}/systems
/systems/{system_id}/policystatuses
This endpoint returns the policy results for a particular system.
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}'
| 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. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
GET /systems/{system_id}/policystatuses
/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.
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}'
| 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. |
OK
GET /policygroups/{group_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /policygroups/{group_id}/systemgroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /policygroups/{group_id}/systems
/policygroups/{group_id}/members
This endpoint returns the Policy members of a Policy Group.
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}'
| 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. |
OK
GET /policygroups/{group_id}/members
/policygroups/{group_id}/membership
This endpoint returns all Policy members that are a member of this Policy Group.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
GET /policygroups/{group_id}/membership
/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.
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}'
| 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. |
OK
GET /radiusservers/{radiusserver_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /radiusservers/{radiusserver_id}/usergroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /radiusservers/{radiusserver_id}/users
/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.
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}'
| 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. |
OK
GET /softwareapps/{software_app_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /softwareapps/{software_app_id}/systemgroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /softwareapps/{software_app_id}/systems
/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.
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}'
| 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. |
OK
GET /systemgroups/{group_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /systemgroups/{group_id}/policies
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /systemgroups/{group_id}/policygroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /systemgroups/{group_id}/usergroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /systemgroups/{group_id}/users
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| details | query | optional | string | This will provide detail descriptive response for the request. |
OK
GET /systemgroups/{group_id}/commands
/systemgroups/{group_id}/members
This endpoint returns the system members of a System Group.
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}'
| 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. |
OK
GET /systemgroups/{group_id}/members
/systemgroups/{group_id}/membership
This endpoint returns all Systems that are a member of this System Group.
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}'
| 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. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
GET /systemgroups/{group_id}/membership
/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.
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}'
| 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. |
OK
GET /systems/{system_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| details | query | optional | string | This will provide detail descriptive response for the request. |
OK
GET /systems/{system_id}/commands
/systems/{system_id}/memberof
This endpoint returns all the System Groups a System is a member of.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
GET /systems/{system_id}/memberof
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /systems/{system_id}/policies
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /systems/{system_id}/policygroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /systems/{system_id}/usergroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /systems/{system_id}/users
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
GET /usergroups/{group_id}/activedirectories
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /usergroups/{group_id}/applications
/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.
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}'
| 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. |
OK
GET /usergroups/{group_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /usergroups/{group_id}/directories
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /usergroups/{group_id}/gsuites
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /usergroups/{group_id}/ldapservers
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /usergroups/{group_id}/office365s
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /usergroups/{group_id}/radiusservers
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /usergroups/{group_id}/systemgroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /usergroups/{group_id}/systems
/usergroups/{group_id}/members
This endpoint returns the user members of a User Group.
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}'
| 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. |
OK
GET /usergroups/{group_id}/members
/usergroups/{group_id}/membership
This endpoint returns all users members that are a member of this User Group.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
GET /usergroups/{group_id}/membership
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
GET /users/{user_id}/activedirectories
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /users/{user_id}/applications
/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.
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}'
| 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. |
OK
GET /users/{user_id}/associations
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /users/{user_id}/directories
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /users/{user_id}/gsuites
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /users/{user_id}/ldapservers
/users/{user_id}/memberof
This endpoint returns all the User Groups a User is a member of.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
GET /users/{user_id}/memberof
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /users/{user_id}/office365s
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /users/{user_id}/radiusservers
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /users/{user_id}/systemgroups
/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.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /users/{user_id}/systems
/groups
This endpoint returns all Groups that exist in your organization.
namedisabledtype 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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| 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 |
Unexpected error
OK
GET /groups
/iplists
Retrieve all IP lists.
curl https://console.jumpcloud.com/api/v2/iplists \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| sort | query | optional | array | The comma separated fields used to sort the collection. |
OK
GET /iplists
/iplists/{id}
Return a specific IP list.
curl https://console.jumpcloud.com/api/v2/iplists/{id} \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | — |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
GET /iplists/{id}
/ldapservers
This endpoint returns the object IDs of your LDAP servers.
```
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}’
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
GET /ldapservers
/ldapservers/{id}
This endpoint returns a specific LDAP server.
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}'
| 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. |
GET /ldapservers/{id}
/logos/{id}
Return the logo image associated with the specified id
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | — |
OK
GET /logos/{id}
/office365s/{office365_id}/import/users
Lists Office 365 users available for import.
| 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. |
OK
GET /office365s/{office365_id}/import/users
/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}'
| 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. |
GET /office365s/{office365_id}
/office365s/{office365_id}/domains
List the domains configured for a specific M365/Azure AD directory sync integration instance.
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}'
| 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. |
An unexpected error response.
OK
GET /office365s/{office365_id}/domains
/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.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| office365_id | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
GET /office365s/{office365_id}/translationrules
/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.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| office365_id | path | required | string | — |
| id | path | required | string | — |
GET /office365s/{office365_id}/translationrules/{id}
/organizations/cases
This endpoint returns the cases (Support/Feature requests) for the organization
| 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. |
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /organizations/cases
/passwordmanager/devices
List Devices
| 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 | — |
An unexpected error response.
A successful response.
GET /passwordmanager/devices
/passwordmanager/devices/{UUID}
Get Device
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
An unexpected error response.
A successful response.
GET /passwordmanager/devices/{UUID}
/policies
This endpoint returns all policies.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
Unexpected error.
GET /policies
/policies/{id}
This endpoint returns a specific policy.
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}'
| 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. |
OK
GET /policies/{id}
/policies/{policy_id}/policyresults
This endpoint returns all policies results for a specific policy.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| policy_id | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
GET /policies/{policy_id}/policyresults
/policies/{policy_id}/policystatuses
This endpoint returns the latest policy results for a specific policy.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| policy_id | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
GET /policies/{policy_id}/policystatuses
/policyresults
This endpoint returns all policy results for an organization.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
GET /policyresults
/policyresults/{id}
This endpoint will return the policy results for a specific policy.
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}'
| 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. |
OK
GET /policyresults/{id}
/policygroups
This endpoint returns all Policy Groups.
Available filter fields:
namedisabledtypecurl -X GET https://console.jumpcloud.com/api/v2/policygroups \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
Unexpected error
OK
GET /policygroups
/policygroups/{id}
This endpoint returns the details of a Policy Group.
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}'
| 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. |
OK
GET /policygroups/{id}
/policytemplates
This endpoint returns all policy templates.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
Unexpected error.
GET /policytemplates
/policytemplates/{id}
This endpoint returns a specific policy template.
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}'
| 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. |
OK
GET /policytemplates/{id}
/providers/{provider_id}/billing/contract
Retrieve contract for a Provider
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
An unexpected error response.
OK
GET /providers/{provider_id}/billing/contract
/providers/{provider_id}/billing/details
Retrieve billing details for a Provider
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
An unexpected error response.
OK
GET /providers/{provider_id}/billing/details
/providers/{provider_id}/integrations
Retrieves a list of integrations this provider has configured. You must be associated to the provider to use this endpoint.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /providers/{provider_id}/integrations
/providers/{provider_id}/integrations/autotask/alerts/configuration
Get all Autotask ticketing alert configurations for a provider.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
OK
GET /providers/{provider_id}/integrations/autotask/alerts/configuration
/providers/{provider_id}/integrations/autotask/alerts/configuration/options
Get all Autotask ticketing alert configuration options for a provider.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
OK
GET /providers/{provider_id}/integrations/autotask/alerts/configuration/options
/providers/{provider_id}/integrations/connectwise/alerts/configuration
Get all ConnectWise ticketing alert configurations for a provider.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
OK
GET /providers/{provider_id}/integrations/connectwise/alerts/configuration
/providers/{provider_id}/integrations/connectwise/alerts/configuration/options
Get all ConnectWise ticketing alert configuration options for a provider.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
OK
GET /providers/{provider_id}/integrations/connectwise/alerts/configuration/options
/providers/{provider_id}/integrations/syncro/alerts/configuration
Get all Syncro ticketing alert configurations for a provider.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
OK
GET /providers/{provider_id}/integrations/syncro/alerts/configuration
/providers/{provider_id}/integrations/syncro/alerts/configuration/options
Get all Syncro ticketing alert configuration options for a provider.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
OK
GET /providers/{provider_id}/integrations/syncro/alerts/configuration/options
/providers/{provider_id}/integrations/ticketing/alerts
Get all ticketing alerts available for a provider’s ticketing integration.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
OK
GET /providers/{provider_id}/integrations/ticketing/alerts
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
OK
GET /integrations/autotask/{UUID}
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /integrations/autotask/{UUID}/companies
/integrations/autotask/{UUID}/companytypes
Retrieves a list of user defined company types from Autotask for the given Autotask id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
OK
GET /integrations/autotask/{UUID}/companytypes
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
GET /integrations/autotask/{UUID}/contracts
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
GET /integrations/autotask/{UUID}/contracts/fields
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
GET /integrations/autotask/{UUID}/contracts/services
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /integrations/autotask/{UUID}/mappings
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
OK
GET /integrations/autotask/{UUID}/settings
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
OK
GET /integrations/connectwise/{UUID}
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
GET /integrations/connectwise/{UUID}/agreements
/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.
| 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. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
GET /integrations/connectwise/{UUID}/agreements/{agreement_ID}/additions
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /integrations/connectwise/{UUID}/companies
/integrations/connectwise/{UUID}/companytypes
Retrieves a list of user defined company types from ConnectWise for the given ConnectWise id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
OK
GET /integrations/connectwise/{UUID}/companytypes
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /integrations/connectwise/{UUID}/mappings
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
OK
GET /integrations/connectwise/{UUID}/settings
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
OK
GET /integrations/syncro/{UUID}
/integrations/syncro/{UUID}/billing_mapping_configuration_options
Retrieves a list of dependencies for Syncro billing mappings.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /integrations/syncro/{UUID}/billing_mapping_configuration_options
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /integrations/syncro/{UUID}/companies
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /integrations/syncro/{UUID}/mappings
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
OK
GET /integrations/syncro/{UUID}/settings
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| UUID | path | required | string | — |
| integration_type | path | required | string | — |
OK
GET /integrations/{integration_type}/{UUID}/errors
/providers/{provider_id}
This endpoint returns details about a provider
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
GET /providers/{provider_id}
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| sortIgnoreCase | query | optional | array | The comma separated fields used to sort the collection, ignoring case. |
GET /providers/{provider_id}/administrators
/providers/{provider_id}/cases
This endpoint returns the cases (Support/Feature requests) for the provider
| 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. |
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /providers/{provider_id}/cases
/providers/{provider_id}/invoices
Retrieves a list of invoices for this provider. You must be associated to the provider to use this endpoint.
| 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. |
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /providers/{provider_id}/invoices
/providers/{provider_id}/invoices/{ID}
Retrieves an invoice for this provider. You must be associated to the provider to use this endpoint.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
| ID | path | required | string | — |
OK
GET /providers/{provider_id}/invoices/{ID}
/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.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| sortIgnoreCase | query | optional | array | The comma separated fields used to sort the collection, ignoring case. |
GET /providers/{provider_id}/organizations
/cases/metadata
This endpoint returns the metadata for cases
OK
GET /cases/metadata
/providers/{provider_id}/configuredpolicytemplates
Retrieves a list of Configured Policy Templates for this provider.
| 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. |
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /providers/{provider_id}/configuredpolicytemplates
/providers/{provider_id}/configuredpolicytemplates/{id}
Retrieves a Configured Policy Templates for this provider and Id.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
| id | path | required | string | — |
OK
GET /providers/{provider_id}/configuredpolicytemplates/{id}
/providers/{provider_id}/policygrouptemplates
Retrieves a list of Policy Group Templates for this provider.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
| fields | query | optional | array | The comma separated fields included in the returned records. |
| skip | query | optional | integer | The offset into the records to return. |
| sort | query | optional | array | The comma separated fields used to sort the collection. |
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /providers/{provider_id}/policygrouptemplates
/providers/{provider_id}/policygrouptemplates/{id}
Retrieves a Policy Group Template for this provider.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| provider_id | path | required | string | — |
| id | path | required | string | — |
OK
GET /providers/{provider_id}/policygrouptemplates/{id}
/providers/{provider_id}/policygrouptemplates/{id}/members
Retrieves a Policy Group Template’s Members.
| 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. |
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
OK
GET /providers/{provider_id}/policygrouptemplates/{id}/members
/pushendpoints/verifications/{verificationId}
Endpoint for retrieving a verification push notification status
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| verificationId | path | required | string | — |
An unexpected error response.
OK
Bad Request
Unauthorized
Forbidden
Too Many Requests
Internal Server Error
GET /pushendpoints/verifications/{verificationId}
/ldapservers/{ldapserver_id}/sambadomains
This endpoint returns all samba domains for an LDAP server.
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}'
| 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. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
GET /ldapservers/{ldapserver_id}/sambadomains
/ldapservers/{ldapserver_id}/sambadomains/{id}
This endpoint returns a specific samba domain for an LDAP server.
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}'
| 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. |
GET /ldapservers/{ldapserver_id}/sambadomains/{id}
/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.
$ 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}' \
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /softwareapps
/softwareapps/{id}
Retrieves a Software Application.
The optional isConfigEnabled and appConfiguration apple_vpp attributes are populated in this response.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | — |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
GET /softwareapps/{id}
/softwareapps/{software_app_id}/statuses
This endpoint allows you to get the status of the provided Software Application on associated JumpCloud systems.
$ 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}' \
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /softwareapps/{software_app_id}/statuses
/subscriptions
This endpoint returns all pricing & packaging subscriptions.
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}'
OK
GET /subscriptions
/systemgroups
This endpoint returns all System Groups.
Available filter fields:
namedisabledtypemembershipMethodcurl -X GET https://console.jumpcloud.com/api/v2/systemgroups \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
Unexpected error
OK
GET /systemgroups
/systemgroups/{group_id}/suggestions
This endpoint returns available suggestions for a given system group
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}'
| 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 |
OK
GET /systemgroups/{group_id}/suggestions
/systemgroups/{id}
This endpoint returns the details of a System Group.
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}'
| 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. |
OK
GET /systemgroups/{id}
/systeminsights/alf
Valid filter fields are system_id and global_state.
| 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: |
| skip | query | optional | integer | The offset into the records to return. |
| sort | query | optional | array | The comma separated fields used to sort the collection. |
| limit | query | optional | integer | — |
GET /systeminsights/alf
/systeminsights/alf_exceptions
Valid filter fields are system_id and state.
| 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: |
| skip | query | optional | integer | The offset into the records to return. |
| sort | query | optional | array | The comma separated fields used to sort the collection. |
| limit | query | optional | integer | — |
GET /systeminsights/alf_exceptions
/systeminsights/alf_explicit_auths
Valid filter fields are system_id and process.
| 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: |
| skip | query | optional | integer | The offset into the records to return. |
| sort | query | optional | array | The comma separated fields used to sort the collection. |
| limit | query | optional | integer | — |
GET /systeminsights/alf_explicit_auths
/systeminsights/appcompat_shims
Valid filter fields are system_id and enabled.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/appcompat_shims
/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.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/apps
/systeminsights/authorized_keys
Valid filter fields are system_id and uid.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/authorized_keys
/systeminsights/azure_instance_metadata
Valid filter fields are system_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/azure_instance_metadata
/systeminsights/azure_instance_tags
Valid filter fields are system_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/azure_instance_tags
/systeminsights/battery
Valid filter fields are system_id and health.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/battery
/systeminsights/bitlocker_info
Valid filter fields are system_id and protection_status.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/bitlocker_info
/systeminsights/browser_plugins
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/browser_plugins
/systeminsights/certificates
Valid filter fields are system_id and common_name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/certificates
/systeminsights/chassis_info
Valid filter fields are system_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/chassis_info
/systeminsights/chrome_extensions
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/chrome_extensions
/systeminsights/connectivity
The only valid filter field is system_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/connectivity
/systeminsights/crashes
Valid filter fields are system_id and identifier.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/crashes
/systeminsights/cups_destinations
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/cups_destinations
/systeminsights/disk_encryption
Valid filter fields are system_id and encryption_status.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/disk_encryption
/systeminsights/disk_info
Valid filter fields are system_id and disk_index.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/disk_info
/systeminsights/dns_resolvers
Valid filter fields are system_id and type.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/dns_resolvers
/systeminsights/etc_hosts
Valid filter fields are system_id and address.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/etc_hosts
/systeminsights/firefox_addons
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/firefox_addons
/systeminsights/groups
Valid filter fields are system_id and groupname.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/groups
/systeminsights/ie_extensions
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/ie_extensions
/systeminsights/interface_addresses
Valid filter fields are system_id and address.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/interface_addresses
/systeminsights/interface_details
Valid filter fields are system_id and interface.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/interface_details
/systeminsights/kernel_info
Valid filter fields are system_id and version.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/kernel_info
/systeminsights/launchd
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/launchd
/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.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/linux_packages
/systeminsights/logged_in_users
Valid filter fields are system_id and user.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/logged_in_users
/systeminsights/logical_drives
Valid filter fields are system_id and device_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/logical_drives
/systeminsights/managed_policies
Valid filter fields are system_id and domain.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/managed_policies
/systeminsights/mounts
Valid filter fields are system_id and path.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/mounts
/systeminsights/os_version
Valid filter fields are system_id and version.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/os_version
/systeminsights/patches
Valid filter fields are system_id and hotfix_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/patches
/systeminsights/programs
Lists all programs for Windows devices. For macOS devices, use List System Insights Apps.
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/programs
/systeminsights/python_packages
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/python_packages
/systeminsights/safari_extensions
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/safari_extensions
/systeminsights/scheduled_tasks
Valid filter fields are system_id and enabled.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/scheduled_tasks
/systeminsights/secureboot
Valid filter fields are system_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/secureboot
/systeminsights/services
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/services
/systeminsights/shadow
Valid filter fields are system_id and username.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/shadow
/systeminsights/shared_folders
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/shared_folders
/systeminsights/shared_resources
Valid filter fields are system_id and type.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/shared_resources
/systeminsights/sharing_preferences
Only valid filed field is system_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/sharing_preferences
/systeminsights/sip_config
Valid filter fields are system_id and enabled.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/sip_config
/systeminsights/startup_items
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/startup_items
/systeminsights/system_controls
Valid filter fields are system_id and name.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/system_controls
/systeminsights/system_info
Valid filter fields are system_id and cpu_subtype.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/system_info
/systeminsights/tpm_info
Valid filter fields are system_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/tpm_info
/systeminsights/uptime
Valid filter fields are system_id and days.
| 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. |
| filter | query | optional | array | Supported operators are: eq, gte, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/uptime
/systeminsights/usb_devices
Valid filter fields are system_id and model.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/usb_devices
/systeminsights/user_groups
Only valid filter field is system_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/user_groups
/systeminsights/user_ssh_keys
Valid filter fields are system_id and uid.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| limit | query | optional | integer | — |
GET /systeminsights/user_ssh_keys
/systeminsights/userassist
Valid filter fields are system_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/userassist
/systeminsights/users
Valid filter fields are system_id and username.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/users
/systeminsights/wifi_networks
Valid filter fields are system_id and security_type.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/wifi_networks
/systeminsights/wifi_status
Valid filter fields are system_id and security_type.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/wifi_status
/systeminsights/windows_security_center
Valid filter fields are system_id.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/windows_security_center
/systeminsights/windows_security_products
Valid filter fields are system_id and state.
| 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. |
| filter | query | optional | array | Supported operators are: eq, in. e.g: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
| limit | query | optional | integer | — |
GET /systeminsights/windows_security_products
/systems/{system_id}/softwareappstatuses
This endpoint returns all the statuses of the associated Software Applications from the provided JumpCloud system ID.
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}'
| 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 = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
OK
GET /systems/{system_id}/softwareappstatuses
/accessrequests/{accessId}
Endpoint for getting all access requests by access id
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| accessId | path | required | string | — |
An unexpected error response.
A successful response.
GET /accessrequests/{accessId}
/systems/{system_id}/fdekey
This endpoint will return the current (latest) fde key saved for a system.
| 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. |
GET /systems/{system_id}/fdekey
/devices/settings/defaultpasswordsync
Gets the Default Password Sync Setting for an Organization.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| organizationObjectId | query | optional | string | — |
An unexpected error response.
Setting successfully retrieved.
Bad Request
Unauthorized
Forbidden
Not Found
Internal Server Error
GET /devices/settings/defaultpasswordsync
/devices/settings/signinwithjumpcloud
Gets the Sign In with JumpCloud Settings for an Organization.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| organizationObjectId | query | optional | string | — |
An unexpected error response.
Settings successfully retrieved.
Bad Request
Unauthorized
Forbidden
Not Found
Internal Server Error
GET /devices/settings/signinwithjumpcloud
/usergroups
This endpoint returns all User Groups.
Available filter fields:
namedisabledtypemembershipMethodsuggestionCounts.addsuggestionCounts.removesuggestionCounts.totalattributes.sudo.enabledattributes.sudo.withoutPasswordcurl -X GET https://console.jumpcloud.com/api/v2/usergroups \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
Unexpected error
OK
GET /usergroups
/usergroups/{group_id}/suggestions
This endpoint returns available suggestions for a given group
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}'
| 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 |
OK
GET /usergroups/{group_id}/suggestions
/usergroups/{id}
This endpoint returns the details of a User Group.
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}'
| 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. |
OK
GET /usergroups/{id}
/users/{user_id}/pushendpoints
This endpoint returns the list of push endpoints associated with a user.
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}'
| 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. |
OK
GET /users/{user_id}/pushendpoints
/users/{user_id}/pushendpoints/{push_endpoint_id}
This endpoint will retrieve a push endpoint associated with a user.
| 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. |
OK
GET /users/{user_id}/pushendpoints/{push_endpoint_id}
/workdays
This endpoint will return all the available information about all your instances of Workday.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| fields | query | optional | array | The comma separated fields included in the returned records. |
| 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. |
| filter | query | optional | array | A filter to apply to the query. Filter structure: field = Populate with a valid field from an endpoint response. operator = Supported operators are: eq, ne, gt, ge, lt, le, between, search, in. value = Populate with the value you want to search for. Is case sensitive. Supports wild cards. EX: |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
GET /workdays
/workdays/{id}
This endpoint will return all the available information about an instance of Workday.
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}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | — |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
GET /workdays/{id}
/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.
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}'
| 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. |
GET /workdays/{id}/import/{job_id}/results
/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.
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}'
| 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. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
GET /workdays/{workday_id}/workers
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."
}
}
}
ADES
{
"type": "object",
"title": "ADES",
"properties": {
"ios": {
"$ref": "#/components/schemas/ADE"
},
"macos": {
"$ref": "#/components/schemas/ADE"
}
}
}
AccessRequestApiRevokeAccessRequestResponse
{
"type": "object",
"example": {},
"properties": {}
}
AccessRequestApiUpdateAccessRequestRequest
{
"type": "object",
"properties": {
"expiry": {
"type": "string",
"format": "date-time"
},
"remarks": {
"type": "string"
},
"additionalAttributes": {
"type": "object"
},
"organizationObjectId": {
"type": "string",
"format": "byte"
}
}
}
AccessRequestApiUpdateAccessRequestResponse
{
"type": "object",
"example": {},
"properties": {}
}
ActivedirectoriesAgentsListResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/active-directory-agent-list"
}
}
ActivedirectoriesListResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/active-directory"
}
}
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
}
}
}
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"
}
}
}
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"
}
}
}
AdministratorOrganizationLinkReq
{
"type": "object",
"title": "AdministratorOrganizationLinkReq",
"example": {
"organization": "6230a0d26a4e4bc86c6b36f1"
},
"properties": {
"organization": {
"type": "string",
"description": "The identifier for an organization to link this administrator to."
}
}
}
AdministratorOrganizationsListByAdministratorResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/AdministratorOrganizationLink"
}
}
AdministratorOrganizationsListByOrganizationResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/AdministratorOrganizationLink"
}
}
AnyValue
{
"description": "Can be any value - string, number, boolean, array or 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."
}
}
}
ApplemdmsDevicesClearActivationLock500Response
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDevicesClearActivationLockResponse
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDevicesOsUpdateStatusResponse
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDevicesRefreshActivationLockInformation500Response
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDevicesRefreshActivationLockInformationResponse
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDevicesScheduleOsUpdateResponse
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDeviceserase500Response
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDeviceseraseRequest
{
"type": "object",
"properties": {
"pin": {
"type": "string",
"example": "123456",
"pattern": "^[0-9]{6}$",
"description": "6-digit PIN, required for MacOS, to erase the device"
}
}
}
ApplemdmsDeviceseraseResponse
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDeviceslistResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/apple-mdm-device"
}
}
ApplemdmsDeviceslock500Response
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDeviceslockRequest
{
"type": "object",
"properties": {
"pin": {
"type": "string",
"example": "123456",
"pattern": "^[0-9]{6}$",
"description": "6-digit PIN, required for MacOS, to lock the device"
}
}
}
ApplemdmsDeviceslockResponse
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDevicesrestart500Response
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDevicesrestartRequest
{
"type": "object",
"properties": {
"kextPaths": {
"type": "array",
"items": {
"type": "string"
},
"description": "The string to pass when doing a restart and performing a RebuildKernelCache."
}
}
}
ApplemdmsDevicesrestartResponse
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDevicesshutdown500Response
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsDevicesshutdownResponse
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsEnrollmentprofileslistResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/AppleMDM"
}
}
ApplemdmsListResponse
{
"type": "array",
"items": {
"$ref": "#/components/schemas/AppleMDM"
}
}
ApplemdmsRefreshdepdevices500Response
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplemdmsRefreshdepdevicesResponse
{
"type": "object",
"properties": {
"message": {
"type": "string"
}
}
}
ApplicationsGetResponse
{
"type": "object",
"example": {},
"properties": {}
}
ApplicationsPostLogoRequest
{
"type": "object",
"properties": {
"image": {
"type": "string",
"format": "binary",
"description": "The file to upload."
}
}
}
Apps
{
"type": "array",
"items": {
"type": "object",
"properties": {
"osId": {
"type": "integer",
"format": "int32",
"example": 1
},
"appVersion": {
"type": "string",
"example": "1.1.1"
}
}
}
}
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."
}
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
}
}
}
}
}
AuthnPolicyObligations
{
"type": "object",
"title": "AuthnPolicyObligations",
"properties": {
"mfa": {
"type": "object",
"properties": {
"required": {
"type": "boolean"
}
}
},
"userVerification": {
"type": "object",
"properties": {
"requirement": {
"enum": [
"none",
"optional",
"required"
],
"type": "string"
}
}
}
}
}
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"
}
}
}
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"
}
}
}
AuthnPolicyType
{
"enum": [
"user_portal",
"application",
"ldap"
],
"type": "string",
"title": "AuthnPolicyType",
"default": "user_portal"
}
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"
}
}
}
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."
}
AuthnPolicyUserGroupTarget
{
"type": "object",
"title": "AuthnPolicyUserGroupTarget",
"properties": {
"exclusions": {
"type": "array",
"items": {
"type": "string"
}
},
"inclusions": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
AuthnPolicyUserTarget
{
"type": "object",
"title": "AuthnPolicyUserTarget",
"properties": {
"inclusions": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
| 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 |