Create annotation

POST

http://localhost:8000/api/tasks/:id/annotations/

POST

/api/tasks/:id/annotations/

curl -X POST http://localhost:8000/api/tasks/1/annotations/ \
     -H "Authorization: Token  <api_key>" \
     -H "Content-Type: application/json" \
     -d '{}'

201response

{
  "created_ago": "",
  "created_at": "2024-06-18T23:45:46.048490Z",
  "created_username": "",
  "id": 1,
  "state": "CREATED",
  "updated_at": "2024-06-18T23:45:46.048538Z",
  "completed_by": 1,
  "ground_truth": false,
  "lead_time": 10,
  "project": 1,
  "result": [
    {
      "from_name": "bboxes",
      "image_rotation": 0,
      "original_height": 1080,
      "original_width": 1920,
      "to_name": "image",
      "type": "rectanglelabels",
      "value": {
        "height": 60,
        "rotation": 0,
        "values": {
          "rectanglelabels": [
            "Person"
          ]
        },
        "width": 50,
        "x": 20,
        "y": 30
      }
    }
  ],
  "task": 1,
  "updated_by": 1,
  "was_cancelled": false
}

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

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

Authentication

AuthorizationToken

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>

Path parameters

idintegerRequired

Task ID

Request

This endpoint expects an object.

bulk_createdboolean or nullOptional

Annotation was created in bulk mode

completed_byintegerOptional

draft_created_atdatetime or nullOptional

Draft creation time

ground_truthbooleanOptional

This annotation is a Ground Truth (ground_truth)

import_idlong or nullOptional-9223372036854776000-9223372036854776000

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

last_actionenum or nullOptional

Action which was performed in the last annotation history item

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 or nullOptional

User who created the last annotation history item

lead_timedouble or nullOptional

How much time it took to annotate the task

parent_annotationinteger or nullOptional

Points to the parent annotation from which this annotation was created

parent_predictioninteger or nullOptional

Points to the prediction from which this annotation was created

projectinteger or nullOptional

Project ID for this annotation

resultlist of objectsOptional

List of annotation results for the task

taskinteger or nullOptional

Corresponding task for this annotation

unique_idstringOptional>=1 character

updated_byinteger or nullOptional

Last user who updated this annotation

was_cancelledbooleanOptional

User skipped the task

Response

Created annotation

created_agostringRead-onlyDefaults to

Time delta from creation time

created_atdatetimeRead-only

Creation time

created_usernamestringRead-onlyDefaults to

Username string

idintegerRead-only

statestringRead-only

updated_atdatetimeRead-only

Last updated time