Retrieve a record

Use retrieveARecord after obtaining an Insion record ID from moderation, ingestion, or listing. This is distinct from the application-owned clientId used for ingestion and deletion.

let response = try await client.retrieveARecord(recordId: "rec_123")
let record = response.data

print(record.name)
print(record.moderationPending)
print(record.moderationStatus)

Signature

func retrieveARecord(
    recordId: String,
    requestOptions: RequestOptions? = nil
) async throws -> RecordResponse

recordId is required and belongs in the path, not a request model. The response wraps the record in data. Its useful fields include id, clientId, name, entity, protected, metadata, creation/update dates, moderationPending, and optional moderation status/timestamps and associated user.

Several API fields use Nullable<T> to represent an explicit JSON null. Check those values carefully instead of treating them as guaranteed text or dates. A missing record or unauthorized access throws ApiError.httpError; use Errors and responses to inspect its status and category.

To find a record when you only know your own identifier, use List records with clientId and then retrieve by the returned id.