---
title: "Update a data point"
method: PATCH
path: "/v3/data_points/{identifier}"
tags: ["Deprecated End Points"]
deprecated: true
---

# Update a data point

`PATCH /v3/data_points/{identifier}`

> **Deprecated.**

Update data of a data point.

## Path parameters

- `identifier` string, required — Uniquely identify a data point.

## Request body

- DataPointUpdate
  - `name` string — Name of the data point.
  - `slug` string — A camelCase string that will be used as the key in the API response.
  - `description` string, nullable
  - `parent` string, nullable — The identifier of the parent data point if applicable.
  - `mappingDataSource` string, nullable — If populated, the model will learn to predict this field using the data source, rather than relying on fuzzy string matching.

## Response `200`

Successfully updated data point.

- DataPoint
  - `identifier` string, required — Uniquely identify a data point.
  - `name` string, required — Name of the data point.
  - `slug` string, required — A camelCase string that will be used as the key in the API response.
  - `description` string, nullable
  - `annotationContentType` 'text' | 'integer' | 'float' | 'decimal' | 'date' | 'datetime' | 'daterange' | 'boolean' | 'enum' | 'location' | 'phonenumber' | 'json' | 'table' | 'expectedremuneration' | 'jobtitle' | 'language' | 'skill' | 'yearsexperience' | 'group' | 'table_deprecated' | 'url' | 'image' | 'docclf', required — The different data types of annotations
  - `organization` Organization, required
    - `identifier` string, required — Uniquely identify an organization.
    - `name` string, required
    - `userRole` 'admin' | 'member', required
    - `avatar` string, nullable, required — URL of the organization's avatar.
    - `resthookSignatureKey` string, nullable, required — Used to sign webhook payloads so you can verify their integrity.
    - `isTrial` boolean, required
    - `validationToolConfig` object, nullable, required — Configuration of the embeddable validation tool.
      - `theme` ThemeConfig
        - `palette` object
          - `mode` 'light' | 'dark'
          - `background` union
            - string
            - object
              - …
          - `text` object
            - `primary` string
            - `secondary` string
            - `disabled` string
          - `divider` string
          - `primary` PaletteColorOptions
            - `main` string, required
            - `light` string
            - `dark` string
            - `contrastText` string
          - `secondary` PaletteColorOptions
            - `main` string, required
            - `light` string
            - `dark` string
            - `contrastText` string
          - `success` PaletteColorOptions
            - `main` string, required
            - `light` string
            - `dark` string
            - `contrastText` string
          - `annotation` PaletteColorOptions
            - `main` string, required
            - `light` string
            - `dark` string
            - `contrastText` string
          - `error` PaletteColorOptions
            - `main` string, required
            - `light` string
            - `dark` string
            - `contrastText` string
          - `info` PaletteColorOptions
            - `main` string, required
            - `light` string
            - `dark` string
            - `contrastText` string
          - `warning` PaletteColorOptions
            - `main` string, required
            - `light` string
            - `dark` string
            - `contrastText` string
        - `typography` object
          - `fontFamily` string
          - `fontSize` union
            - string
            - number
          - `fontWeightRegular` string
          - `fontWeightMedium` string
          - `fontWeightBold` string
        - `borderRadius` number
        - `fontUrl` string
      - `hideActions` boolean — Hide the confirm document button and other actions.
      - `hideCollection` boolean — Hide the collection selector.
      - `hideEditPages` boolean — Hide the edit pages button.
      - `hideExport` boolean — Hide the export menu.
      - `hideFilename` boolean — Hide the filename input.
      - `hideShowRawValues` boolean — Hide the toggle for showing raw annotation values.
      - `hideReject` boolean — Hide the reject document button.
      - `hideReparse` boolean — Hide the reparse button.
      - `hideRunOcr` boolean — Hide the run OCR button.
      - `hideTags` boolean — Hide the tags editor.
      - `hideWarnings` boolean — Hide the warnings panel.
      - `restrictDocumentSplitting` boolean — Disable the page editor after a document has been split once.
      - `disableCurrencyFormatting` boolean — Disable currency formatting of decimals values.
      - `disableEditDocumentMetadata` boolean — Disable editing document metadata. Makes the collection selector, filename input and tags editor read only.
      - `disableManualAnnotationEditing` boolean — Disable manual editing of annotation values via the validation popover.
      - `hideDocumentStatus` boolean — Hide the document status indicator in the toolbar.
    - `showCustomFieldCreation` boolean, required — Whether to show the custom field creation in the UI.
    - `allowDataSourceRecordCreation` boolean, required — Allow reviewers to create missing records from the data source selector. Keep disabled when data sources are managed by external system syncs.
  - `extractor` string, required — Uniquely identify an extractor.
  - `multiple` boolean
  - `noRect` boolean
  - `parent` string, nullable — The identifier of the parent data point if applicable.
  - `children` DataPoint[]
  - `availableDataSources` MappingDataSource[]
    - `identifier` string, required — Uniquely identify a mapping data source.
    - `name` string, nullable
    - `keyProperty` string, required — Attribute in the schema which uniquely identifiers the value
    - `displayProperty` string, required — Attribute in the schema which is used to display the value
    - `organization` string, nullable, required — The organization that this mapping data source belongs to.
    - `workspace` string, nullable, required — The workspace that this mapping data source belongs to.
    - `schema` object — The schema of the mapping data source.
  - `mappingDataSource` string, nullable — If populated, the model will learn to predict this field using the data source, rather than relying on fuzzy string matching.
  - `manualEntry` boolean — If true, the model will not be used to predict this data point. Instead, the user will be able to manually enter the value in the validation tool.

## Other responses

- `400` — Bad request. If it is a validation error will contain a list of each invalid field
- `401` — Authorisation error
- `default` — UnexpectedError

---

[API](https://skmtc.net/affinda/apis/affinda-api.md) · [All operations](https://skmtc.net/affinda/apis/affinda-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/affinda/affinda-api/versions/5f71e092a3e8/schema)