/record/{record_uuid}/{field_uuid}/value | Open Data Repository

Update Field Value

Updates the stored value for a specific field on a given record. This endpoint supports multiple datatypes that use the value parameter, including Short Text, Long Text, Integer, Decimal, and Paragraph/Markdown fields.

HTTP Method & URL

POST {{url}}/record/{record_uuid}/{field_uuid}/value

Path Parameters

Parameter	Type	Description
`record_uuid`	string (UUID)	The unique identifier of the record to update.
`field_uuid`	string (UUID)	The unique identifier of the field whose value should be updated.

Authentication

This endpoint requires a Bearer token. The token is set automatically via a pre-request script using the following environment variables:

Variable	Description
`apiuser`	The API username used to authenticate.
`apipass`	The API password used to authenticate.
`url`	The base URL of the ODR API.

The pre-request script exchanges these credentials for a JWT, which is then attached as the Authorization: Bearer <token> header on the request.

Request Body

Content-Type: application/json

{
    "value": "123445"
}

Field	Type	Required	Description
`value`	string	Yes	The new value to store in the field. The format depends on the target datatype (e.g., a numeric string for Integer/Decimal fields, plain text for Short/Long Text). To clear an existing value, pass an empty string: `""`.

Supported Datatypes

This endpoint applies to any field that stores its data using the value parameter, including:

Short Text
Long Text
Integer
Decimal
Paragraph (plain text)
Markdown

Response Behavior

Scenario	Expected Response
Successful update	`200 OK` — The field value has been updated on the record.
Invalid `record_uuid` or `field_uuid`	`404 Not Found` — The specified record or field does not exist.
Unauthorized / missing token	`401 Unauthorized` — The Bearer token is missing, expired, or invalid.
Malformed request body	`400 Bad Request` — The request body is missing or not valid JSON.
Datatype mismatch	`400 Bad Request` — The provided value is incompatible with the field’s datatype (e.g., passing a non-numeric string to an Integer field).

## Update Field Value Updates the stored value for a specific field on a given record. This endpoint supports multiple datatypes that use the `value` parameter, including Short Text, Long Text, Integer, Decimal, and Paragraph/Markdown fields. --- ### HTTP Method & URL ``` POST {{url}}/record/{record_uuid}/{field_uuid}/value ``` --- ### Path Parameters | Parameter | Type | Description | |---|---|---| | `record_uuid` | string (UUID) | The unique identifier of the record to update. | | `field_uuid` | string (UUID) | The unique identifier of the field whose value should be updated. | --- ### Authentication This endpoint requires a **Bearer token**. The token is set automatically via a pre-request script using the following environment variables: | Variable | Description | |---|---| | `apiuser` | The API username used to authenticate. | | `apipass` | The API password used to authenticate. | | `url` | The base URL of the ODR API. | The pre-request script exchanges these credentials for a JWT, which is then attached as the `Authorization: Bearer <token>` header on the request. --- ### Request Body **Content-Type:** `application/json` ```json { "value": "123445" } ``` | Field | Type | Required | Description | |---|---|---|---| | `value` | string | Yes | The new value to store in the field. The format depends on the target datatype (e.g., a numeric string for Integer/Decimal fields, plain text for Short/Long Text). To **clear** an existing value, pass an empty string: `""`. | --- ### Supported Datatypes This endpoint applies to any field that stores its data using the `value` parameter, including: - **Short Text** - **Long Text** - **Integer** - **Decimal** - **Paragraph** (plain text) - **Markdown** --- ### Response Behavior | Scenario | Expected Response | |---|---| | Successful update | `200 OK` — The field value has been updated on the record. | | Invalid `record_uuid` or `field_uuid` | `404 Not Found` — The specified record or field does not exist. | | Unauthorized / missing token | `401 Unauthorized` — The Bearer token is missing, expired, or invalid. | | Malformed request body | `400 Bad Request` — The request body is missing or not valid JSON. | | Datatype mismatch | `400 Bad Request` — The provided value is incompatible with the field's datatype (e.g., passing a non-numeric string to an Integer field). |

Request

This endpoint expects an object.

valuestringRequired

Response headers

Access-Control-Allow-OriginstringOptional

Access-Control-Allow-MethodsstringOptional

Access-Control-Allow-HeadersstringOptional

Access-Control-Expose-HeadersstringOptional

Access-Control-Max-AgestringOptional

Cache-ControlstringOptional

X-Debug-TokenstringOptional

X-Debug-Token-LinkstringOptional

Keep-AlivestringOptional

Response

database_uuidstring

internal_idinteger

record_namestring

record_uuidstring

template_uuidstring

metadata_for_uuidstring

_record_metadataobject

fieldslist of objects

recordslist of any