InsionInsion
Ruby

Retrieve a record

Retrieve one record by its Insion record ID

response = client.retrieve_a_record(record_id: "rec_123")
record = response.data

record_id is required and is the Insion ID returned by moderation, ingestion, or list_records. RecordResponse#data contains the stored record and its moderation state.

Method shape

client.retrieve_a_record(record_id:, request_options: {})
KeywordRequiredDescription
record_idYesInsion record ID, such as the ID returned in an ingestion response.
request_optionsNoPer-request URL, headers, timeout, or additional parameters.

Use this method when you already know the Insion record ID and need its latest data. Use list_records instead when filtering by your own client_id or when traversing multiple records.

On this page