--- updatedAt: 2026-06-15T13:51:20.000Z agentTools: siteIndex: https://developer.jamf.com/llms.txt projectIndex: https://developer.jamf.com/jamf-pro/llms.txt --- # Edit Enrollment messaging for a language Edit enrollment messaging for a language. > 📋 **Required privilege:** Update User-Initiated Enrollment # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Jamf Pro API", "termsOfService": "https://www.jamf.com/developer-resources/api-license-agreement", "version": "11.32.0" }, "servers": [ { "url": "https://yourServer.jamfcloud.com/api" } ], "x-readme": { "samples-languages": [ "curl", "swift", "ruby", "python" ], "explorer-enabled": false }, "security": [ { "Bearer": [] }, { "ApiClient": [] }, { "BasicAuth": [ "/v1/auth/token" ] } ], "paths": { "/v3/enrollment/languages/{languageId}": { "put": { "tags": [ "enrollment" ], "summary": "Edit Enrollment messaging for a language\n", "description": "Edit enrollment messaging for a language.\n\n> 📋 **Required privilege:** Update User-Initiated Enrollment", "parameters": [ { "name": "languageId", "in": "path", "description": "Two letter ISO 639-1 Language Code", "required": true, "style": "simple", "explode": false, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnrollmentProcessTextObject" } } }, "required": false }, "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EnrollmentProcessTextObject" } } } }, "400": { "description": "Bad request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApiError" } } } } }, "x-required-privileges": [ "Update User-Initiated Enrollment" ] } } }, "components": { "schemas": { "ApiError": { "type": "object", "properties": { "httpStatus": { "type": "integer", "description": "HTTP status of the response", "example": 400 }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/ApiErrorCause" } } } }, "ApiErrorCause": { "required": [ "field" ], "type": "object", "properties": { "code": { "type": "string", "description": "Error-specific code that can be used to identify localization string, etc.", "example": "8675309" }, "field": { "type": "string", "description": "Name of the field that caused the error.", "example": "Name" }, "description": { "type": "string", "description": "A general description of error for troubleshooting/debugging. Generally this text should not be displayed to a user; instead refer to errorCode and it's localized text", "example": "I've just picked up a fault in the AE35 unit. It's going to go 100% failure in 72 hours" }, "id": { "type": "string", "description": "id of object with error. Optional.", "nullable": true, "example": "3" } } }, "EnrollmentProcessTextObject": { "type": "object", "properties": { "languageCode": { "type": "string", "example": "en" }, "name": { "type": "string", "example": "English" }, "title": { "type": "string", "example": "Enroll Your Device" }, "loginDescription": { "type": "string", "example": "Log in to enroll your device." }, "username": { "type": "string", "example": "admin" }, "password": { "type": "string", "example": "12345" }, "loginButton": { "type": "string", "example": "Log in" }, "deviceClassDescription": { "type": "string", "example": "Specify if this device is institutionally owned or personally owned." }, "deviceClassPersonal": { "type": "string", "example": "Personally Owned" }, "deviceClassPersonalDescription": { "type": "string", "example": "For personally owned devices, IT administrators **can**\n\n * Lock the device\n * Apply institutional settings\n * Install and remove institutional data\n * Install and remove institutional apps\n\n\n For personally owned devices, IT administrators **cannot**\n\n * Wipe all data and settings from your device\n * Track the location of your device\n * Remove anything they did not install\n * Add/remove configuration profiles\n * Add/remove provisioning profiles\n" }, "deviceClassEnterprise": { "type": "string", "example": "Institutionally Owned" }, "deviceClassEnterpriseDescription": { "type": "string", "example": "For institutionally owned devices, IT administrators **can**\n\n * Wipe all data and settings from the device\n * Lock the device\n * Remove the passcode\n * Apply institutional settings\n * Install and remove institutional data\n * Install and remove institutional apps\n * Add/remove configuration profiles\n * Add/remove provisioning profiles\n\n For institutionally owned devices, IT administrators **cannot**:\n\n * Remove anything they did not install\n" }, "deviceClassButton": { "type": "string", "example": "Enroll" }, "personalEula": { "type": "string", "example": "Personal Eula" }, "enterpriseEula": { "type": "string", "example": "Enterprise Eula" }, "eulaButton": { "type": "string", "example": "Accept" }, "siteDescription": { "type": "string", "example": "Select the site to use for enrolling this computer or mobile device." }, "certificateText": { "type": "string", "example": "To continue with enrollment, you need to install the CA certificate for your organization." }, "certificateButton": { "type": "string", "example": "Continue" }, "certificateProfileName": { "type": "string", "example": "CA Certificate" }, "certificateProfileDescription": { "type": "string", "example": "CA Certificate for mobile device management" }, "personalText": { "type": "string", "description": "**Deprecated as of 11.25.** This field always returns empty string in GET responses and ignores any input values in PUT requests.\n", "readOnly": true, "deprecated": true, "default": "" }, "personalButton": { "type": "string", "description": "**Deprecated as of 11.25.** This field always returns empty string in GET responses and ignores any input values in PUT requests.\n", "readOnly": true, "deprecated": true, "default": "" }, "personalProfileName": { "type": "string", "description": "**Deprecated as of 11.25.** This field always returns empty string in GET responses and ignores any input values in PUT requests.\n", "readOnly": true, "deprecated": true, "default": "" }, "personalProfileDescription": { "type": "string", "description": "**Deprecated as of 11.25.** This field always returns empty string in GET responses and ignores any input values in PUT requests.\n", "readOnly": true, "deprecated": true, "default": "" }, "userEnrollmentText": { "type": "string", "default": "Enter your Managed Apple id to install the MDM Profile." }, "userEnrollmentButton": { "type": "string", "default": "Continue" }, "userEnrollmentProfileName": { "type": "string", "default": "MDM Profile" }, "userEnrollmentProfileDescription": { "type": "string", "default": "MDM Profile for mobile device management" }, "enterpriseText": { "type": "string", "example": "To continue with enrollment, you need to install the MDM profile for your organization." }, "enterpriseButton": { "type": "string", "example": "Continue" }, "enterpriseProfileName": { "type": "string", "example": "MDM Profile" }, "enterpriseProfileDescription": { "type": "string", "example": "MDM Profile for mobile device management" }, "enterprisePending": { "type": "string", "example": "To continue with enrollment, install the CA Certificate and MDM Profile that were downloaded to your computer." }, "quickAddText": { "type": "string", "example": "Download and install this package." }, "quickAddButton": { "type": "string", "example": "Download" }, "quickAddName": { "type": "string", "default": "QuickAdd.pkg" }, "quickAddPending": { "type": "string", "example": "Install the downloaded QuickAdd.pkg." }, "completeMessage": { "type": "string", "example": "The enrollment process is complete." }, "failedMessage": { "type": "string", "example": "The enrollment process could not be completed. Contact your IT administrator." }, "tryAgainButton": { "type": "string", "example": "Try Again" }, "checkNowButton": { "type": "string", "example": "Proceed" }, "checkEnrollmentMessage": { "type": "string", "example": "Tap \"Proceed\" to view the enrollment status for this device." }, "logoutButton": { "type": "string", "example": "Log Out" } } } }, "securitySchemes": { "Bearer": { "type": "http", "scheme": "bearer", "bearerFormat": "JWT" }, "BasicAuth": { "type": "http", "description": "Basic auth is used only for obtaining bearer tokens from the /v1/auth/token endpoint", "scheme": "basic" }, "ApiClient": { "type": "oauth2", "description": "Jamf Pro API Roles and Clients provide a client ID and secret for obtaining access tokens using the OAuth2 client_credentials grant type", "flows": { "clientCredentials": { "tokenUrl": "/api/v1/oauth/token", "scopes": {} } } } } } } ```