API ReferencePrompts

✨ Get Project Subset Task List with Predictions and Accuracy details

<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> Provides list of tasks, based on project subset. Includes predictions for tasks. For the 'HasGT' subset, accuracy metrics will also be provided.

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: <br><pre><code class="language-bash">curl https://label-studio-host/api/projects -H "Authorization: Token [your-token]"</code></pre>

Path parameters

project_pkintegerRequired

Query parameters

alignment_classstringOptional

Only include tasks whose prediction/reference alignment includes this class.

alignment_from_namestringOptional

When alignment_class is set, limit matching to this output control tag.

alignment_outcomeenumOptional
Alignment outcome to drill into. Defaults to all TP, FP, and FN outcomes.
Allowed values:
include_totalbooleanOptional

If true (default), includes task_count in response; if false, omits it.

model_runintegerOptional
A unique ID of a ModelRun
model_versionintegerOptional

Restrict prefetched predictions to this specific prompt version. Used with parent_model when no model_run is selected so a newly created version does not inherit predictions from prior versions.

orderingstringOptional
Which field to use when ordering the results.
output_classstringOptional
Only include tasks whose prediction contains this output class.
output_from_namestringOptional

When output_class is set, limit matching to this output control tag.

pageintegerOptional
A page number within the paginated result set.
page_sizeintegerOptional
Number of results to return per page.
parent_modelintegerOptional

The ID of the parent model (ModelInterface) for this Inference Run

prediction_version_idsstringOptional

Comma-separated model version IDs. Only include tasks that have predictions for every listed version.

project_subsetstringOptional
The project subset to retrieve tasks for

Response

countinteger
resultslist of objects
nextstring or nullOptionalformat: "uri"
previousstring or nullOptionalformat: "uri"

Errors

400
Bad Request Error