Label Studio subpackage_prompts API
The subpackage_prompts API from Label Studio — 7 operation(s) for subpackage_prompts.
The subpackage_prompts API from Label Studio — 7 operation(s) for subpackage_prompts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/label-studio-subpackage-prompts-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Reference subpackage_actions Subpackage Prompts API
version: 1.0.0
servers:
- url: http://localhost:8000
tags:
- name: subpackage_prompts
paths:
/api/model-run/batch-failed-predictions:
post:
operationId: batch-failed-predictions
summary: ✨ Create batch of failed predictions
description: "<Card href=\"https://humansignal.com/goenterprise\">\n <img style=\"pointer-events: none; margin-left: 0px; margin-right: 0px;\" src=\"https://docs.humansignal.com/images/badge.svg\" alt=\"Label Studio Enterprise badge\"/>\n <p style=\"margin-top: 10px; font-size: 14px;\">\n This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)\n </p>\n </Card>\nCreate a new batch of failed predictions."
tags:
- subpackage_prompts
parameters:
- name: num_failed_predictions
in: query
description: Number of failed predictions being sent (for telemetry only, has no effect)
required: false
schema:
type: integer
- name: Authorization
in: header
description: '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>'
required: true
schema:
type: string
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/BatchFailedPredictions'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BatchFailedPredictionsRequestRequest'
/api/model-run/batch-predictions:
post:
operationId: batch-predictions
summary: ✨ Create batch predictions
description: "<Card href=\"https://humansignal.com/goenterprise\">\n <img style=\"pointer-events: none; margin-left: 0px; margin-right: 0px;\" src=\"https://docs.humansignal.com/images/badge.svg\" alt=\"Label Studio Enterprise badge\"/>\n <p style=\"margin-top: 10px; font-size: 14px;\">\n This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)\n </p>\n </Card>\nCreate a new batch prediction."
tags:
- subpackage_prompts
parameters:
- name: num_predictions
in: query
description: Number of predictions being sent (for telemetry only, has no effect)
required: false
schema:
type: integer
- name: Authorization
in: header
description: '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>'
required: true
schema:
type: string
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/BatchPredictions'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/BatchPredictionsRequestRequest'
/api/projects/{project_pk}/subset-tasks:
get:
operationId: subset-tasks
summary: ✨ Get Project Subset Task List with Predictions and Accuracy details
description: "<Card href=\"https://humansignal.com/goenterprise\">\n <img style=\"pointer-events: none; margin-left: 0px; margin-right: 0px;\" src=\"https://docs.humansignal.com/images/badge.svg\" alt=\"Label Studio Enterprise badge\"/>\n <p style=\"margin-top: 10px; font-size: 14px;\">\n This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)\n </p>\n </Card>\n\n Provides list of tasks, based on project subset. Includes predictions for tasks. For the 'HasGT' subset, accuracy metrics will also be provided.\n "
tags:
- subpackage_prompts
parameters:
- name: project_pk
in: path
required: true
schema:
type: integer
- name: include_total
in: query
description: If true (default), includes task_count in response; if false, omits it.
required: false
schema:
type: boolean
- name: model_run
in: query
description: A unique ID of a ModelRun
required: false
schema:
type: integer
- name: ordering
in: query
description: Which field to use when ordering the results.
required: false
schema:
type: string
- name: page
in: query
description: A page number within the paginated result set.
required: false
schema:
type: integer
- name: page_size
in: query
description: Number of results to return per page.
required: false
schema:
type: integer
- name: parent_model
in: query
description: The ID of the parent model (ModelInterface) for this Inference Run
required: false
schema:
type: integer
- name: project_subset
in: query
description: The project subset to retrieve tasks for
required: false
schema:
type: string
- name: Authorization
in: header
description: '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>'
required: true
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedProjectSubsetTasksResponseList'
'400':
description: Bad request - missing parent_model
content:
application/json:
schema:
description: Any type
/api/projects/{project_pk}/subsets:
get:
operationId: subsets
summary: ✨ Get available subsets of a project (for prompts usage)
description: "<Card href=\"https://humansignal.com/goenterprise\">\n <img style=\"pointer-events: none; margin-left: 0px; margin-right: 0px;\" src=\"https://docs.humansignal.com/images/badge.svg\" alt=\"Label Studio Enterprise badge\"/>\n <p style=\"margin-top: 10px; font-size: 14px;\">\n This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)\n </p>\n </Card>\n\n Provides list of available subsets for a project along with count of tasks in each subset\n "
tags:
- subpackage_prompts
parameters:
- name: project_pk
in: path
required: true
schema:
type: integer
- name: ordering
in: query
description: Which field to use when ordering the results.
required: false
schema:
type: string
- name: Authorization
in: header
description: '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>'
required: true
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/ProjectSubsetItem'
/api/prompts/:
get:
operationId: list
summary: ✨ List prompts
description: List all prompts.
tags:
- subpackage_prompts
parameters:
- name: ordering
in: query
description: Which field to use when ordering the results.
required: false
schema:
type: string
- name: page
in: query
description: A page number within the paginated result set.
required: false
schema:
type: integer
- name: page_size
in: query
description: Number of results to return per page.
required: false
schema:
type: integer
- name: search
in: query
description: A search term.
required: false
schema:
type: string
- name: Authorization
in: header
description: '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>'
required: true
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedModelInterfaceSerializerGETList'
post:
operationId: create
summary: ✨ Create prompt
description: "<Card href=\"https://humansignal.com/goenterprise\">\n <img style=\"pointer-events: none; margin-left: 0px; margin-right: 0px;\" src=\"https://docs.humansignal.com/images/badge.svg\" alt=\"Label Studio Enterprise badge\"/>\n <p style=\"margin-top: 10px; font-size: 14px;\">\n This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)\n </p>\n </Card>\nCreate a new prompt."
tags:
- subpackage_prompts
parameters:
- name: Authorization
in: header
description: '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>'
required: true
schema:
type: string
responses:
'201':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ModelInterface'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/ModelInterfaceRequest'
/api/prompts/compatible-projects:
get:
operationId: compatible-projects
summary: ✨ List projects compatible with prompt
description: Retrieve a list of compatible project for prompt.
tags:
- subpackage_prompts
parameters:
- name: ordering
in: query
description: Which field to use when ordering the results.
required: false
schema:
type: string
- name: page
in: query
description: A page number within the paginated result set.
required: false
schema:
type: integer
- name: page_size
in: query
description: Number of results to return per page.
required: false
schema:
type: integer
- name: project_type
in: query
description: Skill to filter by
required: false
schema:
$ref: '#/components/schemas/ApiPromptsCompatibleProjectsGetParametersProjectType'
- name: Authorization
in: header
description: '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>'
required: true
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/PaginatedAllRolesProjectListList'
/api/prompts/{id}/:
get:
operationId: get
summary: ✨ Get prompt
description: "<Card href=\"https://humansignal.com/goenterprise\">\n <img style=\"pointer-events: none; margin-left: 0px; margin-right: 0px;\" src=\"https://docs.humansignal.com/images/badge.svg\" alt=\"Label Studio Enterprise badge\"/>\n <p style=\"margin-top: 10px; font-size: 14px;\">\n This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)\n </p>\n </Card>\nRetrieve a specific prompt."
tags:
- subpackage_prompts
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: Authorization
in: header
description: '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>'
required: true
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ModelInterfaceSerializerGET'
delete:
operationId: delete
summary: ✨ Delete prompt
description: "<Card href=\"https://humansignal.com/goenterprise\">\n <img style=\"pointer-events: none; margin-left: 0px; margin-right: 0px;\" src=\"https://docs.humansignal.com/images/badge.svg\" alt=\"Label Studio Enterprise badge\"/>\n <p style=\"margin-top: 10px; font-size: 14px;\">\n This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)\n </p>\n </Card>\nDelete a prompt by ID"
tags:
- subpackage_prompts
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: Authorization
in: header
description: '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>'
required: true
schema:
type: string
responses:
'200':
description: Successful response
patch:
operationId: update
summary: ✨ Update prompt
description: "<Card href=\"https://humansignal.com/goenterprise\">\n <img style=\"pointer-events: none; margin-left: 0px; margin-right: 0px;\" src=\"https://docs.humansignal.com/images/badge.svg\" alt=\"Label Studio Enterprise badge\"/>\n <p style=\"margin-top: 10px; font-size: 14px;\">\n This endpoint is not available in Label Studio Community Edition. [Learn more about Label Studio Enterprise](https://humansignal.com/goenterprise)\n </p>\n </Card>\nUpdate a specific prompt by ID."
tags:
- subpackage_prompts
parameters:
- name: id
in: path
required: true
schema:
type: string
- name: Authorization
in: header
description: '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>'
required: true
schema:
type: string
responses:
'200':
description: ''
content:
application/json:
schema:
$ref: '#/components/schemas/ModelInterface'
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/PatchedModelInterfaceRequest'
components:
schemas:
SkillNameEnum:
type: string
enum:
- TextClassification
- NamedEntityRecognition
description: '* `TextClassification` - TextClassification
* `NamedEntityRecognition` - NamedEntityRecognition'
title: SkillNameEnum
BlueprintList:
type: object
properties:
created_at:
type: string
format: date-time
description:
type:
- string
- 'null'
description: Project description
id:
type: integer
share_id:
type: string
short_url:
type: string
task_count:
type: string
title:
type:
- string
- 'null'
description: Blueprint name. Must be between 3 and 50 characters long.
required:
- created_at
- id
- share_id
- short_url
- task_count
title: BlueprintList
PaginatedModelInterfaceSerializerGETList:
type: object
properties:
count:
type: integer
next:
type:
- string
- 'null'
format: uri
previous:
type:
- string
- 'null'
format: uri
results:
type: array
items:
$ref: '#/components/schemas/ModelInterfaceSerializerGET'
required:
- count
- results
title: PaginatedModelInterfaceSerializerGETList
BatchFailedPredictionsRequestRequest:
type: object
properties:
failed_predictions:
type: array
items:
description: Any type
job_id:
type: string
modelrun_id:
type: integer
required:
- failed_predictions
- modelrun_id
title: BatchFailedPredictionsRequestRequest
ControlTagWeight:
type: object
properties:
labels:
type: object
additionalProperties:
type: number
format: double
description: Per-label weights (0.0 to 1.0). Zero excludes the label from agreement.
overall:
type: number
format: double
description: Overall weight for this control tag (0.0 to 1.0). Zero excludes the tag from agreement.
type:
type: string
description: Control tag type from the labeling config (e.g. Choices, Labels, TextArea).
required:
- overall
- type
description: 'Weights configuration for a single control tag.
Structure: {"overall": 0.5, "type": "Choices", "labels": {"cat": 1.0, "dog": 0.0}}'
title: ControlTagWeight
RequeueRejectedTasksModeEnum:
type: string
enum:
- requeue
- remove
- flexible
description: '* `requeue` - Requeue
* `remove` - Remove
* `flexible` - Flexible'
title: RequeueRejectedTasksModeEnum
ModelInterfaceSerializerGET:
type: object
properties:
associated_projects:
type: array
items:
$ref: '#/components/schemas/AssociatedProject'
best_score:
type:
- number
- 'null'
format: double
created_at:
type: string
format: date-time
created_by:
$ref: '#/components/schemas/UserSimple'
description: User who created Dataset
description:
type:
- string
- 'null'
description: Model description
id:
type: integer
input_fields:
description: Any type
organization:
type:
- integer
- 'null'
output_classes:
description: Any type
runs_count:
type: integer
default: 0
skill_name:
$ref: '#/components/schemas/SkillNameEnum'
title:
type: string
description: Model name
updated_at:
type: string
format: date-time
versions_count:
type: integer
default: 0
required:
- best_score
- created_at
- id
- runs_count
- title
- updated_at
- versions_count
title: ModelInterfaceSerializerGET
ProjectSubsetTasksResponse:
type: object
properties:
next_cursor:
type:
- string
- 'null'
previous_cursor:
type:
- string
- 'null'
task_count:
type: integer
description: Present only when include_total=true
task_result_list:
type: array
items:
$ref: '#/components/schemas/ProjectSubsetTaskItem'
required:
- task_result_list
title: ProjectSubsetTasksResponse
PatchedModelInterfaceRequest:
type: object
properties:
associated_projects:
type: array
items:
type: integer
created_by:
$ref: '#/components/schemas/UserSimpleRequest'
description: User who created Dataset
description:
type:
- string
- 'null'
description: Model description
input_fields:
description: Any type
organization:
type:
- integer
- 'null'
output_classes:
description: Any type
skill_name:
$ref: '#/components/schemas/SkillNameEnum'
title:
type: string
description: Model name
title: PatchedModelInterfaceRequest
ProjectSubsetTaskItem:
type: object
properties:
data:
type: object
additionalProperties:
description: Any type
error:
type: object
additionalProperties:
description: Any type
ground_truth:
type: object
additionalProperties:
description: Any type
id:
type: integer
prediction:
type: object
additionalProperties:
description: Any type
score:
type:
- number
- 'null'
format: double
required:
- data
title: ProjectSubsetTaskItem
ModelInterface:
type: object
properties:
associated_projects:
type: array
items:
type: integer
created_at:
type: string
format: date-time
created_by:
$ref: '#/components/schemas/UserSimple'
description: User who created Dataset
description:
type:
- string
- 'null'
description: Model description
id:
type: integer
input_fields:
description: Any type
organization:
type:
- integer
- 'null'
output_classes:
description: Any type
skill_name:
$ref: '#/components/schemas/SkillNameEnum'
title:
type: string
description: Model name
updated_at:
type: string
format: date-time
required:
- created_at
- id
- title
- updated_at
title: ModelInterface
UserSimpleRequest:
type: object
properties:
email:
type: string
format: email
first_name:
type: string
last_name:
type: string
username:
type: string
required:
- username
description: 'A ModelSerializer that takes additional arguments for
"fields", "omit" and "expand" in order to
control which fields are displayed, and whether to replace simple
values with complex, nested serializations'
title: UserSimpleRequest
BatchFailedPredictions:
type: object
properties:
failed_predictions:
type: array
items:
description: Any type
job_id:
type: string
required:
- failed_predictions
- job_id
title: BatchFailedPredictions
ReviewSettingsSamplingEnum:
type: string
enum:
- task_id
- random
description: '* `task_id` - By Task ID
* `random` - Random'
title: ReviewSettingsSamplingEnum
SamplingDe5Enum:
type: string
enum:
- Sequential sampling
- Uniform sampling
- Uncertainty sampling
description: '* `Sequential sampling` - Tasks are ordered by Data manager ordering
* `Uniform sampling` - Tasks are chosen randomly
* `Uncertainty sampling` - Tasks are chosen according to model uncertainty scores (active learning mode)'
title: SamplingDe5Enum
SkipQueueEnum:
type: string
enum:
- REQUEUE_FOR_ME
- REQUEUE_FOR_OTHERS
- IGNORE_SKIPPED
description: '* `REQUEUE_FOR_ME` - Requeue for me
* `REQUEUE_FOR_OTHERS` - Requeue for others
* `IGNORE_SKIPPED` - Ignore skipped'
title: SkipQueueEnum
LabelStreamTaskDistributionEnum:
type: string
enum:
- auto_distribution
- assigned_only
description: '* `auto_distribution` - Label Stream distributes tasks automatically to annotators
* `assigned_only` - Label Stream shows tasks only to assigned users'
title: LabelStreamTaskDistributionEnum
AssociatedProject:
type: object
properties:
id:
type: integer
title:
type:
- string
- 'null'
description: Project name. Must be between 3 and 50 characters long.
required:
- id
description: 'A ModelSerializer that takes additional arguments for
"fields", "omit" and "expand" in order to
control which fields are displayed, and whether to replace simple
values with complex, nested serializations'
title: AssociatedProject
AllRolesProjectList:
type: object
properties:
agreement_methodology:
$ref: '#/components/schemas/AgreementMethodologyEnum'
description: 'Methodology (Consensus / Pairwise Averaging)
* `consensus` - Consensus
* `pairwise` - Pairwise Averaging'
agreement_threshold:
type:
- string
- 'null'
format: decimal
description: Agreement threshold
allow_stream:
type: boolean
annotation_limit_count:
type:
- integer
- 'null'
description: Limit by number of tasks
annotation_limit_percent:
type:
- string
- 'null'
format: decimal
description: Limit by percentage of tasks
annotator_evaluation_continuous_tasks:
type: integer
default: 0
description: 'Continuous Evaluation: Required tasks'
annotator_evaluation_enabled:
type: boolean
description: Evaluate all annotators against ground truth
annotator_evaluation_minimum_score:
type:
- string
- 'null'
format: decimal
default: '95.00'
description: Score required to pass evaluation
annotator_evaluation_minimum_tasks:
type:
- integer
- 'null'
default: 10
description: Number of tasks for evaluation
annotator_evaluation_onboarding_tasks:
type: integer
default: 0
description: 'Onboarding Evaluation: Required tasks'
assignment_settings:
$ref: '#/components/schemas/AssignmentSettings'
blueprints:
type: array
items:
$ref: '#/components/schemas/BlueprintList'
color:
type:
- string
- 'null'
description: Color
comment_classification_config:
type: string
config_has_control_tags:
type: boolean
description: Flag to detect is project ready for labeling
config_suitable_for_bulk_annotation:
type: boolean
description: Flag to detect is project ready for bulk annotation
control_weights:
type:
- object
- 'null'
additionalProperties:
$ref: '#/components/schemas/ControlTagWeight'
description: Dict of weights for each control tag in metric calculation. Keys are control tag names from the labeling config. At least one tag must have a non-zero overall weight.
created_at:
type: string
format: date-time
created_by:
$ref: '#/components/schemas/UserSimple'
description: Project owner
custom_interface_code:
type:
- string
- 'null'
custom_interface_compiled:
type:
- string
- 'null'
custom_interface_params:
oneOf:
- description: Any type
- type: 'null'
custom_script:
type: string
description: Plugins
custom_task_lock_ttl:
type:
- integer
- 'null'
description: Task reservation time. TTL in seconds (UI displays and edits this value in minutes).
data_types:
type:
- object
- 'null'
additionalProperties:
description: Any type
description:
type:
- string
- 'null'
description: Description
description_short:
type: string
duplication_done:
type: boolean
default: false
duplication_status:
type: string
enable_empty_annotation:
type: boolean
description: Allow empty annotations
evaluate_predictions_automatically:
type: boolean
description: Retrieve and display predictions when loading a task
expert_instruction:
type:
- string
- 'null'
description: Instructions
finished_task_number:
type: integer
ground_truth_number:
type: integer
description: Honeypot annotation number in project
id:
type: integer
input_schema:
oneOf:
- description: Any type
- type: 'null'
is_dimensions_enabled:
type: string
is_draft:
type: boolean
description: Whether or not the project is in the middle of being created
is_published:
type: boolean
description: Whether or not the project is published to annotators
label_config:
type:
- string
- 'null'
description: Labeling Configuration
max_additional_annotators_assignable:
type:
- integer
- 'null'
description: Maximum additional annotators
maximum_annotations:
type: integer
description: Annotations per task
members:
type: string
members_count:
type: integer
min_annotations_to_start_training:
type: integer
description: Minimum number of completed tasks after which model training is started
model_version:
type:
- string
- 'null'
description: Machine learning model version
num_tasks_with_annotations:
type:
- integer
- 'null'
organization:
type:
- integer
- 'null'
overlap_cohort_percentage:
type: integer
description: Annotations per task coverage
parsed_label_config:
type: object
additionalProperties:
description: Any ty
# --- truncated at 32 KB (44 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/label-studio/refs/heads/main/openapi/label-studio-subpackage-prompts-api-openapi.yml