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

# Test Interview Now

> Start an instant test interview for demo purposes.

Creates a Google Meet link immediately and starts the interview bot
so you can experience what an actual interview session feels like.

This will:
1. Create a temporary "Test User" contact
2. Create an instant Google Calendar event with Meet link
3. Start the interview bot immediately (joins within seconds)
4. Return the meeting URL so you can join

Note: This is for testing/demo purposes. The contact will be marked
with a "test_" prefix and can be deleted afterward.



## OpenAPI

````yaml /openapi.json post /v1/interviews/{interview_id}/test-now
openapi: 3.1.0
info:
  title: Ontora API
  description: >-
    Ontora's public API. Covers interview campaigns, transcripts, synthesis
    reports, graph queries, webhooks, and workspace management. 


    **Authentication**: endpoints accept either a Clerk JWT (`Authorization:
    Bearer <token>`) or a workspace API key (`X-API-Key: ont_...`). Workspace
    keys are managed via `/v1/api-keys`.
  version: 0.1.0
servers: []
security:
  - ClerkJWT: []
  - WorkspaceApiKey: []
tags:
  - name: interviews
    description: Campaign CRUD, lifecycle, contacts, question sets.
  - name: campaign-insights
    description: Synthesis outputs — cartography, roadmap, personas, conversations.
  - name: interview-query
    description: Graph RAG query over campaign data.
  - name: interview-export
    description: Markdown / ZIP exports of transcripts and reports.
  - name: api-keys
    description: Manage workspace-scoped API keys for programmatic access.
  - name: webhook-endpoints
    description: Outbound webhook endpoints for automation.
  - name: booking
    description: Public self-scheduling endpoints for interview participants.
  - name: workspaces
    description: Workspace and membership management.
  - name: vaults
    description: Context vault management.
paths:
  /v1/interviews/{interview_id}/test-now:
    post:
      tags:
        - interviews
      summary: Test Interview Now
      description: |-
        Start an instant test interview for demo purposes.

        Creates a Google Meet link immediately and starts the interview bot
        so you can experience what an actual interview session feels like.

        This will:
        1. Create a temporary "Test User" contact
        2. Create an instant Google Calendar event with Meet link
        3. Start the interview bot immediately (joins within seconds)
        4. Return the meeting URL so you can join

        Note: This is for testing/demo purposes. The contact will be marked
        with a "test_" prefix and can be deleted afterward.
      operationId: test_interview_now_v1_interviews__interview_id__test_now_post
      parameters:
        - name: interview_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Interview Id
        - name: X-API-Key
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TestNowResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    TestNowResponse:
      properties:
        meeting_url:
          type: string
          title: Meeting Url
        contact_id:
          type: string
          format: uuid
          title: Contact Id
        conversation_id:
          type: string
          format: uuid
          title: Conversation Id
        message:
          type: string
          title: Message
      type: object
      required:
        - meeting_url
        - contact_id
        - conversation_id
        - message
      title: TestNowResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    ClerkJWT:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Clerk-issued RS256 JWT.
    WorkspaceApiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: 'Workspace-scoped API key (prefix: `ont_`).'
    HTTPBearer:
      type: http
      scheme: bearer

````