Get a slideshow-generation job's status

GET

/public/v1/slides/generate/{id}

const url = 'https://api.loomta.com/public/v1/slides/generate/example';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://api.loomta.com/public/v1/slides/generate/example \
  --header 'Authorization: Bearer <token>'

Poll until status is DONE (the post has been created — see postGroupId) or FAILED.

Authorizations

apiKey

Parameters

Path Parameters

required

string

The jobId from POST /slides/generate.

Responses

200

The job status.

application/json

object

required

string

status

required

string

Allowed values: WAITING PROCESSING DONE FAILED

total

required

Number of images in the batch.

integer

completed

required

Images generated + uploaded so far.

integer

postGroupId

The created post’s group id, once status is DONE.

string | null format: uuid

error

string | null

Example

{
  "status": "WAITING"
}

401

The API key is missing or invalid.

application/json

object

code

required

A stable, machine-readable error code to branch on.

string

message

required

A human-readable description.

string

details

Optional structured detail (for example Zod validation issues).

Examples

{
  "code": "missing_api_key",
  "message": "A Bearer API key is required."
}

{
  "code": "invalid_api_key",
  "message": "The API key is invalid."
}

404

The resource was not found in this workspace.

application/json

object

code

required

A stable, machine-readable error code to branch on.

string

message

required

A human-readable description.

string

details

Optional structured detail (for example Zod validation issues).

Example

{
  "code": "invalid_api_key",
  "message": "The API key is invalid."
}