Skip to main content
GET
/
v1
/
rooms
/
{room_id}
/
messages
V1 Get Room Messages
curl --request GET \
  --url https://api.genova.gg/v1/rooms/{room_id}/messages \
  --header 'x-api-key: <x-api-key>'
{
  "items": [
    {
      "id": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "sender": {
        "room_id": "<string>",
        "user_id": "<string>",
        "client_user_id": "<string>",
        "character_id": "<string>",
        "name": "<string>"
      },
      "actions": [
        {
          "id": "<string>",
          "name": "<string>",
          "prompt": "<string>",
          "triggered": true
        }
      ],
      "contents": [
        {
          "streaming_status": "PROCESSING",
          "audio": {
            "message": {
              "audio_bytes": "<string>",
              "signature": "<string>",
              "transcription": "<string>",
              "url": "<string>"
            }
          },
          "system_input": {
            "message": "<string>"
          },
          "text": {
            "message": "<string>"
          }
        }
      ],
      "parent_message_id": "<string>",
      "recipients": [
        {
          "name": "<string>",
          "character_id": "<string>",
          "room_id": "<string>"
        }
      ],
      "replier": {
        "name": "<string>",
        "character_id": "<string>",
        "room_id": "<string>"
      },
      "room_id": "<string>",
      "token_usage": {
        "completion_tokens": 123,
        "prompt_tokens": 123,
        "total_tokens": 123
      }
    }
  ],
  "total": 1,
  "page": 2,
  "size": 2,
  "pages": 1
}

Headers

x-api-key
string
required

Path Parameters

room_id
string
required

Query Parameters

desc_order
boolean
default:true
page
integer
default:1

Page number

Required range: x >= 1
size
integer
default:50

Page size

Required range: 1 <= x <= 100

Response

Successful Response

items
Message · object[]
required
total
integer | null
required
Required range: x >= 0
page
integer | null
required
Required range: x >= 1
size
integer | null
required
Required range: x >= 1
pages
integer | null
Required range: x >= 0