Sign in

v77

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-045764591.5 MB
Prompts

✨ Run prompt inference

<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> Run a prompt inference.
post/api/prompts/{prompt_id}/versions/{version_id}/inference-runs

Path parameters

prompt_idinteger required
version_idinteger required

Request body

{"stackTrail":"components:schemas:ModelRunRequest:properties:filters_json","oasType":"schema","type":"unknown","description":"DM filter group for Filtered subset. Stored for display/re-run purposes.","nullable":true}
job_idstring nullable

Job ID for inference job for a ModelRun e.g. Adala job ID

only_missing_predictionsboolean

When true, only tasks without successful predictions for this prompt version are submitted for inference.

organizationinteger nullable
predictions_updated_atstring date-time nullable
projectinteger required
project_subset'All' | 'HasGT' | 'Sample' | 'Custom'
  • All - All
  • HasGT - HasGT
  • Sample - Sample
  • Custom - Custom
sample_subset_sizeinteger nullable

Custom sample size for Sample subset. Uses PROMPTER_SAMPLE_SUBSET_SIZE if not set.

total_correct_predictionsinteger nullable
total_predictionsinteger nullable
total_tasksinteger nullable

Response

completed_atstring date-time nullable required
created_atstring date-time required
{"stackTrail":"components:schemas:ModelRun:properties:filters_json","oasType":"schema","type":"unknown","description":"DM filter group for Filtered subset. Stored for display/re-run purposes.","nullable":true}
idinteger required
job_idstring nullable

Job ID for inference job for a ModelRun e.g. Adala job ID

organizationinteger nullable
parent_modelinteger required
predictions_updated_atstring date-time nullable
projectinteger required
project_subset'All' | 'HasGT' | 'Sample' | 'Custom'
  • All - All
  • HasGT - HasGT
  • Sample - Sample
  • Custom - Custom
sample_subset_sizeinteger nullable

Custom sample size for Sample subset. Uses PROMPTER_SAMPLE_SUBSET_SIZE if not set.

source_model_runinteger nullable required
status'Pending' | 'InProgress' | 'Completed' | 'Failed' | 'Canceled' required
  • Pending - Pending
  • InProgress - InProgress
  • Completed - Completed
  • Failed - Failed
  • Canceled - Canceled
{"stackTrail":"components:schemas:ModelRun:properties:task_ids","oasType":"schema","type":"unknown","description":"List of task IDs for Custom subset re-evaluation.","nullable":true}
total_correct_predictionsinteger nullable
total_predictionsinteger nullable
total_tasksinteger nullable
triggered_atstring date-time nullable required