> ## Documentation Index
> Fetch the complete documentation index at: https://docs.exterview.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Instant Interviews (Voice / Avatar)

> The on-demand AI interview flow: trigger and read back the AI interview report.

<Warning>
  Blocked from publishing until the auth and gating checklist in [Authentication
  & Scopes](/get-started/authentication) lands. Documented here ahead of that so
  the surface is defined.
</Warning>

<Note>
  **Naming note.** There is no separate `instantInterview` operation. "Instant
  Interview" is the product name for the on-demand AI interview flow below, run
  in `VOICE` or `AVATAR` mode via `startAiInterview(mode)`.
</Note>

## Purpose

Instant Interviews cover the on-demand AI interview: invite a candidate, run the interview in voice or avatar mode, and read back the structured report.

## Trigger and drive

| Type     | Operation                                                                    |
| -------- | ---------------------------------------------------------------------------- |
| Mutation | `sendAiInterviewInvites(input)`                                              |
| Mutation | `startAiInterview(candidateId, mode)` with `mode` set to `VOICE` or `AVATAR` |
| Mutation | `endAiInterview(candidateId, thumbnailUrl)`                                  |
| Mutation | `reanalyzeAiInterview(candidateId)`                                          |
| Query    | `aiInterviewDeadline(candidateId)`                                           |

## Read back the AI output

| Type  | Operation                            |
| ----- | ------------------------------------ |
| Query | `aiInterviewReport(candidateId)`     |
| Query | `voiceInterviewReport(candidateId)`  |
| Query | `avatarInterviewReport(candidateId)` |

## Not published

**Candidate-runtime and first-party only:** `generateAiInterviewTurn`, `appendAiInterviewTranscript`, `uploadCandidateImage`, `sendInterviewOtp`, `verifyInterviewOtp`, `submitInterviewFeedback`. These are live in-session plumbing and identity-verification steps for first-party clients, not partner integration surface.

**Internal-only:** `orgVoiceAgentConfig`, `orgAvatarAgentConfig`, `orgInterviewAgentConfig` and their `update*` mutations. Org agent configuration, documented for internal use but not in this public deployment.

## FAQs

<AccordionGroup>
  <Accordion title="Is there an instantInterview operation?">
    No. Instant Interview is the product name for the on-demand flow. You run it with `startAiInterview` in `VOICE` or `AVATAR` mode.
  </Accordion>

  <Accordion title="What is the difference between voice and avatar mode?">
    Voice runs an audio-only interview; avatar adds a video presenter. Both
    produce their own read-back report.
  </Accordion>

  <Accordion title="Which report do we read after the interview?">
    Use `aiInterviewReport` for the combined result, or the mode-specific
    `voiceInterviewReport` and `avatarInterviewReport`.
  </Accordion>

  <Accordion title="Why are some operations not published?">
    Candidate-runtime and org-configuration operations are first-party or internal. They are not part of the partner integration surface.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="EX Phone Screen" icon="phone" href="/walkthroughs/ex-phone-screen">
    The phone-screen counterpart to the voice and avatar flow.
  </Card>

  <Card title="Session Types" icon="layer-group" href="/deploy/session-types">
    How these map to deployable session types.
  </Card>
</CardGroup>