InsionInsion
Rust

Retrieve a record

Fetch one stored record by its Insion record ID.

Use retrieve_a_record with the Insion id returned from moderation, ingestion, or listing. It takes a borrowed &str, not a request struct.

let response = client.retrieve_a_record("rec_123", None).await?;
let record = response.data;

println!("{} ({})", record.name, record.entity);
println!("pending: {}", record.moderation_pending);

Signature and response

async fn retrieve_a_record(
    &self,
    record_id: &str,
    options: Option<RequestOptions>,
) -> Result<RecordResponse, ApiError>

The response wraps a Record in data. Fields include identifiers, URL, name/entity, protection state, metadata, creation/update times, optional moderation status/timestamps, the moderation_pending flag, and optional associated user ID. Optional fields use Option<T> and must be handled before use.

If you know only your own client_id, use List records with the client-ID filter first. A bad or inaccessible record ID returns ApiError rather than an empty optional response.

On this page