✨ Get Dimension value-counts backfill status | API Reference

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

Retrieve the status of a Dimension value-counts backfill job for the authenticated user’s active organization. By default returns the aggregated organization status. Specify job_id or project_id to get a specific job status. 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

job_idintegerOptional

Optional job ID to retrieve specific job status

project_idintegerOptional

Optional project ID to retrieve the latest backfill status for that project. If omitted, returns aggregated organization status.

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

403

Forbidden Error

404

Not Found Error