List room messages

curl --request GET \
  --url https://developer.creao.ai/v1/rooms/{room_id}/messages \
  --header 'Authorization: Bearer <token>'

const url = 'https://developer.creao.ai/v1/rooms/{room_id}/messages';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

{
  "messages": [
    {
      "seq": 123,
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "kind": "post",
      "sender": {
        "kind": "user",
        "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "text": "<string>",
      "body": "<string>",
      "mentions": [
        {
          "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>"
        }
      ],
      "mentions_everyone": true,
      "reply_to_seq": 123,
      "root_seq": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "edited_at": "2023-11-07T05:31:56Z",
      "deleted": true,
      "origin": "web",
      "agent_run_id": "<string>",
      "system_type": "<string>",
      "attachments": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "mime": "<string>",
          "size": 123
        }
      ],
      "shortcut": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    }
  ],
  "updated": [
    {
      "seq": 123,
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "kind": "post",
      "sender": {
        "kind": "user",
        "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "text": "<string>",
      "body": "<string>",
      "mentions": [
        {
          "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>"
        }
      ],
      "mentions_everyone": true,
      "reply_to_seq": 123,
      "root_seq": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "edited_at": "2023-11-07T05:31:56Z",
      "deleted": true,
      "origin": "web",
      "agent_run_id": "<string>",
      "system_type": "<string>",
      "attachments": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "mime": "<string>",
          "size": 123
        }
      ],
      "shortcut": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    }
  ],
  "cursor_seq": 123,
  "has_more_before": true,
  "has_more_after": true,
  "last_seq": 123,
  "root": {
    "seq": 123,
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "kind": "post",
    "sender": {
      "kind": "user",
      "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    },
    "text": "<string>",
    "body": "<string>",
    "mentions": [
      {
        "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    ],
    "mentions_everyone": true,
    "reply_to_seq": 123,
    "root_seq": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "edited_at": "2023-11-07T05:31:56Z",
    "deleted": true,
    "origin": "web",
    "agent_run_id": "<string>",
    "system_type": "<string>",
    "attachments": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "mime": "<string>",
        "size": 123
      }
    ],
    "shortcut": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    }
  }
}

GET

rooms

{room_id}

messages

List room messages

curl --request GET \
  --url https://developer.creao.ai/v1/rooms/{room_id}/messages \
  --header 'Authorization: Bearer <token>'

const url = 'https://developer.creao.ai/v1/rooms/{room_id}/messages';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

{
  "messages": [
    {
      "seq": 123,
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "kind": "post",
      "sender": {
        "kind": "user",
        "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "text": "<string>",
      "body": "<string>",
      "mentions": [
        {
          "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>"
        }
      ],
      "mentions_everyone": true,
      "reply_to_seq": 123,
      "root_seq": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "edited_at": "2023-11-07T05:31:56Z",
      "deleted": true,
      "origin": "web",
      "agent_run_id": "<string>",
      "system_type": "<string>",
      "attachments": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "mime": "<string>",
          "size": 123
        }
      ],
      "shortcut": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    }
  ],
  "updated": [
    {
      "seq": 123,
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "kind": "post",
      "sender": {
        "kind": "user",
        "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "text": "<string>",
      "body": "<string>",
      "mentions": [
        {
          "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>"
        }
      ],
      "mentions_everyone": true,
      "reply_to_seq": 123,
      "root_seq": 123,
      "created_at": "2023-11-07T05:31:56Z",
      "edited_at": "2023-11-07T05:31:56Z",
      "deleted": true,
      "origin": "web",
      "agent_run_id": "<string>",
      "system_type": "<string>",
      "attachments": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "name": "<string>",
          "mime": "<string>",
          "size": 123
        }
      ],
      "shortcut": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    }
  ],
  "cursor_seq": 123,
  "has_more_before": true,
  "has_more_after": true,
  "last_seq": 123,
  "root": {
    "seq": 123,
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "kind": "post",
    "sender": {
      "kind": "user",
      "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    },
    "text": "<string>",
    "body": "<string>",
    "mentions": [
      {
        "member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      }
    ],
    "mentions_everyone": true,
    "reply_to_seq": 123,
    "root_seq": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "edited_at": "2023-11-07T05:31:56Z",
    "deleted": true,
    "origin": "web",
    "agent_run_id": "<string>",
    "system_type": "<string>",
    "attachments": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>",
        "mime": "<string>",
        "size": 123
      }
    ],
    "shortcut": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>"
    }
  }
}

Authorizations

Authorization

string

header

default:cr_sk_your_key_here

required

Account API key from Developer Console. Keys start with cr_sk_.

Path Parameters

room_id

string<uuid>

required

Room id. An id you cannot see answers ROOM_NOT_FOUND, like an unknown one.

Query Parameters

before

integer

Required range: x >= 0

after

integer

Required range: x >= 0

around

integer

Required range: x >= 0

limit

integer

default:50

Required range: 1 <= x <= 100

root

integer

A top-level message's seq; page its replies instead of the room. Any other seq is 400 ROOM_REPLY_ROOT_INVALID.

Required range: x >= 0

Response

A page of messages.

messages

object[]

required

Show child attributes

updated

object[]

required

Messages outside this page that an edit or delete inside it changed.

Show child attributes

cursor_seq

integer

required

Continue an after catch-up from here.

has_more_before

boolean

required

has_more_after

boolean

required

last_seq

integer

required

root

object

Show child attributes

Get Started

Agents

Agent Memory

Agent Files

Product Profile

Agent Runs

Super Agent

Account

Workspaces

Workspace Files

Secrets

Skills

Rooms

Concepts

List room messages

Authorizations

Path Parameters

Query Parameters

Response