v77

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-045764591.5 MB

Projects

List project tasks

        Retrieve a paginated list of tasks for a specific project. For example, use the following cURL command:
        ```bash
        curl -X GET http://localhost:8000/api/projects/{id}/tasks/?page=1&page_size=10 -H 'Authorization: Token abc123'
        ```

get/api/projects/{id}/tasks/

Path parameters

idinteger required

A unique integer value identifying this project.

Query parameters

orderingstring

Which field to use when ordering the results.

pageinteger

[or "start"] current page

page_sizeinteger

[or "length"] tasks per page, use -1 to obtain all tasks (in this case "page" has no effect and this operation might be slow)

Response

cancelled_annotationsinteger

Number of total cancelled annotations for the current task

comment_authorsinteger[]

Users who wrote comments

comment_countinteger

Number of comments in the task including all annotations

created_atstring date-time required

Time a task was created

{"stackTrail":"components:schemas:TaskSimple:properties:data","oasType":"schema","type":"unknown","description":"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."}

file_uploadinteger nullable

Uploaded file used as data source for this task

idinteger required

inner_idinteger nullable

Internal task ID in the project, starts with 1

is_labeledboolean

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_atstring date-time nullable

When the last comment was updated

{"stackTrail":"components:schemas:TaskSimple:properties:meta","oasType":"schema","type":"unknown","description":"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.","nullable":true}

overlapinteger

Number of distinct annotators that processed the current task

projectinteger nullable

Project ID for this task

total_annotationsinteger

Number of total annotations for the current task except cancelled annotations

total_predictionsinteger

Number of total predictions for the current task

unresolved_comment_countinteger

Number of unresolved comments in the task including all annotations

updated_atstring date-time required

Last time a task was updated

updated_byinteger nullable

Last annotator or reviewer who updated this task