API reference / Bulk / List bulk jobs

List bulk jobs

GET/apps/{appId}/bulk

Authenticate with an operator token or an app API key or a signed-in Foliot Console session.

Path parameters

appId

string

REQUIRED

The app's name.

Query parameters

limit

integer (int64)

OPTIONAL

How many jobs to return.

min 1 · max 200 · default 50

Responses

200 object OK

400 Error Invalid request.

401 Error Missing, malformed or unknown bearer token.

403 Error The token is valid but not permitted on this route.

404 Error No such resource.

503 Error A dependency this route needs is unreachable.

cURL

curl "https://api.foliot.app/apps/{appId}/bulk" \
  -H "Authorization: Bearer $FOLIOT_TOKEN"

RESPONSE 200 OK

{
  "bulkActions": [
    {
      "action": "redrive",
      "actor": "string",
      "appId": "string",
      "cancelReason": null,
      "createdAt": "2026-10-01T09:30:00Z",
      "done": 1,
      "error": null,
      "failed": 1,
      "finishedAt": null,
      "id": "3f2b8c1e-5a44-4c7a-9d0e-1b6f2a7c9e10",
      "params": {
        "action": "redrive",
        "filter": {}
      },
      "status": "pending",
      "total": 1
    }
  ]
}