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

# Join Room

> Join an interview room as a respondent.

This is a public endpoint. Validates the room, records the
respondent email, and returns a LiveKit token for connection.

Parameters:
- access_token: The unique token from the interview URL
- email: Respondent's email address

Returns:
- LiveKit token and connection details



## OpenAPI

````yaml /api-reference/openapi-filtered.json post /api/interviews/join/{access_token}
openapi: 3.1.0
info:
  title: Aseed Insight API
  version: 0.1.0
servers:
  - url: https://app.aseed.ai/custdev
security: []
tags:
  - name: insight
    description: 'Core insight endpoints: records, transcripts, generation, and chat.'
    x-displayName: Insight
  - name: insight_public
    description: Public insight endpoints for shared/public access.
    x-displayName: Insight Public
  - name: projects
    description: Project management endpoints.
    x-displayName: Projects
  - name: project_reports
    description: Project report generation and management endpoints.
    x-displayName: Project Reports
  - name: project_reports_public
    description: Public project report endpoints.
    x-displayName: Project Reports Public
  - name: prompts
    description: Custom prompts management endpoints.
    x-displayName: Prompts
  - name: presets
    description: Presets and templates endpoints.
    x-displayName: Presets
  - name: agent
    description: AI agent threads and chat endpoints.
    x-displayName: Agent
  - name: interviews
    description: AI interviewer room and session endpoints.
    x-displayName: Interviews
  - name: webhooks
    description: Incoming webhook endpoints.
    x-displayName: Webhooks
paths:
  /api/interviews/join/{access_token}:
    post:
      tags:
        - interviews
      summary: Join Room
      description: |-
        Join an interview room as a respondent.

        This is a public endpoint. Validates the room, records the
        respondent email, and returns a LiveKit token for connection.

        Parameters:
        - access_token: The unique token from the interview URL
        - email: Respondent's email address

        Returns:
        - LiveKit token and connection details
      operationId: join_room_api_interviews_join__access_token__post
      parameters:
        - name: access_token
          in: path
          required: true
          schema:
            type: string
            title: Access Token
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/JoinRoomRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/JoinRoomResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    JoinRoomRequest:
      properties:
        email:
          type: string
          format: email
          title: Email
      type: object
      required:
        - email
      title: JoinRoomRequest
      description: Request model for joining an interview room.
    JoinRoomResponse:
      properties:
        token:
          type: string
          title: Token
        url:
          type: string
          title: Url
        room_name:
          type: string
          title: Room Name
        max_duration_minutes:
          type: integer
          title: Max Duration Minutes
      type: object
      required:
        - token
        - url
        - room_name
        - max_duration_minutes
      title: JoinRoomResponse
      description: Response model for joining an interview room.
    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
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````