Activity Logs1

Analytics8

Annotation History4

Annotation Reviews6

Annotations7

AWS1

Background Jobs3

Billing1

Blueprints4

Comments7

Dashboard1

Data Explorer4

Data Manager12

Dataset Storage: Azure9

Dataset Storage: GCS9

Dataset Storage: S39

Datasets17

Dimensions15

Export8

Import8

Interfaces13

Invites1

JWT7

Labels11

Learning Resources36

LLM1

Machine Learning10

Model Provider Connection7

Organizations34

Pauses6

Predictions6

Project Roles4

Project Templates7

Projects37

Prompts38

Review Routing Rules2

Session Policy2

SSO7

States12

Stats25

Storage6

Storage: Azure14

Storage: Azure SPI14

Storage: Databricks Files14

Storage: GCS14

Storage: GCS SA14

Storage: GCS WIF14

Storage: Local14

Storage: Redis14

Storage: S314

Storage: S3 Roles14

Task Events1

Tasks11

Users12

Versions1

Webhooks7

Workspaces14

Annotations

Create annotation

Changed on Aug 7, 2026

    Add annotations to a task like an annotator does. The content of the result field depends on your
    labeling configuration. For example, send the following data as part of your POST
    request to send an empty annotation with the ID of the user who completed the task:

    ```json
    {
    "result": {},
    "was_cancelled": true,
    "ground_truth": true,
    "lead_time": 0,
    "task": 0
    "completed_by": 123
    }
    ```

post/api/tasks/{id}/annotations/

Request

Base URL
http://localhost:8000
URL
http://localhost:8000/api/tasks/{id}/annotations/
Auth
API key in header Authorization

Path parameters

idinteger required

Task ID

Request body

bulk_createdboolean nullable

Annotation was created in bulk mode

completed_byinteger

draft_created_atstring date-time nullable

Draft creation time

ground_truthboolean

This annotation is a Ground Truth (ground_truth)

import_idinteger nullable

Original annotation ID that was at the import step or NULL if this annotation wasn't imported

prediction - Created from prediction
propagated_annotation - Created from another annotation
imported - Imported
submitted - Submitted
updated - Updated
skipped - Skipped
accepted - Accepted
rejected - Rejected
fixed_and_accepted - Fixed and accepted
deleted_review - Deleted review

last_created_byinteger nullable

User who created the last annotation history item

lead_timenumber double nullable

How much time it took to annotate the task

parent_annotationinteger nullable

Points to the parent annotation from which this annotation was created

parent_predictioninteger nullable

Points to the prediction from which this annotation was created

projectinteger nullable

Project ID for this annotation

resultobject[]

List of annotation results for the task

taskinteger nullable

Corresponding task for this annotation

unique_idstring

updated_byinteger nullable

Last user who updated this annotation

was_cancelledboolean

User skipped the task

Response

Created annotation