/record/{record_uuid}/{field_uuid}/{option_uuid}/{selected|unselected} | Open Data Repository

{
  "database_uuid": "ddc5e9ba834ad596cc31aebb1225",
  "internal_id": 781070,
  "record_name": "R260016",
  "record_uuid": "c00710bb4560d99280ee6b86a5fd",
  "template_uuid": "60231f230a3c7b73e0f0d1f1deea",
  "metadata_for_uuid": "",
  "_record_metadata": {
    "_create_date": "2026-04-04 00:48:02",
    "_update_date": "2026-06-26 04:32:24",
    "_create_auth": "Hexiong Yang",
    "_public_date": "2026-04-04 00:48:02"
  },
  "fields": [
    {
      "field_name": "Sample ID",
      "field_uuid": "b5973a5ac47ec4afd1db49e2b00f",
      "template_field_uuid": "3e2259d0039f2c5cc912b8f92681",
      "id": 7068,
      "_field_metadata": {
        "_public_date": "2024-02-07 16:30:03"
      },
      "value": 11429
    },
    {
      "field_name": "RRUFF ID",
      "field_uuid": "ee88404d73886150b59dd07cbb12",
      "template_field_uuid": "d0e7a8e1e42d8159008116130e86",
      "id": 7069,
      "_field_metadata": {
        "_public_date": "2024-02-07 16:30:03"
      },
      "value": 1
    },
    {
      "field_name": "Sample Source",
      "field_uuid": "56b4777019c9a0f4e692586f0d87",
      "template_field_uuid": "bc3190833be270253bbcb9a05515",
      "id": 7071,
      "_field_metadata": {
        "_public_date": "2024-02-07 16:30:03"
      },
      "value": 1
    },
    {
      "field_name": "Sample Owned by",
      "field_uuid": "e2b22fc6abedceff7684aa6005ce",
      "template_field_uuid": "e2023d57291bc73f14bf5539b880",
      "id": 7073,
      "_field_metadata": {
        "_public_date": "2024-02-07 16:30:04"
      },
      "value": 1
    },
    {
      "field_name": "Sample Description",
      "field_uuid": "e742f7288df2b103b29ebab58faa",
      "template_field_uuid": "52f39016c205f376373237b1d82a",
      "id": 7074,
      "_field_metadata": {
        "_public_date": "2024-02-07 16:30:04"
      },
      "value": 1
    },
    {
      "field_name": "Sample Locality",
      "field_uuid": "9ad6f78291e867858e8c84b6fba4",
      "template_field_uuid": "1eb33d935bd18e9a71cc11a8218d",
      "id": 7075,
      "_field_metadata": {
        "_public_date": "2024-02-07 16:30:04"
      },
      "value": 1
    }
  ],
  "records": []
}

Select / Unselect a Field Option on a Record

Sets the selected or unselected state of a specific option on a radio or checkbox/multi-select field for a given record. The desired action is encoded directly in the final path segment as the literal string selected or unselected.

HTTP Method & URL

PUT {{url}}/record/{record_uuid}/{field_uuid}/{option_uuid}/{selected|unselected}

Example:

PUT {{url}}/record/c00710bb4560d99280ee6b86a5fd/e4bd3c7024d12f5c80da99fffd63/6b40829ca6e77002513def5f7406/unselected

Path Parameters

Parameter	Type	Description
`record_uuid`	string	The UUID of the record whose field option is being updated.
`field_uuid`	string	The UUID of the field (must be a radio or checkbox/multi-select field type).
`option_uuid`	string	The UUID of the specific option to select or unselect.
`selected`	`unselected`	string (literal)

Authentication

Bearer Token — automatically set via a pre-request script.

The script uses the apiuser, apipass, and url environment variables to obtain and inject a JWT Bearer token into the request. Ensure these variables are set in the active environment before sending.

Request Body

None. This is a bodyless PUT request. All parameters are passed through the URL path. No Content-Type header or request body is required.

Supported Field Datatypes

This endpoint operates on the following ODR field types:

Radio buttons — Single-select fields where only one option may be selected at a time.
Checkbox / Multi-select — Fields that allow multiple options to be selected simultaneously; each option is toggled independently.

Behavior Notes

Radio fields: Selecting a new option automatically unselects the previously selected option. Only one option can be active at a time.
Checkbox / multi-select fields: Each option is toggled independently. Selecting one option does not affect the state of other options on the same field.
Idempotent unselect: Sending unselected for an option that is already unselected is a no-op — the request succeeds without changing any state.
Idempotent select: Sending selected for an option that is already selected is a no-op — the request succeeds without changing any state.

Response Behavior

Scenario	Expected Result
Option successfully selected or unselected	`200 OK` with a success response body.
Invalid `record_uuid`, `field_uuid`, or `option_uuid`	`404 Not Found` or appropriate error response.
Field type does not support option selection	Error response indicating incompatible field type.
Authentication failure (missing or invalid token)	`401 Unauthorized`.
Malformed URL / missing path segments	`400 Bad Request` or routing error.

## Select / Unselect a Field Option on a Record Sets the selected or unselected state of a specific option on a **radio** or **checkbox/multi-select** field for a given record. The desired action is encoded directly in the final path segment as the literal string `selected` or `unselected`. --- ## HTTP Method & URL ``` PUT {{url}}/record/{record_uuid}/{field_uuid}/{option_uuid}/{selected|unselected} ``` **Example:** ``` PUT {{url}}/record/c00710bb4560d99280ee6b86a5fd/e4bd3c7024d12f5c80da99fffd63/6b40829ca6e77002513def5f7406/unselected ``` --- ## Path Parameters | Parameter | Type | Description | | --- | --- | --- | | `record_uuid` | string | The UUID of the record whose field option is being updated. | | `field_uuid` | string | The UUID of the field (must be a radio or checkbox/multi-select field type). | | `option_uuid` | string | The UUID of the specific option to select or unselect. | | `selected` | `unselected` | string (literal) | --- ## Authentication **Bearer Token** — automatically set via a pre-request script. The script uses the `apiuser`, `apipass`, and `url` environment variables to obtain and inject a JWT Bearer token into the request. Ensure these variables are set in the active environment before sending. --- ## Request Body **None.** This is a bodyless PUT request. All parameters are passed through the URL path. No `Content-Type` header or request body is required. --- ## Supported Field Datatypes This endpoint operates on the following ODR field types: - **Radio buttons** — Single-select fields where only one option may be selected at a time. - **Checkbox / Multi-select** — Fields that allow multiple options to be selected simultaneously; each option is toggled independently. --- ## Behavior Notes - **Radio fields:** Selecting a new option automatically unselects the previously selected option. Only one option can be active at a time. - **Checkbox / multi-select fields:** Each option is toggled independently. Selecting one option does not affect the state of other options on the same field. - **Idempotent unselect:** Sending `unselected` for an option that is already unselected is a no-op — the request succeeds without changing any state. - **Idempotent select:** Sending `selected` for an option that is already selected is a no-op — the request succeeds without changing any state. --- ## Response Behavior | Scenario | Expected Result | | --- | --- | | Option successfully selected or unselected | `200 OK` with a success response body. | | Invalid `record_uuid`, `field_uuid`, or `option_uuid` | `404 Not Found` or appropriate error response. | | Field type does not support option selection | Error response indicating incompatible field type. | | Authentication failure (missing or invalid token) | `401 Unauthorized`. | | Malformed URL / missing path segments | `400 Bad Request` or routing error. |

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

Parameter

Type

Description

record_uuid

string

The UUID of the record whose field option is being updated.

field_uuid

string

The UUID of the field (must be a radio or checkbox/multi-select field type).

option_uuid

string

The UUID of the specific option to select or unselect.

selected

unselected

string (literal)

Behavior Notes

Radio fields: Selecting a new option automatically unselects the previously selected option. Only one option can be active at a time.

Checkbox / multi-select fields: Each option is toggled independently. Selecting one option does not affect the state of other options on the same field.

Idempotent unselect: Sending unselected for an option that is already unselected is a no-op — the request succeeds without changing any state.

Idempotent select: Sending selected for an option that is already selected is a no-op — the request succeeds without changing any state.

Response Behavior

Scenario	Expected Result
Option successfully selected or unselected	`200 OK` with a success response body.
Invalid `record_uuid`, `field_uuid`, or `option_uuid`	`404 Not Found` or appropriate error response.
Field type does not support option selection	Error response indicating incompatible field type.
Authentication failure (missing or invalid token)	`401 Unauthorized`.
Malformed URL / missing path segments	`400 Bad Request` or routing error.