Adobe Creative Suite · Schema

Adobe Creative Suite Image Job

Schema for asynchronous image processing jobs submitted to Adobe Photoshop and related Creative Suite image APIs. Covers the full lifecycle of a job from submission through completion or failure, including input references, output references, and error details.

CreativeDesignGraphicsPhotographyVideo

Properties

Name	Type	Description
jobId	string	Unique identifier assigned to the image processing job upon submission
status	string	Current lifecycle status of the image processing job
created	string	ISO 8601 timestamp indicating when the job was submitted for processing
modified	string	ISO 8601 timestamp indicating when the job record was last updated
input	object	Reference to the input file used for this image processing job
output	object	Reference to the output file location for this image processing job
outputs	array	List of output files produced when the job succeeds (for multi-output operations)
errors	array	List of errors encountered during job processing (populated when status is failed)

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://developer.adobe.com/ns/creative-suite/schemas/image-job",
  "title": "Adobe Creative Suite Image Job",
  "description": "Schema for asynchronous image processing jobs submitted to Adobe Photoshop and related Creative Suite image APIs. Covers the full lifecycle of a job from submission through completion or failure, including input references, output references, and error details.",
  "type": "object",
  "required": ["jobId", "status"],
  "properties": {
    "jobId": {
      "type": "string",
      "description": "Unique identifier assigned to the image processing job upon submission",
      "examples": ["f54e0fcb-260b-47c3-b520-de0d17dc2b67"]
    },
    "status": {
      "type": "string",
      "description": "Current lifecycle status of the image processing job",
      "enum": ["pending", "running", "succeeded", "failed"],
      "examples": ["succeeded"]
    },
    "created": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp indicating when the job was submitted for processing",
      "examples": ["2026-03-02T12:00:00.000Z"]
    },
    "modified": {
      "type": "string",
      "format": "date-time",
      "description": "ISO 8601 timestamp indicating when the job record was last updated",
      "examples": ["2026-03-02T12:00:45.000Z"]
    },
    "input": {
      "type": "object",
      "description": "Reference to the input file used for this image processing job",
      "required": ["href", "storage"],
      "properties": {
        "href": {
          "type": "string",
          "description": "URL or path to the input file in the specified cloud storage provider",
          "examples": ["https://my-storage.blob.core.windows.net/images/input.psd"]
        },
        "storage": {
          "type": "string",
          "description": "Cloud storage provider where the input file resides",
          "enum": ["adobe", "external", "azure", "dropbox"],
          "examples": ["external"]
        },
        "type": {
          "type": "string",
          "description": "MIME type of the input file",
          "examples": ["image/vnd.adobe.photoshop", "image/jpeg", "image/png"]
        }
      },
      "additionalProperties": false
    },
    "output": {
      "type": "object",
      "description": "Reference to the output file location for this image processing job",
      "required": ["href", "storage", "type"],
      "properties": {
        "href": {
          "type": "string",
          "description": "URL or path where the processed output file will be stored",
          "examples": ["https://my-storage.blob.core.windows.net/images/output.png"]
        },
        "storage": {
          "type": "string",
          "description": "Cloud storage provider where the output file will be written",
          "enum": ["adobe", "external", "azure", "dropbox"],
          "examples": ["external"]
        },
        "type": {
          "type": "string",
          "description": "MIME type of the output file to produce",
          "examples": ["image/png", "image/jpeg", "image/vnd.adobe.photoshop"]
        },
        "width": {
          "type": "integer",
          "description": "Width of the output image in pixels",
          "minimum": 1,
          "examples": [1920]
        },
        "height": {
          "type": "integer",
          "description": "Height of the output image in pixels",
          "minimum": 1,
          "examples": [1080]
        },
        "overwrite": {
          "type": "boolean",
          "description": "Whether to overwrite an existing file at the output location",
          "default": true
        }
      },
      "additionalProperties": false
    },
    "outputs": {
      "type": "array",
      "description": "List of output files produced when the job succeeds (for multi-output operations)",
      "items": {
        "type": "object",
        "description": "An individual output produced by this image processing job",
        "properties": {
          "input": {
            "type": "string",
            "description": "Reference to the input file that generated this output"
          },
          "status": {
            "type": "string",
            "description": "Status of this specific output",
            "enum": ["pending", "running", "succeeded", "failed"]
          },
          "details": {
            "type": "string",
            "description": "Additional human-readable detail about this output's status"
          },
          "href": {
            "type": "string",
            "description": "URL to download the completed output file",
            "examples": ["https://my-storage.blob.core.windows.net/images/output.png"]
          },
          "storage": {
            "type": "string",
            "description": "Cloud storage provider where the output file was written",
            "enum": ["adobe", "external", "azure", "dropbox"]
          },
          "type": {
            "type": "string",
            "description": "MIME type of the output file",
            "examples": ["image/png"]
          },
          "width": {
            "type": "integer",
            "description": "Actual width of the output image in pixels",
            "minimum": 1
          },
          "height": {
            "type": "integer",
            "description": "Actual height of the output image in pixels",
            "minimum": 1
          }
        }
      }
    },
    "errors": {
      "type": "array",
      "description": "List of errors encountered during job processing (populated when status is failed)",
      "items": {
        "type": "object",
        "description": "An individual error encountered during image processing",
        "properties": {
          "code": {
            "type": "string",
            "description": "Machine-readable error code identifying the type of failure",
            "examples": ["InputValidationError", "StorageAccessError"]
          },
          "title": {
            "type": "string",
            "description": "Short human-readable title for the error",
            "examples": ["Invalid input file format"]
          },
          "description": {
            "type": "string",
            "description": "Detailed human-readable explanation of what went wrong",
            "examples": ["The provided file is not a valid PSD document"]
          }
        },
        "required": ["code"]
      }
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "jobId": "f54e0fcb-260b-47c3-b520-de0d17dc2b67",
      "status": "succeeded",
      "created": "2026-03-02T12:00:00.000Z",
      "modified": "2026-03-02T12:00:45.000Z",
      "input": {
        "href": "https://my-storage.blob.core.windows.net/images/product.jpg",
        "storage": "external",
        "type": "image/jpeg"
      },
      "output": {
        "href": "https://my-storage.blob.core.windows.net/images/product-cutout.png",
        "storage": "external",
        "type": "image/png",
        "width": 2000,
        "height": 3000
      },
      "errors": []
    }
  ]
}