Update enterprise configuration

PUT

/v1/organizations/:organizationId/mdm/android/enterprise/

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"
    }
}