Image

Image — Cloudflare Images specialization of a file row. Surfaced alongside its file data via the filtered `/api/images` endpoint. Keyed by its own `img_…` id, with a unique 1:1 FK to the underlying file (`fileId`). The `url` field is derived at read time from the CF Images account hash and the `cfImageId`, signed with a short-lived JWT if signing is configured.

Definition

TypeScript

interface Image {
  id: string;
  fileId: string;
  workspaceId: string;
  cfImageId: string;
  width: number | null;
  height: number | null;
  size: number | null;
  exif: Record<string, unknown> | null;
  url: string;
}

Fields

Field	Type	Notes
`id`	`string`	`readonly` `required` — The image's prefixed ID.
`fileId`	`string`	`required` — Underlying file row backing this image (1 ).
`workspaceId`	`string`	`required` — Workspace that owns the image.
`cfImageId`	`string`	`required` — Cloudflare Images resource ID used to build delivery URLs.
`width`	`number \| null`	`required` — Image width in pixels, if known.
`height`	`number \| null`	`required` — Image height in pixels, if known.
`size`	`number \| null`	`required` — Image size in bytes, if known.
`exif`	`Record<string, unknown> \| null`	`required` — Parsed EXIF metadata, when available.
`url`	`string`	`required` — Cloudflare Images delivery URL for the `public` variant