Begin a spoken interview with one of your end-users, or hand back one they have not finished with.

BCP-47-ish language code (e.g. 'en', 'zh-cn') for localized messages.

The end-user's username.

The end-user's password on first sign-in. After login/register, send the returned session token (JWT) here instead — the field accepts either, and reusing the token keeps raw passwords out of your storage.

Ask for a consciousness by name instead of writing up an interview: returns the third-person description of that consciousness, if one has been produced. Any authenticated caller may ask. Only the third-person form is available this way; the first- and second-person forms address the interviewee and are theirs alone.

AI consciousness id as returned by clone operations.

Which question set to run. mind_upload_first_time is a long first-run interview whose write-up is meant for a mind-data upload; memory_refresh and personality_refresh are short repeatable ones that ask something different each time; matchmaking surfaces what someone values; guided_reflection gives them somewhere to think out loud, and is not counseling.

Optional. Which voice the interviewer speaks in, one of the voices a start returns. Sending it keeps it for this consciousness, and an interview in progress answers with its current question spoken in it, so the voice is heard as it is chosen. Left out, the consciousness keeps the voice it has.

Optional. The interview a voice_id is for. With it, the call only switches that interview's voice while it is in progress, and is refused once it has ended rather than starting or resuming another.

Whether the call succeeded.

Human-readable reason when success is false.

Identifies one interview. Returned by start_voice_interview and required by every later call.

Which question set to run.

Which question this call is about. Send back the one you were last given; it makes the call safe to retry.

The question the user is being asked, in the interview language.

A time-limited URL for the spoken question. Play it to the user.

Media type of the question audio, so a player can be chosen without sniffing.

How far through the interview the user is, from 0 to 1.

True when there are no further questions and the write-up can be requested.

True when this picked up an interview the user had already started rather than beginning a new one.

Where the interview itself stands: in_progress while there are questions left, completed once the write-up can be asked for, aborted when the user ended it and the transcript was discarded, and halted_for_safety when an answer suggested the person needed help rather than another question -- on which show safety_message and stop asking. The new first interview instead uses safety_paused: its earlier confirmed answers are kept, the triggering answer is excluded, and questions remain paused.

The voice this consciousness's interviews speak in now.

Present only on an interview made of spoken lines. Which chapter the question is in.

Present only on an interview made of spoken lines. The chapter's title, in the interview language.

Present only on an interview made of spoken lines. Where the chapter comes, counting from 0; a new value means a new chapter has begun.

Present only on an interview made of spoken lines. How many chapters it has.

Present only on an interview made of spoken lines. Roughly how many minutes of answering are left, rounded up, from how long this user's answers have taken so far; 0 once it has ended.

Present only on an interview made of spoken lines. How the user accepts the transcript of their answer to the question: auto lets it through after a short pause unless they touch it, and confirm waits for them, as for a name or a date of birth, and for every answer once they have corrected one. Null when nothing is asked.

Present only when the interview stopped because an answer suggested the person needed help rather than another question. Show it, and do not continue the interview.