ROroxels
admin

Import Recorded Session

Import an externally-recorded conversation into the product as a closed session.

Creates: persons row → interviews row (imported_from set, status='completed') → sessions row (status='completed', transcript populated) → session_frames rows (S3-backed, source='imported').

Returns the created interview_id and session_id so the caller can deep-link to /dashboard/interviews/<interview_id>.

post/v1/admin/sessions/import-recorded

Request

Request body

template_idstring required

Template the imported conversation should be scoped to.

imported_fromstring required

Free-form provenance key, e.g. 'video:<job-slug>'. Required — this is what marks the conversation as imported.

person_namestring

Display name for the person row this interview hangs off.

person_emailstring nullable
leader_namestring nullable

Human label for the speaker mapped to the assistant lane (the one the AI would replicate). Stored on interview.context.

started_atstring nullable

ISO timestamp of when the original recording was made.

duration_secondsinteger nullable
metadataobject

Arbitrary metadata stored on interview.context.imported.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.