Process all images in a project

curl --request POST \
  --url https://api.fotolabs.co/v1/projects/{projectId}/process \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "templateId": "original",
  "autoLevel": true
}
'

{
  "jobs": [
    {
      "jobId": "aaa-...",
      "type": "hdr",
      "imageIds": [
        "aaa-...",
        "bbb-...",
        "ccc-..."
      ]
    },
    {
      "jobId": "ddd-...",
      "type": "hdr",
      "imageIds": [
        "ddd-...",
        "eee-..."
      ]
    },
    {
      "jobId": "fff-...",
      "type": "single",
      "imageIds": [
        "fff-..."
      ]
    },
    {
      "jobId": "ggg-...",
      "type": "single",
      "imageIds": [
        "ggg-..."
      ]
    }
  ]
}

Projects

Process a project

Fetches all pending images for the project, auto-detects HDR bracket sets from EXIF metadata, groups them, and enqueues all jobs in a single call.

Project must be in pending status. Returns 409 if already processing or completed.

Once this call succeeds, the project moves to processing status — no further uploads are accepted and this endpoint cannot be called again for the same project.

HDR detection: Images captured within bracketWindowSeconds of each other with an EV spread ≥ 0.5 stops are automatically grouped as HDR bracket sets. No client-side grouping is needed — upload all images flat and let the API handle it.

Payment: Charged once per project.

PAYG plans (essential / ultimate): charged at the plan rate from your pricing tier.
Monthly plans: deducts one listing from your quota; if exhausted, the overage rate is charged.
Second call on the same project (after adding more images): free — project is already paid.

POST

/

v1

/

projects

/

{projectId}

/

process

Process all images in a project

curl --request POST \
  --url https://api.fotolabs.co/v1/projects/{projectId}/process \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "templateId": "original",
  "autoLevel": true
}
'

{
  "jobs": [
    {
      "jobId": "aaa-...",
      "type": "hdr",
      "imageIds": [
        "aaa-...",
        "bbb-...",
        "ccc-..."
      ]
    },
    {
      "jobId": "ddd-...",
      "type": "hdr",
      "imageIds": [
        "ddd-...",
        "eee-..."
      ]
    },
    {
      "jobId": "fff-...",
      "type": "single",
      "imageIds": [
        "fff-..."
      ]
    },
    {
      "jobId": "ggg-...",
      "type": "single",
      "imageIds": [
        "ggg-..."
      ]
    }
  ]
}

Authorizations

Authorization

string

header

required

API key with fl_ prefix, issued from the Fotolabs dashboard

Path Parameters

projectId

string<uuid>

required

Body

application/json

templateId

enum<string>

default:original

AI enhancement style. Overrides the project-level default.

Available options:

original,

twilight,

virtual-stage

autoLevel

boolean

default:true

Automatically correct horizon tilt using Hough line detection.

lensCorrection

boolean

Override lens distortion correction. Omit to use automatic detection (recommended). false skips correction; true forces it.

changeRequestNote

string

Free-text instruction passed to the AI model for all images in this batch.

Example:

"Brighten the foreground and add a warm sunset tone"

bracketWindowSeconds

number

default:2

Time window in seconds used to group HDR bracket exposures.

Required range: 0.5 <= x <= 30

Response

All jobs enqueued. Project is now in processing status. Poll each jobId via GET /v1/images/{imageId}.

jobs

object[]

required

Show child attributes

Create a project Get project status