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

# A room's history

> Every occupancy of the room, newest first: when it ran, how many were in it at most, who was in it with their roles and times, and whether a recording exists (has_recording, recording_bytes). Paged.



## OpenAPI

````yaml /api-reference/openapi-public.json get /conference-rooms/{id}/sessions
openapi: 3.0.3
info:
  description: >-
    The API your own systems use: place and follow calls, have an AI agent call
    someone, run campaigns and get their results, keep contacts in step with
    your CRM, and receive signed webhooks. Authenticate with an integration key
    (Authorization: Bearer ft_...), used only from the IP addresses it allows.
  title: FireTone API
  version: 0.1.0
servers:
  - description: Your platform's API host
    url: https://{host}/api/v1
    variables:
      host:
        default: api.firet.one
security:
  - bearerAuth: []
tags:
  - name: Auth
  - description: >-
      Live calls and what can be done to them: hang up, hold, transfer, park,
      merge, monitor, whisper; the Desk's own call.
    name: Calls
  - description: 'Outbound campaigns: contacts, attempts, outcomes.'
    name: Campaigns
  - description: 'Customers: who called, what is known about them, and their memory.'
    name: Contacts
  - description: What was said on an AI call, and the review of it.
    name: Conversations
  - description: >-
      Your own systems: HTTP connections an IVR calls mid-call, and webhooks for
      call events. Tenant URLs must be public https addresses.
    name: Integrations
  - name: Live
  - name: Provisioning
  - name: Reporting
  - description: Tickets raised by people, agents and the API.
    name: Tickets
  - description: Messages left for an extension or a queue.
    name: Voicemail
paths:
  /conference-rooms/{id}/sessions:
    get:
      tags:
        - Provisioning
      summary: A room's history
      description: >-
        Every occupancy of the room, newest first: when it ran, how many were in
        it at most, who was in it with their roles and times, and whether a
        recording exists (has_recording, recording_bytes). Paged.
      operationId: getConferenceRoomsIdSessions
      parameters:
        - in: path
          name: id
          required: true
          schema:
            format: uuid
            type: string
        - $ref: '#/components/parameters/limit'
        - $ref: '#/components/parameters/offset'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConferenceSessionPage'
          description: The room's sessions, newest first.
        '404':
          description: Not found.
components:
  parameters:
    limit:
      in: query
      name: limit
      schema:
        default: 50
        maximum: 500
        type: integer
    offset:
      in: query
      name: offset
      schema:
        default: 0
        type: integer
  schemas:
    ConferenceSessionPage:
      properties:
        items:
          items:
            $ref: '#/components/schemas/ConferenceSession'
          type: array
        limit:
          type: integer
        offset:
          type: integer
        total:
          type: integer
      type: object
    ConferenceSession:
      description: 'One occupancy of a room: from the first member seated to the room''s end.'
      properties:
        ended_at:
          format: date-time
          nullable: true
          type: string
        has_recording:
          type: boolean
        id:
          format: uuid
          type: string
        invites:
          description: The default members and how each invitation went.
          items:
            properties:
              attempts:
                type: integer
              last_reason:
                type: string
              name:
                type: string
              number:
                type: string
              role:
                enum:
                  - participant
                  - moderator
                type: string
              round:
                description: >-
                  1, or one more for each time the member dropped off and was
                  rung again.
                type: integer
              state:
                enum:
                  - pending
                  - ringing
                  - joined
                  - gave_up
                type: string
            type: object
          type: array
        participants:
          items:
            properties:
              caller:
                type: string
              joined_at:
                format: date-time
                type: string
              left_at:
                format: date-time
                nullable: true
                type: string
              role:
                enum:
                  - participant
                  - moderator
                type: string
            type: object
          type: array
        peak_members:
          type: integer
        recording_bytes:
          type: integer
        started_at:
          format: date-time
          type: string
      required:
        - id
        - started_at
        - peak_members
        - has_recording
        - recording_bytes
        - participants
        - invites
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: JWT or API key
      description: >-
        Every request sends `Authorization: Bearer <token>`. The token is either
        a panel session (a JWT from /auth/login, 12 hours) or an API key
        `ft_<id>_<secret>`. An API key is accepted only from an address on its
        IP allowlist (403 ip_not_allowed otherwise; 403 ip_allowlist_required
        for an old key that has none), is limited to its rate per minute (429
        rate_limited with Retry-After; X-RateLimit-Limit/Remaining/Reset on
        every response), and at most 60 call placements a minute.
      scheme: bearer
      type: http

````