✨ Create project from template

POST

http://localhost:8000/api/project-templates/:id/create-project

POST

/api/project-templates/:id/create-project

$ curl -X POST http://localhost:8000/api/project-templates/1/create-project \
>      -H "Authorization: Token  <api_key>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "title": "string"
> }'

201Created

1 {
2   "assignment_settings": {
3     "id": 1,
4     "label_stream_task_distribution": "auto_distribution",
5     "project": 1
6   },
7   "config_has_control_tags": true,
8   "config_suitable_for_bulk_annotation": true,
9   "created_at": "2024-01-15T09:30:00Z",
10   "data_types": {},
11   "finished_task_number": 1,
12   "ground_truth_number": 1,
13   "id": 1,
14   "internal_description": [
15     null
16   ],
17   "is_dimensions_enabled": true,
18   "members": [
19     {}
20   ],
21   "members_count": 1,
22   "num_tasks_with_annotations": 1,
23   "parsed_label_config": {},
24   "permissions": [
25     "string"
26   ],
27   "prompts": [
28     {}
29   ],
30   "queue_done": 1,
31   "queue_left": 1,
32   "queue_total": 1,
33   "review_settings": {
34     "id": 1,
35     "requeue_rejected_tasks_to_annotator": true,
36     "annotator_batch_percent": "string",
37     "anonymize_annotations": true,
38     "instruction": "string",
39     "only_finished_tasks": true,
40     "project": 1,
41     "requeue_rejected_tasks_mode": "requeue",
42     "require_comment_on_reject": true,
43     "review_criteria": "all",
44     "review_only_manual_assignments": true,
45     "review_task_limit_percent": "string",
46     "sampling": "task_id",
47     "show_agreement_to_reviewers": true,
48     "show_data_manager_to_reviewers": true,
49     "show_instruction": true,
50     "show_unused_data_columns_to_reviewers": true
51   },
52   "reviewer_queue_total": 1,
53   "skipped_annotations_number": 1,
54   "start_training_on_annotation_update": true,
55   "state": "string",
56   "task_number": 1,
57   "total_annotations_number": 1,
58   "total_predictions_number": 1,
59   "useful_annotation_number": 1,
60   "workspace": 1,
61   "workspace_title": "string",
62   "agreement_methodology": "consensus",
63   "agreement_threshold": "string",
64   "annotation_limit_count": 1,
65   "annotation_limit_percent": "string",
66   "annotator_evaluation_continuous_tasks": 0,
67   "annotator_evaluation_enabled": true,
68   "annotator_evaluation_metric": "gt_agreement",
69   "annotator_evaluation_minimum_score": "95.00",
70   "annotator_evaluation_minimum_tasks": 10,
71   "annotator_evaluation_onboarding_tasks": 0,
72   "color": "string",
73   "comment_classification_config": "string",
74   "control_weights": {},
75   "created_by": {
76     "avatar": "string",
77     "id": 1,
78     "username": "string",
79     "email": "string",
80     "first_name": "string",
81     "last_name": "string"
82   },
83   "custom_interface_code": "string",
84   "custom_interface_compiled": "string",
85   "custom_interface_params": null,
86   "custom_script": "string",
87   "custom_task_lock_ttl": 1,
88   "description": "string",
89   "duplication_done": false,
90   "duplication_status": "string",
91   "enable_empty_annotation": true,
92   "evaluate_predictions_automatically": true,
93   "expert_instruction": "string",
94   "input_schema": null,
95   "is_draft": true,
96   "is_published": true,
97   "label_config": "string",
98   "max_additional_annotators_assignable": 1,
99   "maximum_annotations": 1,
100   "min_annotations_to_start_training": 1,
101   "model_version": "string",
102   "organization": 1,
103   "output_schema": null,
104   "overlap_cohort_percentage": 1,
105   "pause_on_failed_annotator_evaluation": false,
106   "pinned_at": "2024-01-15T09:30:00Z",
107   "require_comment_on_skip": false,
108   "reveal_preannotations_interactively": true,
109   "sampling": "Sequential sampling",
110   "show_annotation_history": true,
111   "show_collab_predictions": true,
112   "show_instruction": true,
113   "show_overlap_first": true,
114   "show_skip_button": true,
115   "show_unused_data_columns_to_annotators": true,
116   "skip_queue": "REQUEUE_FOR_ME",
117   "source_interface_id": 1,
118   "source_interface_version": 1,
119   "strict_task_overlap": true,
120   "task_data_login": "string",
121   "task_data_password": "string",
122   "title": "string",
123   "use_custom_interface": false,
124   "show_ground_truth_first": true
125 }

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

Create a project from a specific project template by ID for an organization.

<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> Create a project from a specific project template by ID for an organization.

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

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

idintegerRequired

Request

This endpoint expects an object.

titlestringRequired>=1 character

The title of the project to be created from the template.

descriptionstring or nullOptional

A description for the project.

workspace_idintegerOptional

A unique integer value identifying the workspace in which to create the project.

Response

Project created successfully

assignment_settingsobject

config_has_control_tagsbooleanRead-only

Flag to detect is project ready for labeling

config_suitable_for_bulk_annotationbooleanRead-only

Flag to detect is project ready for bulk annotation

created_atdatetimeRead-only

data_typesmap from strings to any or nullRead-only

finished_task_numberintegerRead-only

Finished tasks

ground_truth_numberintegerRead-only

Honeypot annotation number in project

idintegerRead-only

internal_descriptionlist of any or nullRead-only

Description (Internal)

is_dimensions_enabledbooleanRead-only

memberslist of maps from strings to anyRead-only

members_countintegerRead-only

num_tasks_with_annotationsinteger or nullRead-only

parsed_label_configmap from strings to anyRead-only

JSON-formatted labeling configuration

permissionslist of stringsRead-only

promptslist of maps from strings to any or nullRead-only

queue_doneintegerRead-only

queue_leftintegerRead-only

queue_totalintegerRead-only

review_settingsobject

reviewer_queue_totalintegerRead-only

skipped_annotations_numberintegerRead-only

Skipped by collaborators annotation number in project

start_training_on_annotation_updatebooleanRead-only

Start model training after any annotations are submitted or updated

statestringRead-only

task_numberintegerRead-only

Total task number in project

total_annotations_numberintegerRead-only

Total annotations number in project including skipped_annotations_number and ground_truth_number.

total_predictions_numberintegerRead-only

Total predictions number in project including skipped_annotations_number, ground_truth_number, and useful_annotation_number.

useful_annotation_numberintegerRead-only

Useful annotation number in project not including skipped_annotations_number and ground_truth_number. Total annotations = annotation_number + skipped_annotations_number + ground_truth_number

workspaceintegerRead-only

workspace_titlestring or nullRead-only

agreement_methodologyenumOptionalDefaults to pairwise

Methodology (Consensus / Pairwise Averaging)

consensus - Consensus
pairwise - Pairwise Averaging

agreement_thresholdstring or nullOptionalformat: "decimal"

Agreement threshold

annotation_limit_countinteger or nullOptional>=1

Limit by number of tasks

annotation_limit_percentstring or nullOptionalformat: "decimal"

Limit by percentage of tasks

annotator_evaluation_continuous_tasksintegerOptional>=0Defaults to 0

Continuous Evaluation: Required tasks

annotator_evaluation_enabledbooleanOptional

Evaluate all annotators against ground truth

annotator_evaluation_metricenum or nullOptionalDefaults to gt_agreement

Metric used to evaluate annotators. Defaults to gt_agreement.

gt_agreement - Ground truth agreement
acceptance_score - Acceptance score
rejection_rate - Rejection rate

annotator_evaluation_minimum_scorestring or nullOptionalformat: "decimal"Defaults to 95.00

Score required to pass evaluation

annotator_evaluation_minimum_tasksinteger or nullOptional>=0Defaults to 10

Number of tasks for evaluation

annotator_evaluation_onboarding_tasksintegerOptional>=0Defaults to 0

Onboarding Evaluation: Required tasks

colorstring or nullOptional<=16 characters

Color

comment_classification_configstringOptional

control_weightsmap from strings to objects or nullOptional

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_byobjectOptional

Project owner

custom_interface_codestring or nullOptional

custom_interface_compiledstring or nullOptional

custom_interface_paramsany or nullOptional

custom_scriptstringOptional

Plugins

custom_task_lock_ttlinteger or nullOptional1-86400

Task reservation time. TTL in seconds (UI displays and edits this value in minutes).

descriptionstring or nullOptional

Description (Public)

duplication_donebooleanOptionalDefaults to false

duplication_statusstringOptional

enable_empty_annotationbooleanOptional

Allow empty annotations

evaluate_predictions_automaticallybooleanOptional

Retrieve and display predictions when loading a task

expert_instructionstring or nullOptional

Instructions

input_schemaany or nullOptional

is_draftbooleanOptional

Whether or not the project is in the middle of being created

is_publishedbooleanOptional

Whether or not the project is published to annotators

label_configstring or nullOptional

Labeling Configuration

max_additional_annotators_assignableinteger or nullOptional

Maximum additional annotators

maximum_annotationsintegerOptional-2147483648-2147483647

Annotations per task

min_annotations_to_start_trainingintegerOptional-2147483648-2147483647

Minimum number of completed tasks after which model training is started

model_versionstring or nullOptional

Machine learning model version

organizationinteger or nullOptional

output_schemaany or nullOptional

overlap_cohort_percentageintegerOptional-2147483648-2147483647

Annotations per task coverage

pause_on_failed_annotator_evaluationboolean or nullOptionalDefaults to false

Pause annotator on failed evaluation

pinned_atdatetime or nullOptional

Pinned date and time

require_comment_on_skipbooleanOptionalDefaults to false

Require comment to skip

reveal_preannotations_interactivelybooleanOptional

Reveal pre-annotations interactively

samplingenum or nullOptional

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)

show_annotation_historybooleanOptional

Show Data Manager to Annotators

show_collab_predictionsbooleanOptional

Use predictions to pre-label Tasks

show_instructionbooleanOptional

Show instructions before labeling

show_overlap_firstbooleanOptional

Show tasks with overlap first

show_skip_buttonbooleanOptional

Allow skipping tasks

show_unused_data_columns_to_annotatorsboolean or nullOptional

Show only columns used in labeling configuration to Annotators. API uses inverse field semantics here: set false to show only used columns, set true to show all task.data columns.

skip_queueenum or nullOptional

REQUEUE_FOR_ME - Requeue for me
REQUEUE_FOR_OTHERS - Requeue for others
IGNORE_SKIPPED - Ignore skipped

source_interface_idinteger or nullOptional

source_interface_versioninteger or nullOptional

Stable version ID of the saved interface snapshot used by this project.

strict_task_overlapbooleanOptionalDefaults to true

Enforce strict overlap limit

task_data_loginstring or nullOptional<=256 characters

task_data_passwordstring or nullOptional<=256 characters

Password

titlestring or nullOptional3-50 characters

Project Name

use_custom_interfacebooleanOptionalDefaults to false

show_ground_truth_firstbooleanOptionalDeprecated

Onboarding mode (true): show ground truth tasks first in the labeling stream