---
title: "Image"
description: "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."
section: "Reference"
group: "Types"
order: 122
---

## Definition

```ts
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: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    |