Skip to main content
GET
List messages

Authorizations

X-Api-Key
string
header
required

Headers

X-Workspace-Id
string
required

ワークスペースID

Query Parameters

limit
integer
default:30

1–100(デフォルト30)

Required range: 1 <= x <= 100
cursor
string

次ページ取得用カーソル

ids
string

メッセージIDでフィルタ(カンマ区切りで最大100件、OR条件)。 各要素は UUID 形式である必要があり、形式が違う場合は 400 になります。 指定した ID のうち取得可能なものだけが返ります。存在しない ID や 公開されていないメッセージの ID を含めてもエラーにはならず、結果から落ちます。 limit を指定しない場合は既定の 30 件で打ち切られます。100 件をまとめて取得する 場合は limit=100 も指定してください。指定しないときは page_info.has_next_page を見てページングしてください。

thread_id
string

スレッドIDで絞り込みます。同一スレッドのメッセージだけを時系列で取得できます。 空文字を指定した場合は 400 になります(絞り込みを要求しているため、未指定として 全件を返しません)。received_from / received_to も同じ扱いです。

received_from
string<date-time>

取得範囲の開始日時(以上)。ISO 8601 形式で指定してください。

received_to
string<date-time>

取得範囲の終了日時(以下)。ISO 8601 形式で指定してください。

Response

成功

data
object[]
required
page_info
object
required

v2 のカーソルページネーション情報。継続判定は has_next_page だけで行ってください。 v1 の pagination.next_cursor と異なり、end_cursor は最終ページでも null になりません。