Validation rules for brand asset image IDs including aspect ratios, resolvability, UUID format, and metadata checks

Image ID

AspectRatioMustBeWithinRangeForCoverPhotoIntent

Preconditions
intent is COVER_PHOTO

Definition	Severity	API	Sample	Mode
Validate that longest dimension is between >= 1.5380 and =< 1.5402 the length of the shortest dimension

Example Validation Report

{
  "validationReports": [
    {
      "code": "VALIDATION__AspectRatioMustBeWithinRangeForCoverPhotoIntent",
      "severity": "VIOLATION",
      "message": "Aspect ratio of photo, referenced via imageId, must be within permitted range",
      "details": {
        "createdDate": "2026-09-02T11:36:02.000Z",
        "submitted": [
          {
            "field": "id",
            "value": "1e863dc0-0980-11f0-9cd2-0242ac120002"
          }
        ],
        "compared": [],
        "expected": []
      }
    }
  ]
}

ImageIdMustBePresent

Definition	Severity	API	Sample	Mode
Validate that imageId is present			Link

ImageIdMustBeResolvable

Definition	Severity	API	Sample	Mode
Validate that imageId is resolvable to an Apple-generated Image ID

ImageIdMustBeAValidUUID

Definition	Severity	API	Sample	Mode
Validate that imageId is a valid UUID value

ImageIdMustNotBeEmpty

Definition	Severity	API	Sample	Mode
Validate that imageId is not an empty string

Metadata

ReferencedImageMustHaveValidFileNameExtensionForIntent

Definition	Severity	API	Sample	Mode
Validate that the referenced Image's filename extension is valid for the specified Intent			Link

ReferencedImageMustNotBeDeleted

Definition	Severity	API	Sample	Mode
Validate that the referenced Image does not possess a DELETED resource state

Example Validation Report

{
  "code": "VALIDATION__ReferencedImageMustNotBeDeleted",
  "severity": "VIOLATION",
  "message": "Referenced image must not be 'DELETED'",
  "details": {
    "createdDate": "2026-09-02T11:36:02.000Z",
    "submitted": [
      {
        "field": "$.id",
        "value": "1462340758314582016"
      }
    ],
    "compared": [],
    "expected": []
  }
}

ReferencedImageMustNotBeRejected

Definition	Severity	API	Sample	Mode
Validate that the referenced Image does not possess a REJECTED resource state

Example Validation Report

{
  "code": "VALIDATION__ReferencedImageMustNotBeRejected",
  "severity": "VIOLATION",
  "message": "Referenced image must not be 'REJECTED'",
  "details": {
    "createdDate": "2026-09-02T11:36:02.000Z",
    "submitted": [
      {
        "field": "$.id",
        "value": "1462340758314582016"
      }
    ],
    "compared": [],
    "expected": []
  }
}