API ReferenceProjects

Create new project

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>"}'

Headers

AuthorizationstringRequired

Header authentication of the form Token <token>

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

idinteger or null
Project ID
titlestring or null
Project title
descriptionstring or null
Project description
label_configstring or null
Label config in XML format
expert_instructionstring or null
Labeling instructions to show to the user
show_instructionboolean or null
Show labeling instructions
show_skip_buttonboolean or null
Show skip button
enable_empty_annotationboolean or null
Allow empty annotations
show_annotation_historyboolean or null
Show annotation history
reveal_preannotations_interactivelyboolean or null
Reveal preannotations interactively. If set to True, predictions will be shown to the user only after selecting the area of interest
show_collab_predictionsboolean or null
Show predictions to annotators
maximum_annotationsinteger or null
Maximum annotations per task
colorstring or nullDefaults to #FFFFFF
Project color in HEX format
control_weightsmap from strings to any or null

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}}