PATCH
/
v3
/
annotations
/
{id}
Update an annotation
curl --request PATCH \
  --url https://{region}.affinda.com/v3/annotations/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "rectangles": [
    {
      "pageIndex": 1,
      "x0": 2.43,
      "y0": 4.55,
      "x1": 4.56,
      "y1": 6.32
    }
  ],
  "document": "<string>",
  "pageIndex": 0,
  "raw": "<string>",
  "parsed": "<string>",
  "isClientVerified": true,
  "dataPoint": "<string>",
  "field": "<string>",
  "parent": 123,
  "validationResults": [
    {
      "created": [
        {
          "id": 1,
          "annotations": [
            1,
            2,
            3
          ],
          "passed": true,
          "ruleSlug": "supplier-name-is-alphanumeric",
          "message": "Expected '\''ThisInputShouldMatch'\'' to match regex pattern '\''[0-9]*",
          "document": "<string>"
        }
      ],
      "updated": [
        {
          "id": 1,
          "annotations": [
            1,
            2,
            3
          ],
          "passed": true,
          "ruleSlug": "supplier-name-is-alphanumeric",
          "message": "Expected '\''ThisInputShouldMatch'\'' to match regex pattern '\''[0-9]*",
          "document": "<string>"
        }
      ],
      "deleted": [
        {
          "id": 1,
          "annotations": [
            1,
            2,
            3
          ],
          "passed": true,
          "ruleSlug": "supplier-name-is-alphanumeric",
          "message": "Expected '\''ThisInputShouldMatch'\'' to match regex pattern '\''[0-9]*",
          "document": "<string>"
        }
      ]
    }
  ]
}'
{
  "id": 1,
  "rectangle": {
    "pageIndex": 1,
    "x0": 2.43,
    "y0": 4.55,
    "x1": 4.56,
    "y1": 6.32
  },
  "rectangles": [
    {
      "pageIndex": 1,
      "x0": 2.43,
      "y0": 4.55,
      "x1": 4.56,
      "y1": 6.32
    }
  ],
  "document": "<string>",
  "pageIndex": 0,
  "raw": "<string>",
  "confidence": 0.86,
  "classificationConfidence": 0.95,
  "textExtractionConfidence": 0.9,
  "isVerified": true,
  "isClientVerified": true,
  "isAutoVerified": true,
  "dataPoint": "<string>",
  "field": "<string>",
  "contentType": "text",
  "parent": 123
}

Authorizations

Authorization
string
header
required

Basic authentication using an API key, e.g. {Authorization: Bearer aff_0bb4fbdf97b7e4111ff6c0015471094155f91}. You can find your API key within the Settings page of the Affinda web app. You can obtain an API key by signing up for a free trial.

Path Parameters

id
integer
required

Annotation's ID

Required range: x >= 1
Example:

1

Body

application/json

Annotation data to update

rectangles
object[]

x/y coordinates for the rectangles containing the data. An annotation can be contained within multiple rectangles.

document
string

Unique identifier for the document

pageIndex
integer | null

The page number within the document, starting from 0.

Required range: x >= 0
Example:

0

raw
string | null

Raw data extracted from the before any post-processing

parsed
isClientVerified
boolean

Indicates whether the data has been validated by a human

dataPoint
string

Data point's identifier

field
string | null

Field's identifier

parent
integer | null

The parent annotation's ID

validationResults
array

The validation results created, changed or deleted as a result of updating the annotation.

Response

Successfully updated annotation data.

id
integer
required

Annotation's ID

Required range: x >= 1
Example:

1

rectangle
object
required

x/y coordinates for the rectangular bounding box containing the data

rectangles
object[]
required

x/y coordinates for the rectangles containing the data. An annotation can be contained within multiple rectangles.

document
string
required

Unique identifier for the document

pageIndex
integer | null
required

The page number within the document, starting from 0.

Required range: x >= 0
Example:

0

raw
string | null
required

Raw data extracted from the before any post-processing

confidence
number | null
required

The overall confidence that the model's prediction is correct

Example:

0.86

classificationConfidence
number | null
required

The model's confidence that the text has been classified correctly

Example:

0.95

textExtractionConfidence
number | null
required

If the document was submitted as an image, this is the confidence that the text in the image has been correctly read by the model

Example:

0.9

isVerified
boolean
required

Indicates whether the data has been validated, either by a human using our validation tool or through auto-validation rules

isClientVerified
boolean
required

Indicates whether the data has been validated by a human

isAutoVerified
boolean
required

Indicates whether the data has been auto-validated

contentType
enum<string>
required

The different data types of annotations

Available options:
text,
integer,
float,
decimal,
date,
datetime,
daterange,
boolean,
enum,
location,
phonenumber,
json,
table,
expectedremuneration,
jobtitle,
language,
skill,
yearsexperience,
group,
table_deprecated,
url,
image,
docclf
dataPoint
string

Data point's identifier

field
string | null

Field's identifier

parent
integer | null

The parent annotation's ID