✨ List state backfill jobs | API Reference

curl http://localhost:8000/api/fsm/backfill/jobs/ \
     -H "Authorization: Token  <api_key>" \
     -H "Content-Type: application/json"

{
  "jobs": [
    {
      "created_at": "2024-04-20T14:00:00Z",
      "job_id": 1024,
      "status": "completed",
      "completed_at": "2024-04-20T16:45:00Z",
      "progress_data": {
        "failed_projects": 0,
        "successful_projects": 5,
        "total_entities_processed": 1250,
        "total_projects": 5
      },
      "rq_job_id": "rq-job-7f3a9b2c",
      "started_at": "2024-04-20T14:05:00Z",
      "triggered_by": {
        "email": "admin@example.com",
        "id": 42,
        "first_name": "Alice",
        "last_name": "Johnson"
      }
    },
    {
      "created_at": "2024-04-21T08:30:00Z",
      "job_id": 1025,
      "status": "failed",
      "error_message": "Timeout error while processing project 3",
      "progress_data": {
        "failed_projects": 1,
        "successful_projects": 3,
        "total_entities_processed": 800,
        "total_projects": 4
      },
      "rq_job_id": "rq-job-8d4c1e7f",
      "started_at": "2024-04-21T08:35:00Z",
      "triggered_by": {
        "email": "owner@example.com",
        "id": 43,
        "first_name": "Bob",
        "last_name": "Smith"
      }
    },
    {
      "created_at": "2024-04-22T10:00:00Z",
      "job_id": 1026,
      "status": "pending",
      "progress_data": {
        "failed_projects": 0,
        "successful_projects": 0,
        "total_entities_processed": 0,
        "total_projects": 3
      },
      "rq_job_id": "rq-job-9a7b3c5d",
      "triggered_by": {
        "email": "admin@example.com",
        "id": 42,
        "first_name": "Alice",
        "last_name": "Johnson"
      }
    }
  ]
}

This endpoint is not available in Label Studio Community Edition. Learn more about Label Studio Enterprise

Retrieve the latest 10 state backfill jobs for the authenticated user’s active organization. Shows job history with status, progress, and timing information. Requires administrator or owner role and both FSM feature flags (fflag_feat_fit_568_finite_state_management and fflag_feat_fit_710_fsm_state_fields).

<Card href="https://humansignal.com/goenterprise"> <img style="pointer-events: none; margin-left: 0px; margin-right: 0px;" src="https://docs.humansignal.com/images/badge.svg" alt="Label Studio Enterprise badge"/> <p style="margin-top: 10px; font-size: 14px;"> This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise) </p> </Card> Retrieve the latest 10 state backfill jobs for the authenticated user's active organization. Shows job history with status, progress, and timing information. Requires administrator or owner role and both FSM feature flags (fflag_feat_fit_568_finite_state_management and fflag_feat_fit_710_fsm_state_fields).

Authentication

AuthorizationToken

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example:

curl https://label-studio-host/api/projects -H “Authorization: Token [your-token]”

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example: <br><pre><code class="language-bash">curl https://label-studio-host/api/projects -H "Authorization: Token [your-token]"</code></pre>

Response

jobslist of objects

Authentication

Response

Errors