---
title: "Read an image generation job"
method: GET
path: "/ai/images/{jobId}"
tags: ["AI"]
---

# Read an image generation job

`GET /ai/images/{jobId}`

## Request

- Base URL: `https://post.adaptlypost.com/post/api/v1`
- URL: `https://post.adaptlypost.com/post/api/v1/ai/images/{jobId}`
- Auth: HTTP bearer

Requires the `ai.generate` permission.

## Path parameters

- `jobId` string, required

## Headers

- `X-Workspace-Id` string

## Response `200`

Image job state

- ImageJobResponse
  - `jobId` string
  - `sessionId` string, uuid
  - `status` 'queued' | 'processing' | 'generating' | 'completed' | 'failed'
  - `imageUrl` string, nullable
  - `imageId` string, uuid, nullable
  - `error` string, nullable

## Other responses

- `401`: Invalid or missing API key
- `403`: The key's role does not hold `ai.generate`
- `404`: Job not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api.md) · [All operations](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/revisions/8390a5fa9a0d?raw)