ConversationList

  • items
    Type: array object[] · Items
    required

    A conversation record — metadata and lifecycle, without its transcript.

    • conversation_id
      Type: string · Conversation Id
      required

      Stable identifier for the conversation.

    • medium
      Type: string · Medium
      required

      Communication medium, e.g. voice.

    • status
      Type: string · Status
      required

      open while a session is live; closed once the last session ends.

    • configuration_ids
      Type: array string[] · Configuration Ids

      Distinct configuration ids active over the conversation.

    • created_at
      Type: string · Created Atnullable
    • ended_at
      Type: string · Ended Atnullable

      When the last session ended (ISO 8601); absent while open.

    • source_sessions
      Type: array string[] · Source Sessions

      Session ids that produced turns.

    • started_at
      Type: string · Started Atnullable

      When the earliest session started (ISO 8601).

    • transport_key
      Type: string · Transport Keynullable

      Medium-native key: the telephony call_id for voice.

    • turn_count
      Type: integer · Turn Count

      Total turns written to the transcript.

    • updated_at
      Type: string · Updated Atnullable
    • usage
      Type: object · ConversationUsage
    • user_id
      Type: string · User Idnullable

      End-user identifier, if supplied.

  • next_cursor
    Type: string · Next Cursornullable

    Opaque keyset cursor — pass as cursor to fetch the next page. null on the last page.