> ## 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.

# Create Rooms

> Create interview rooms for a project.

Creates one or more interview rooms linked to a project.
Each room gets a unique access token for the respondent URL.

Parameters:
- project_id: UUID of the project (required)
- count: Number of rooms to create (default: 1, max: 100)
- max_duration_minutes: Maximum interview duration (default: 30)
- expires_in_days: Days until room links expire (default: 7)

Returns:
- List of created rooms with their URLs



## OpenAPI

````yaml /api-reference/openapi-filtered.json post /api/interviews/rooms
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/rooms:
    post:
      tags:
        - interviews
      summary: Create Rooms
      description: |-
        Create interview rooms for a project.

        Creates one or more interview rooms linked to a project.
        Each room gets a unique access token for the respondent URL.

        Parameters:
        - project_id: UUID of the project (required)
        - count: Number of rooms to create (default: 1, max: 100)
        - max_duration_minutes: Maximum interview duration (default: 30)
        - expires_in_days: Days until room links expire (default: 7)

        Returns:
        - List of created rooms with their URLs
      operationId: create_rooms_api_interviews_rooms_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateRoomsRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateRoomsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - HTTPBearer: []
components:
  schemas:
    CreateRoomsRequest:
      properties:
        project_id:
          type: string
          format: uuid
          title: Project Id
        count:
          type: integer
          title: Count
          default: 1
        max_duration_minutes:
          type: integer
          title: Max Duration Minutes
          default: 30
        expires_in_days:
          type: integer
          title: Expires In Days
          default: 7
        voice:
          anyOf:
            - type: string
            - type: 'null'
          title: Voice
        realtime_provider:
          anyOf:
            - type: string
            - type: 'null'
          title: Realtime Provider
        language:
          anyOf:
            - type: string
            - type: 'null'
          title: Language
        topics_for_respondent:
          anyOf:
            - type: string
            - type: 'null'
          title: Topics For Respondent
      type: object
      required:
        - project_id
      title: CreateRoomsRequest
      description: Request model for creating interview rooms.
    CreateRoomsResponse:
      properties:
        rooms:
          items:
            $ref: '#/components/schemas/InterviewRoomResponse'
          type: array
          title: Rooms
      type: object
      required:
        - rooms
      title: CreateRoomsResponse
      description: Response model for room creation.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    InterviewRoomResponse:
      properties:
        id:
          type: string
          title: Id
        project_id:
          type: string
          title: Project Id
        record_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Record Id
        access_token:
          type: string
          title: Access Token
        url:
          type: string
          title: Url
        room_name:
          type: string
          title: Room Name
        respondent_email:
          anyOf:
            - type: string
            - type: 'null'
          title: Respondent Email
        max_duration_minutes:
          type: integer
          title: Max Duration Minutes
        research_goals_override:
          anyOf:
            - type: string
            - type: 'null'
          title: Research Goals Override
        interview_guide_override:
          anyOf:
            - type: string
            - type: 'null'
          title: Interview Guide Override
        status:
          type: string
          title: Status
        created_at:
          type: string
          format: date-time
          title: Created At
        started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Started At
        finished_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Finished At
        expires_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Expires At
        created_by:
          type: string
          title: Created By
        voice:
          anyOf:
            - type: string
            - type: 'null'
          title: Voice
        realtime_provider:
          anyOf:
            - type: string
            - type: 'null'
          title: Realtime Provider
        language:
          anyOf:
            - type: string
            - type: 'null'
          title: Language
        topics_for_respondent:
          anyOf:
            - type: string
            - type: 'null'
          title: Topics For Respondent
        display_name:
          anyOf:
            - type: string
              maxLength: 42
            - type: 'null'
          title: Display Name
      type: object
      required:
        - id
        - project_id
        - access_token
        - url
        - room_name
        - max_duration_minutes
        - status
        - created_at
        - created_by
      title: InterviewRoomResponse
      description: Response model for interview room details.
    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
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````