/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
/bulk/userstates/{id}
This endpoint deletes a scheduled statechange job.
curl -X DELETE "https://console.jumpcloud.com/api/v2/bulk/userstates/{ScheduledJob_ID}" \
-H 'x-api-key: {API_KEY}' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| id | path | required | string | Unique identifier of the scheduled statechange job. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
No Content
DELETE /bulk/userstates/{id}
/commandqueue/{workflow_instance_id}
This endpoint allows all queued commands for one workflow instance to be canceled.
curl -X DELETE https://console.jumpcloud.com/api/v2/commandqueue/{workflow_instance_id} \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| workflow_instance_id | path | required | string | Workflow instance Id of the queued commands to cancel. |
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
OK
DELETE /commandqueue/{workflow_instance_id}
/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
/customemail/templates
Get the list of custom email templates
OK
GET /customemail/templates
/customemails
Create the custom email configuration for the specified custom email type.
This action is only available to paying customers.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
application/json
CustomEmail
| Property | Type | Required |
|---|---|---|
| id | string | optional |
| body | string | optional |
| type | string | required |
| title | string | optional |
| button | string | optional |
| header | string | optional |
| subject | string | required |
| nextStepContactInfo | string | optional |
OK
POST /customemails
/customemails/{custom_email_type}
Delete 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. |
No Content
DELETE /customemails/{custom_email_type}
/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}
/customemails/{custom_email_type}
Update the custom email configuration for the specified custom email type.
This action is only available to paying customers.
| 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. |
application/json
CustomEmail
| Property | Type | Required |
|---|---|---|
| id | string | optional |
| body | string | optional |
| type | string | required |
| title | string | optional |
| button | string | optional |
| header | string | optional |
| subject | string | required |
| nextStepContactInfo | string | optional |
OK
PUT /customemails/{custom_email_type}
/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
Registers a Duo account for an organization. Only one Duo account will be allowed,
in case an organization has a Duo account already a 409 (Conflict) code will be returned.
curl -X POST https://console.jumpcloud.com/api/v2/duo/accounts \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'x-api-key: {API_KEY}' \
-d '{}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| x-org-id | header | optional | string | Organization identifier that can be obtained from console settings. |
POST /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
Creates a Duo application for your organization and the specified account.
curl -X POST 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}' \
-d '{
"name": "Application Name",
"apiHost": "api-1234.duosecurity.com",
"integrationKey": "1234",
"secretKey": "5678"
}'
| 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. |
application/json
DuoApplicationReq
| Property | Type | Required |
|---|---|---|
| name | string | required |
| apiHost | string | required |
| secretKey | string | required |
| integrationKey | string | required |
POST /duo/accounts/{account_id}/applications
/duo/accounts/{account_id}/applications/{application_id}
Deletes the specified Duo application, an error will be returned if the application is used in a protected resource.
curl -X DELETE 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. |
DELETE /duo/accounts/{account_id}/applications/{application_id}
/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/{account_id}/applications/{application_id}
Updates the specified Duo application.
curl -X PUT 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}' \
-d '{
"name": "Application Name",
"apiHost": "api-1234.duosecurity.com",
"integrationKey": "1234",
"secretKey": "5678"
}'
| 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. |
application/json
DuoApplicationUpdateReq
| Property | Type | Required |
|---|---|---|
| name | string | required |
| apiHost | string | required |
| secretKey | string | optional |
| integrationKey | string | required |
PUT /duo/accounts/{account_id}/applications/{application_id}
/duo/accounts/{id}
Removes the specified Duo account, an error will be returned if the account has some Duo application used in a protected resource.
curl -X DELETE 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. |
DELETE /duo/accounts/{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}/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}/domains
Add a domain to a specific Google Workspace directory sync integration instance. The domain must be a verified domain in Google Workspace.
curl -X POST 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}' \
-d '{"domain": "{domain name}"}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| gsuite_id | path | required | string | Id for the specific Google Workspace directory sync integration instance. |
| domain | query | optional | string | — |
An unexpected error response.
A successful response.
Created
Unauthorized
Forbidden
Not Found
Conflict
Internal Server Error
POST /gsuites/{gsuite_id}/domains
/gsuites/{gsuite_id}/domains/{domainId}
Delete a domain from a specific Google Workspace directory sync integration instance.
curl -X DELETE https://console.jumpcloud.com/api/v2/gsuites/{gsuite_id}/domains/{domainId} \
-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. |
| domainId | path | required | string | Id for the domain. |
An unexpected error response.
OK
Unauthorized
Forbidden
Not Found
Internal Server Error
DELETE /gsuites/{gsuite_id}/domains/{domainId}
/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/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}/import/schedules
Endpoint to create a scheduled job 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.
A successful response.
Created
Unauthorized
Forbidden
Not Found
Internal Server Error
POST /gsuites/{gsuite_id}/import/schedules
/gsuites/{gsuite_id}/import/schedules/{scheduledJobId}
Endpoint to delete the specified scheduled job from gapps and kala.
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| gsuite_id | path | required | string | ObjectID of the Google Workspace integration |
| scheduledJobId | path | required | string | ObjectID of the Scheduled Job |
An unexpected error response.
A successful response.
No Content
Unauthorized
Forbidden
Not Found
Internal Server Error
DELETE /gsuites/{gsuite_id}/import/schedules/{scheduledJobId}
/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}/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
This endpoint allows you to create a translation rule for a specific G Suite instance. These rules specify how JumpCloud attributes translate to G Suite Admin SDK attributes.
curl -X POST 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}' \
-d '{
{Translation Rule Parameters}
}'
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| gsuite_id | path | required | string | — |
application/json
GSuiteTranslationRuleRequest
| Property | Type | Required |
|---|---|---|
| builtIn | string | optional |
| direction | string | optional |
POST /gsuites/{gsuite_id}/translationrules
/gsuites/{gsuite_id}/translationrules/{id}
This endpoint allows you to delete a translation rule for a specific G Suite instance. These rules specify how JumpCloud attributes translate to G Suite Admin SDK attributes.
curl -X DELETE 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 | — |
DELETE /gsuites/{gsuite_id}/translationrules/{id}
/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}
/gsuites/{id}
This endpoint allows updating some attributes of a G Suite.
curl -X PATCH https://console.jumpcloud.com/api/v2/gsuites/{GSUITE_ID} \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-d '{
"userLockoutAction": "suspend",
"userPasswordExpirationAction": "maintain"
}'
Sample Request, set a default domain
curl -X PATCH https://console.jumpcloud.com/api/v2/gsuites/{GSUITE_ID} \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-d '{
"defaultDomain": {
"id": "{domainObjectID}"
}
}'
Sample Request, unset the default domain
curl -X PATCH https://console.jumpcloud.com/api/v2/gsuites/{GSUITE_ID} \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-d '{
"defaultDomain": {}
}'
| 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. |
application/json
gsuite
| Property | Type | Required |
|---|---|---|
| id | string | optional |
| name | string | optional |
| defaultDomain | object | optional |
| └ id | string | optional |
| └ domain | string | optional |
| groupsEnabled | boolean | optional |
| userLockoutAction | string | optional |
| userPasswordExpirationAction | string | optional |
PATCH /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}/erase-device
Removes the work profile and all policies from a personal/company-owned Android 8.0+ device. Company owned devices will be relinquished for personal use. Apps and data associated with the personal profile(s) are preserved.
curl -X POST https://console.jumpcloud.com/api/v2/google-emm/devices/{deviceId}/erase-device \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| deviceId | path | required | string | — |
application/json
DevicesEraseDeviceRequest
A successful response.
POST /google-emm/devices/{deviceId}/erase-device
/google-emm/devices/{deviceId}/lock
Locks a Google EMM enrolled device, as if the lock screen timeout had expired.
curl -X POST https://console.jumpcloud.com/api/v2/google-emm/devices/{deviceId}/lock \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| deviceId | path | required | string | — |
application/json
DevicesEraseDeviceRequest
A successful response.
POST /google-emm/devices/{deviceId}/lock
/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/devices/{deviceId}/reboot
Reboots a Google EMM enrolled device. Only supported on fully managed devices running Android 7.0 or higher.
curl -X POST https://console.jumpcloud.com/api/v2/google-emm/devices/{deviceId}/reboot \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| deviceId | path | required | string | — |
application/json
DevicesEraseDeviceRequest
A successful response.
POST /google-emm/devices/{deviceId}/reboot
/google-emm/devices/{deviceId}/resetpassword
Reset the user’s password of a Google EMM enrolled device.
curl -X POST https://console.jumpcloud.com/api/v2/google-emm/devices/{deviceId}/resetpassword \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-d '{ 'new_password' : 'string' }' \
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| deviceId | path | required | string | — |
application/json
DevicesResetPasswordRequest
| Property | Type | Required |
|---|---|---|
| flags | array | optional |
| newPassword | string | optional |
A successful response.
POST /google-emm/devices/{deviceId}/resetpassword
/google-emm/enrollment-tokens
Gets an enrollment token to enroll a device into Google EMM.
curl -X POST https://console.jumpcloud.com/api/v2/google-emm/enrollment-tokens \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
application/json
jumpcloud.google_emm.CreateEnrollmentTokenRequest
| Property | Type | Required |
|---|---|---|
| duration | string | optional |
| zeroTouch | boolean | optional |
| displayName | string | optional |
| oneTimeOnly | boolean | optional |
| createdWhere | string | optional |
| userObjectId | string | optional |
| enrollmentType | string | optional |
| allowPersonalUsage | string | optional |
| enterpriseObjectId | string | optional |
| provisioningExtras | object | optional |
| └ wifiSsid | string | optional |
| └ wifiPassword | string | optional |
| └ wifiSecurityType | string | optional |
| └ wifiHiddenNetwork | boolean | optional |
A successful response.
POST /google-emm/enrollment-tokens
/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
Creates a Google EMM enterprise.
curl -X POST https://console.jumpcloud.com/api/v2/google-emm/enterprises \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-d '{ 'signupUrlName': 'string', 'enrollmentToken': 'string' }' \
application/json
jumpcloud.google_emm.CreateEnterpriseRequest
| Property | Type | Required |
|---|---|---|
| signupUrlName | string | optional |
| enrollmentToken | string | optional |
A successful response.
POST /google-emm/enterprises
/google-emm/enterprises/{enterpriseId}
Removes a Google EMM enterprise.
Warning: This is a destructive operation and will remove all data associated with Google EMM enterprise from JumpCloud including devices and applications associated with the given enterprise.
curl -X DELETE https://console.jumpcloud.com/api/v2/google-emm/devices/{enterpriseId} \
-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.
DELETE /google-emm/enterprises/{enterpriseId}
/google-emm/enterprises/{enterpriseId}
Updates a Google EMM enterprise details.
curl -X PATCH https://console.jumpcloud.com/api/v2/google-emm/enterprises \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
-d '{ 'allowDeviceEnrollment': true, 'deviceGroupId': 'string' }' \
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| enterpriseId | path | required | string | — |
application/json
EnterprisesPatchEnterpriseRequest
| Property | Type | Required |
|---|---|---|
| deviceGroupId | string | optional |
| allowDeviceEnrollment | boolean | optional |
A successful response.
PATCH /google-emm/enterprises/{enterpriseId}
/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/{enterpriseId}/enrollment-tokens/{tokenId}
Removes an Enrollment token for a given enterprise and token id.
curl -X DELETE https://console.jumpcloud.com/api/v2/enterprises/{enterprise_id}/enrollment-tokens/{token_id} \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'x-api-key: {API_KEY}' \
| Name | In | Required | Type | Description |
|---|---|---|---|---|
| enterpriseId | path | required | string | — |
| tokenId | path | required | string | — |
A successful response.
DELETE /google-emm/enterprises/{enterpriseId}/enrollment-tokens/{tokenId}
/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
/google-emm/enterprises/{enterpriseObjectId}/enrollment-tokens
Gets an enrollment token to enroll a device into Google EMM.
curl -X POST https://console.jumpcloud.com/api/v2/google-emm/enterpries/{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 | — |
application/json
EnrollmentTokensCreateEnterprisesEnrollmentTokenRequest
| Property | Type | Required |
|---|---|---|
| duration | string | optional |
| zeroTouch | boolean | optional |
| displayName | string | optional |
| oneTimeOnly | boolean | optional |
| createdWhere | string | optional |
| userObjectId | string | optional |
| enrollmentType | string | optional |
| allowPersonalUsage | string | optional |
| provisioningExtras | object | optional |
| └ wifiSsid | string | optional |
| └ wifiPassword | string | optional |
| └ wifiSecurityType | string | optional |
| └ wifiHiddenNetwork | boolean | optional |
A successful response.
POST /google-emm/enterprises/{enterpriseObjectId}/enrollment-tokens