Favicon

You are here: Home > API Reference > Android > Enterprise Creation > Update enterprise configuration

PUT /organizations/:organizationId/mdm/android/enterprise/

Required Permission: mdm.android.enterprise.update

Updates the EMM enterprise branding, contact information, and policy settings.

PUT
/v1/organizations/:organizationId/mdm/android/enterprise/
Copy to clipboard

Update enterprise configuration

Required Permission: mdm.android.enterprise.update

Updates the EMM enterprise branding, contact information, and policy settings.

Request

Add parameter in header authorization
Example: Authorization: Bearer <token>
organizationId string
required
Unique identifier for organization managing Apple enterprise application deployments and configurations.
Match pattern: ^(([a-fA-F0-9]{24})|([a-zA-Z0-9\\-]{3,}))$
Body Params application/json
emailText string optional
Custom email message template sent to users during enrollment process providing organization-specific instructions and welcome information.
config object required
Partial enterprise configuration update containing modified branding, contact, and policy settings synchronized to Google services.
primaryColor number optional
Integer representation of primary brand color in ARGB format applied to enrollment screens and management interface elements.
logo object required
Enterprise branding logo configuration containing image URL and content hash for visual customization of enrollment and management interfaces.
url string optional
Publicly accessible URL hosting the enterprise logo image displayed throughout Google Play EMM interfaces and enrollment experiences.
≤ 256 characters
sha256Hash string optional
SHA-256 content hash of logo image file ensuring integrity verification and preventing unauthorized modifications during transmission.
≤ 256 characters
enterpriseDisplayName string optional
User-facing enterprise name displayed within Google Play managed configurations interface and enrollment workflows visible to end users.
≤ 256 characters
termsAndConditions array [object] optional
Legal agreements and usage policies presented to users during device enrollment requiring acknowledgment before granting access.
header object optional
localizedMessages object optional
Key-value object mapping ISO 639-1 language codes to translated message text supporting internationalized content delivery.
defaultMessage string optional
Fallback message text displayed when user locale has no translation ensuring content accessibility regardless of language settings.
content object optional
localizedMessages object optional
Key-value object mapping ISO 639-1 language codes to translated message text supporting internationalized content delivery.
defaultMessage string optional
Fallback message text displayed when user locale has no translation ensuring content accessibility regardless of language settings.
appAutoApprovalEnabled boolean optional
Boolean flag enabling automatic approval for application installation requests bypassing manual administrator review workflows.
contactInfo object optional
Updated enterprise contact information propagated to Google Play EMM configuration and displayed to managed users.
contactEmail string optional
≤ 256 characters
dataProtectionOfficerName string optional
≤ 256 characters
dataProtectionOfficerEmail string optional
≤ 256 characters
dataProtectionOfficerPhone string optional
≤ 256 characters
euRepresentativeName string optional
≤ 256 characters
euRepresentativeEmail string optional
≤ 256 characters
euRepresentativePhone string optional
≤ 256 characters
configuration object optional
Updated branding configuration for enterprise visual identity refreshing logo, colors, and contact details across management interfaces.
primaryColor string optional
≤ 256 characters
logo string optional
contactEmail string optional
≤ 256 characters · Match pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ · Format: email
contactPhone string optional
≤ 256 characters
{
    "emailText": "string",
    "config": {
        "primaryColor": 0,
        "logo": {
            "url": "string",
            "sha256Hash": "string"
        },
        "enterpriseDisplayName": "string",
        "termsAndConditions": [
            {
                "header": {
                    "localizedMessages": {},
                    "defaultMessage": "string"
                },
                "content": {
                    "localizedMessages": {},
                    "defaultMessage": "string"
                }
            }
        ],
        "appAutoApprovalEnabled": true,
        "contactInfo": {
            "contactEmail": "string",
            "dataProtectionOfficerName": "string",
            "dataProtectionOfficerEmail": "string",
            "dataProtectionOfficerPhone": "string",
            "euRepresentativeName": "string",
            "euRepresentativeEmail": "string",
            "euRepresentativePhone": "string"
        }
    },
    "configuration": {
        "primaryColor": "string",
        "logo": "string",
        "contactEmail": "[email protected]",
        "contactPhone": "string"
    }
}

Responses

200 Response application/json
status boolean required
data object required
id string required
Unique identifier for the EMM enterprise record enabling cross-reference operations between local database and Google Android Management API resources.
Match pattern: ^[a-fA-F0-9]{24}$
config object required
Enterprise configuration object containing Google-synchronized settings for branding, authentication, and operational parameters.
name string optional
Internal enterprise name used for administrative identification within the platform backend systems distinct from user-facing display labels.
≤ 128 characters
enterpriseDisplayName string optional
User-facing enterprise name displayed within Google Play managed configurations interface and enrollment workflows visible to end users.
≤ 256 characters
logo any optional
Enterprise branding logo configuration containing image URL and content hash for visual customization of enrollment and management interfaces.
primaryColor integer optional
Integer representation of primary brand color in ARGB format applied to enrollment screens and management interface elements.
≥ 0 · ≤ 9007199254740991
termsAndConditions array optional
Legal agreements and usage policies presented to users during device enrollment requiring acknowledgment before granting access.
enterpriseType string optional
Google enterprise configuration type indicating operational mode as either customer-managed or EMM-managed affecting ownership and control boundaries.
managedGooglePlayAccountsEnterpriseType string optional
Managed Google Play account type defining user account provisioning model and authentication requirements for application distribution workflows.
managedGoogleDomainType string optional
Google domain management type specifying organization's authentication relationship with Google Workspace affecting sign-in policies and account restrictions.
googleAuthenticationSettings any optional
Authentication policy configuration controlling Google account sign-in requirements and restrictions for managed device access.
error string optional
Error code indicating enterprise configuration or synchronization failure requiring administrative intervention for resolution.
unauthorized
_config any optional
Raw enterprise configuration object from Google Android Management API preserved for debugging and advanced troubleshooting scenarios.
adminEmail string optional
≤ 256 characters · Match pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$ · Format: email
updatedAt string required
Timestamp recording most recent enterprise configuration modification enabling change tracking and audit trail maintenance.
createdAt string required
Timestamp marking initial enterprise creation providing foundational audit record and enabling lifecycle analysis.
{
    "status": true,
    "data": {
        "id": "string",
        "config": {
            "name": "string",
            "enterpriseDisplayName": "string",
            "logo": "string",
            "primaryColor": 0,
            "termsAndConditions": [
                "string"
            ],
            "enterpriseType": "string",
            "managedGooglePlayAccountsEnterpriseType": "string",
            "managedGoogleDomainType": "string",
            "googleAuthenticationSettings": "string"
        },
        "error": "unauthorized",
        "_config": "string",
        "adminEmail": "[email protected]",
        "updatedAt": "string",
        "createdAt": "string"
    }
}
400 Response application/json
status boolean optional
false
error object optional
code number optional
5050
message string optional
Feature not allowed for you billing plan
{
    "status": false,
    "error": {
        "code": 5050,
        "message": "Feature not allowed for you billing plan"
    }
}
401 Response application/json
status boolean optional
false
error object optional
code number optional
4004
message string optional
Invalid Token
{
    "status": false,
    "error": {
        "code": 4002,
        "message": "No auth token"
    }
}
404 Response application/json
status boolean optional
false
error object optional
code number optional
3001
message string optional
Entity not found
{
    "status": false,
    "error": {
        "code": 3001,
        "message": "Entity not found"
    }
}