Skip to content

Rippling: Retrieve record details — response body — fields value data type: RADIO, value state: PRESENT, EMPTY, MASKED, UNSUPPORTED

Retrieve record details: response body, field fields / value / data_type: RADIO, value_state: PRESENT, EMPTY, MASKED, UNSUPPORTED. Complete fields and constraints for contract 2026-10-28.

API reference · Contract 2026-10-28

SDK schema: Retrieve record details — response body — fields / value / data_type: RADIO, value state: PRESENT, EMPTY, MASKED, UNSUPPORTED

FieldTypePresenceDescription and constraints
$objectRootA readable record field and the caller’s ability to edit it.
api_namestringRequired within parentField key used by layout placements and canonical record PATCH changes. Direct keys come from the Custom Object field definition; dotted related keys are read-only.
data_typestringRequired within parentRADIO contains one configured choice.
Known values: RADIO
editablebooleanRequired within parentWhether this caller can edit this field on this record.
labelstringRequired within parentField display name.
multiplebooleanRequired within parentWhether this field accepts multiple selections. True for SELECT; false for RADIO and scalar references.
optionsarrayRequired within parentConfigured choice values; empty for non-choice fields.
options[]stringEach item
read_only_reasonJSONOptional
read_only_reason (anyOf 1)stringAlternativePERMISSION_DENIED means record or field update access is absent; RECORD_LOCKED blocks changes; IMMUTABLE identifies an unchangeable field; MANAGED_OR_DERIVED identifies a system-maintained value; UNSUPPORTED_EDITOR means this API has no editor for the type; MASKED withholds a restricted value; REFERENCE_UNAVAILABLE means the reference target is unsupported or unreadable. Null when editable.
Known values: PERMISSION_DENIED, RECORD_LOCKED, IMMUTABLE, MANAGED_OR_DERIVED, UNSUPPORTED_EDITOR, MASKED, REFERENCE_UNAVAILABLE
read_only_reason (anyOf 2)nullAlternative
reference_objectJSONOptional
reference_object (anyOf 1)stringAlternativeTarget collection for a supported reference: workers or a Custom Object API name ending in __c. Null for other fields and unsupported reference targets.
reference_object (anyOf 2)nullAlternative
requiredbooleanRequired within parentWhether a nonempty value is required by the field schema.
valueJSONRequired within parent
value (anyOf 1)stringAlternativeOne value from options; null unless value_state is PRESENT.
value (anyOf 2)nullAlternative
value_statestringRequired within parentPRESENT includes a readable value; EMPTY is an unset field; MASKED withholds a restricted value; UNSUPPORTED withholds a value whose type this API cannot represent. Only PRESENT contains a non-null value; an empty multichoice is an empty array.
Known values: PRESENT, EMPTY, MASKED, UNSUPPORTED

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.