Create new project

POST

Create a project and set up the labeling interface. For more information about setting up projects, see the following:

$curl -H Content-Type:application/json -H 'Authorization: Token abc123' -X POST 'https://localhost:8080/api/projects' --data '{"label_config": "<View>[...]</View>"}'

Request

This endpoint expects an object.
titlestringOptional

Project title

descriptionstringOptional

Project description

label_configstringOptional

Label config in XML format

expert_instructionstringOptional

Labeling instructions to show to the user

show_instructionbooleanOptional

Show labeling instructions

show_skip_buttonbooleanOptional

Show skip button

enable_empty_annotationbooleanOptional

Allow empty annotations

show_annotation_historybooleanOptional

Show annotation history

reveal_preannotations_interactivelybooleanOptional

Reveal preannotations interactively. If set to True, predictions will be shown to the user only after selecting the area of interest

show_collab_predictionsbooleanOptional

Show predictions to annotators

maximum_annotationsintegerOptional

Maximum annotations per task

colorstringOptionalDefaults to #FFFFFF

Project color in HEX format

control_weightsmap from strings to anyOptional
Dict of weights for each control tag in metric calculation. Each control tag (e.g. label or choice) will have its own key in control weight dict with weight for each label and overall weight. For example, if a bounding box annotation with a control tag named my_bbox should be included with 0.33 weight in agreement calculation, and the first label Car should be twice as important as Airplane, then you need to specify: {'my_bbox': {'type': 'RectangleLabels', 'labels': {'Car': 1.0, 'Airplane': 0.5}, 'overall': 0.33}
workspaceintegerOptional

Workspace ID

model_versionstringOptional

Model version

Response

This endpoint returns an object.
titlestringOptional

Project title

descriptionstringOptional

Project description

label_configstringOptional

Label config in XML format

expert_instructionstringOptional

Labeling instructions to show to the user

show_instructionbooleanOptional

Show labeling instructions

show_skip_buttonbooleanOptional

Show skip button

enable_empty_annotationbooleanOptional

Allow empty annotations

show_annotation_historybooleanOptional

Show annotation history

reveal_preannotations_interactivelybooleanOptional

Reveal preannotations interactively. If set to True, predictions will be shown to the user only after selecting the area of interest

show_collab_predictionsbooleanOptional

Show predictions to annotators

maximum_annotationsintegerOptional

Maximum annotations per task

colorstringOptionalDefaults to #FFFFFF

Project color in HEX format

control_weightsmap from strings to anyOptional
Dict of weights for each control tag in metric calculation. Each control tag (e.g. label or choice) will have its own key in control weight dict with weight for each label and overall weight. For example, if a bounding box annotation with a control tag named my_bbox should be included with 0.33 weight in agreement calculation, and the first label Car should be twice as important as Airplane, then you need to specify: {'my_bbox': {'type': 'RectangleLabels', 'labels': {'Car': 1.0, 'Airplane': 0.5}, 'overall': 0.33}