Skip to main content

Validation rules for brand asset metadata including dimensions, partner asset IDs, and photo quality checks

Brand Asset Details​

BrandAssetDetailsMustBePresent​

DefinitionSeverityAPISampleMode
Validate that brandAssetDetails is present
VIOLATION
POST_AND_PUT
S

Dimensions​

ImageMustHaveValidDimensionsForIntent​

DefinitionSeverityAPISampleMode
Validate that the actual dimensions of an image/photo resource, referenced via imageId, are within a permitted range for the specified intent
VIOLATION
POST_AND_PUT
Link
A
Example Validation Report
{
"validationReports": [
{
"code": "VALIDATION__ImageMustHaveValidDimensionsForIntent",
"severity": "VIOLATION",
"message": "Image must have valid dimensions for intent 'COVER_PHOTO'",
"details": {
"createdDate": "2026-09-02T11:36:02.000Z",
"submitted": [
{
"field": "width",
"value": "1200"
}
],
"compared": [],
"expected": []
}
}
]
}

Partners Asset ID​

PartnersAssetIdAlreadyExists​

DefinitionSeverityAPISampleMode
Validate that partnersAssetId is not associated with another brand
WARNING
POST_AND_PUT
S

PartnersAssetIdMustNotBeEmpty​

DefinitionSeverityAPISampleMode
Validate that partnersAssetId is not an empty string
VIOLATION
POST_AND_PUT
S

Photo​

PhotoRejectionConfirmed​

DefinitionSeverityAPISampleMode
Validate that a Brand Asset's referenced photo/image satisfies Apple Maps requirements
VIOLATION
POST_AND_PUT
A
Example Validation Report
{
"validationReports": [
{
"code": "VALIDATION__PhotoRejectionConfirmed",
"severity": "VIOLATION",
"message": "Rejection confirmed for photo with Apple-generated '{{id}}'",
"context": {
"id": "9467895078742654976"
},
"details": {
"createdDate": "2026-09-02T11:36:02.000Z",
"submitted": [
{
"field": "id",
"value": "9467895078742654976"
}
],
"compared": [],
"expected": []
}
}
]
}