Codestin Search App

Create a new task

Authentication

Authorizationstring

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>

Request

This endpoint expects an object.

dataanyRequired

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.

allow_skipboolean or nullOptional

Whether this task can be skipped. Set to False to make task unskippable.

cancelled_annotationsintegerOptional-2147483648-2147483647

Number of total cancelled annotations for the current task

comment_authorslist of integersOptional

Users who wrote comments

comment_countintegerOptional-2147483648-2147483647

Number of comments in the task including all annotations

file_uploadinteger or nullOptional

Uploaded file used as data source for this task

inner_idlong or nullOptional-9223372036854776000-9223372036854776000

Internal task ID in the project, starts with 1

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

last_comment_updated_atdatetime or nullOptional

When the last comment was updated

metaany or nullOptional

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.

overlapintegerOptional-2147483648-2147483647

Number of distinct annotators that processed the current task

projectinteger or nullOptional

Project ID for this task

total_annotationsintegerOptional-2147483648-2147483647

Number of total annotations for the current task except cancelled annotations

total_predictionsintegerOptional-2147483648-2147483647

Number of total predictions for the current task

unresolved_comment_countintegerOptional-2147483648-2147483647

Number of unresolved comments in the task including all annotations

updated_byinteger or nullOptional

Last annotator or reviewer who updated this task

Response

agreementstring

agreement_selectedstring

annotation_timeinteger

Calculate total annotation time for this task from MetricInTimeBucket records. Returns time in seconds.

annotationsstring

annotations_idsstring

annotations_resultsstring

annotatorslist of integers

Annotators IDs who annotated this task

annotators_countinteger

The annotators_count is calculated as the number of users with annotations (can be repeated, so same as the number of annotations) + the number of assignees without annotations.

comment_authorslist of maps from strings to any

comment_authors_countinteger

commentsstring

created_atdatetime

Time a task was created

dataany

draftslist of objects

Drafts for this task

file_uploadstring

idinteger

predictionslist of objects

Predictions for this task

predictions_model_versionsstring

predictions_resultsstring

review_timeinteger

Calculate total review time for this task from MetricInTimeBucket records. Returns time in seconds.

reviewerslist of maps from strings to any

reviewers_countinteger

statestring

storage_filenamestring

updated_atdatetime

Last time a task was updated

updated_bylist of objects

User IDs who updated this task

allow_skipboolean or null

Whether this task can be skipped. Set to False to make task unskippable.

avg_lead_timedouble or null

cancelled_annotationsinteger or null

comment_countinteger or null-2147483648-2147483647

Number of comments in the task including all annotations

completed_atdatetime or null

draft_existsboolean or null

ground_truthboolean or null

inner_idinteger or null

is_labeledboolean or null

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

last_comment_updated_atdatetime or null

When the last comment was updated

metaany or null

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.

overlapinteger or null-2147483648-2147483647

Number of distinct annotators that processed the current task

precomputed_agreementdouble or null

Average agreement score for the task

predictions_scoredouble or null

projectinteger or null

Project ID for this task

reviewedboolean or null

reviews_acceptedinteger or null

reviews_rejectedinteger or null

total_annotationsinteger or null

total_predictionsinteger or null

unresolved_comment_countinteger or null-2147483648-2147483647

Number of unresolved comments in the task including all annotations

1	from label_studio_sdk import LabelStudio
2
3	client = LabelStudio(
4	base_url="http://localhost:8000",
5	api_key=
6	)
7
8	client.tasks.create(
9	data=,
10	project=42
11	)

1	{
2	"agreement": "0.85",
3	"agreement_selected": "0.90",
4	"annotation_time": 360,
5	"annotations": "[{\"result\": [{\"id\": \"1\", \"type\": \"label\", \"value\": {\"labels\": [\"Cat\"]}}]}]",
6	"annotations_ids": "[1, 2, 3]",
7	"annotations_results": "[{\"id\": 1, \"result\": [{\"type\": \"label\", \"value\": {\"labels\": [\"Dog\"]}}]}]",
8	"annotators": [
9	101,
10	102
11	],
12	"annotators_count": 2,
13	"comment_authors": [
14	{}
15	],
16	"comment_authors_count": 3,
17	"comments": "[{\"id\": 1, \"text\": \"Please review this annotation.\"}]",
18	"created_at": "2024-04-18T10:00:00Z",
19	"data": null,
20	"drafts": [
21	{
22	"created_at": "2024-04-19T12:00:00Z",
23	"result": [
24	{}
25	],
26	"updated_at": "2024-04-19T12:30:00Z"
27	}
28	],
29	"file_upload": "12345",
30	"id": 9876,
31	"predictions": [
32	{
33	"created_at": "2024-04-19T11:00:00Z",
34	"model": {},
35	"model_run": {},
36	"model_version": "v1.2.3",
37	"project": 42,
38	"result": [
39	{}
40	],
41	"score": 0.92,
42	"task": 9876,
43	"updated_at": "2024-04-19T11:30:00Z"
44	}
45	],
46	"predictions_model_versions": "v1.2.3",
47	"predictions_results": "[{\"result\": [{\"type\": \"label\", \"value\": {\"labels\": [\"Car\"]}}]}]",
48	"review_time": 120,
49	"reviewers": [
50	{}
51	],
52	"reviewers_count": 1,
53	"state": "completed",
54	"storage_filename": "task_9876_data.json",
55	"updated_at": "2024-04-20T16:00:00Z",
56	"updated_by": [
57	{}
58	],
59	"allow_skip": false,
60	"avg_lead_time": 245.5,
61	"cancelled_annotations": 0,
62	"comment_count": 5,
63	"completed_at": "2024-04-20T15:45:00Z",
64	"draft_exists": false,
65	"ground_truth": false,
66	"inner_id": 15,
67	"is_labeled": true,
68	"last_comment_updated_at": "2024-04-20T14:00:00Z",
69	"meta": null,
70	"overlap": 2,
71	"precomputed_agreement": 0.88,
72	"predictions_score": 0.92,
73	"project": 42,
74	"reviewed": true,
75	"reviews_accepted": 3,
76	"reviews_rejected": 0,
77	"total_annotations": 4,
78	"total_predictions": 2,
79	"unresolved_comment_count": 1
80	}