Create task — API Reference

Create a new labeling task in Label Studio.

The data you provide depends on your labeling config and data type.

You will also need to provide a project ID. The project ID can be found in the URL when viewing the project in Label Studio, or you can retrieve all project IDs using List all projects.

Request

This endpoint expects an object.

datamap from strings to anyOptional

Task data dictionary with arbitrary keys and values

projectintegerOptional

Project ID

Response

This endpoint returns an object.

datamap from strings to any

User imported or uploaded data for a task. Data is formatted according to the project label config. You can find examples of data for your project on the Import page in the Label Studio Data Manager UI.

idintegerOptional

metamap from strings to anyOptional

Meta is user imported (uploaded) data and can be useful as input for an ML Backend for embeddings, advanced vectors, and other info. It is passed to ML during training/predicting steps.

created_atdatetimeOptional

Time a task was created

updated_atdatetimeOptional

Last time a task was updated

is_labeledbooleanOptional

True if the number of annotations for this task is greater than or equal to the number of maximum_completions for the project

overlapintegerOptional

Number of distinct annotators that processed the current task

inner_idintegerOptional

Internal task ID in the project, starts with 1

total_annotationsintegerOptional

Number of total annotations for the current task except cancelled annotations

cancelled_annotationsintegerOptional

Number of total cancelled annotations for the current task

total_predictionsintegerOptional

Number of total predictions for the current task

comment_countintegerOptional

Number of comments in the task including all annotations

unresolved_comment_countintegerOptional

Number of unresolved comments in the task including all annotations

last_comment_updated_atdatetimeOptional

When the last comment was updated

projectintegerOptional

Project ID for this task

updated_byoptional integer or optional list of maps from strings to anyOptional

Last annotator or reviewer who updated this task

file_uploadoptional string or optional integerOptional

Uploaded file used as data source for this task

comment_authorslist of integersOptional

Users who wrote comments

1	curl -X POST http://localhost:8080/api/tasks/ \
2	-H "Authorization: Token <api_key>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"data": {
6	"image": "https://example.com/image.jpg",
7	"text": "Hello, world!"
8	},
9	"project": 1
10	}'

1	{
2	"data": {
3	"image": "https://example.com/image.jpg",
4	"text": "Hello, AI!"
5	},
6	"id": 1,
7	"meta": {
8	"key": "value"
9	},
10	"created_at": "2024-06-18T23:45:46Z",
11	"updated_at": "2024-06-18T23:45:46Z",
12	"is_labeled": false,
13	"overlap": 1,
14	"inner_id": 1,
15	"total_annotations": 0,
16	"cancelled_annotations": 0,
17	"total_predictions": 0,
18	"comment_count": 0,
19	"unresolved_comment_count": 0,
20	"last_comment_updated_at": "2024-01-15T09:30:00Z",
21	"project": 1,
22	"updated_by": [
23	{
24	"user_id": 1
25	}
26	],
27	"file_upload": "42d46c4c-my-pic.jpeg",
28	"comment_authors": [
29	1
30	]
31	}