PApalabra
Sessions v2

List sessions

Changed on

Returns sessions issued by your account, newest first. Sessions stay listed for three months after creation, whatever their status. Filter by your own client_reference_id to see everything issued for one customer or device. Responses never include token.

get/session-storage/v2/sessions

Request

  • Base URL
    https://api.palabra.ai
  • URL
    https://api.palabra.ai/session-storage/v2/sessions
  • Auth
    API key in header Authorization

Query parameters

client_reference_idstring

Return only sessions created with this reference.

status'pending' | 'active' | 'idle' | 'used' | 'expired' | 'revoked'
  • pending: issued, no stream opened yet, connect window still open
  • active: at least one stream is running
  • idle: reusable token that has been used before, no stream running, connect window still open
  • used: single-use token whose stream has finished; cannot be used again
  • expired: connect window has passed and no stream is running
  • revoked: revoked by you

Return only sessions in this state.

created_fromstring date-time

Return sessions created at or after this time.

created_tostring date-time

Return sessions created before this time.

page_sizeinteger

Number of sessions on one page.

page_tokenstring

Value of next_page_token from the previous page.

Response

Page of sessions.

oktrue required

Example response

{
  "data": {
    "sessions": [
      {
        "id": "ses_01K64W6F7C8MD2VP7ZQ9J3B5NR"
      }
    ]
  }
}

Changes