Skip to navigation
API ReferenceDimensions

✨ List Dimension value-counts backfill jobs

Label Studio Enterprise badge

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

Retrieve Dimension value-counts backfill jobs for the authenticated user’s active organization, ordered by most-recently created first. Supports page / page_size query params (default 50 per page, max 500). Requires administrator or owner role and Agreement V2 access.

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]”

Query parameters

statusstringOptional

Filter by job status: PENDING, QUEUED, RUNNING, COMPLETED, or FAILED.

Response

created_atdatetimeRead-only
job_idintegerRead-only
Database ID of the backfill job
project_idinteger or nullRead-only

Optional specific project to backfill (if null, backfills entire organization)

rq_job_idstring or nullRead-only
Redis queue job ID
triggered_bymap from strings to integers or strings or nullRead-only
User who triggered the backfill
completed_atdatetime or nullOptional
error_messagestringOptional
Error message if job failed
progress_dataanyOptional

JSON data tracking job progress (rows_written, etc.)

started_atdatetime or nullOptional
statusenumOptional

Current status of the backfill job

  • PENDING - Pending
  • QUEUED - Queued
  • RUNNING - Running
  • COMPLETED - Completed
  • FAILED - Failed
Allowed values:

Errors

400
Bad Request Error
403
Forbidden Error