Skip to navigation

/record/{record_uuid}/{field_uuid}/value

View as Markdown

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

ParameterTypeDescription
record_uuidstring (UUID)The unique identifier of the record to update.
field_uuidstring (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:

VariableDescription
apiuserThe API username used to authenticate.
apipassThe API password used to authenticate.
urlThe 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"
}
FieldTypeRequiredDescription
valuestringYesThe 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

ScenarioExpected Response
Successful update200 OK — The field value has been updated on the record.
Invalid record_uuid or field_uuid404 Not Found — The specified record or field does not exist.
Unauthorized / missing token401 Unauthorized — The Bearer token is missing, expired, or invalid.
Malformed request body400 Bad Request — The request body is missing or not valid JSON.
Datatype mismatch400 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
Keep-AlivestringOptional

Response

OK
database_uuidstring
internal_idinteger
record_namestring
record_uuidstring
template_uuidstring
metadata_for_uuidstring
_record_metadataobject
fieldslist of objects
recordslist of any