Read a channel's messages

GET /api/public/apps/v1/channels/{channelId}/messages

Needs the channels:history permission.

Newest first. When next_cursor is not null, pass it as cursor to read the next, older page.

Parameters

Name	In	Required	Meaning
`channelId`	path	yes	A channel the app belongs to.
`limit`	query	no	integer
`cursor`	query	no	The `next_cursor` of the previous page.

Example

curl "https://amedeus.app/api/public/apps/v1/channels/<channel id>/messages" \
  -H "Authorization: Bearer $TOKEN"

const response = await fetch("https://amedeus.app/api/public/apps/v1/channels/<channel id>/messages", {
  headers: { Authorization: `Bearer ${process.env.TOKEN}` },
});
const result = await response.json(); // { ok: true, … } or { ok: false, error, message }

import json
import os
import urllib.request

request = urllib.request.Request(
    "https://amedeus.app/api/public/apps/v1/channels/<channel id>/messages",
    headers={
        "Authorization": f"Bearer {os.environ['TOKEN']}",
        "User-Agent": "my-app/1.0",
    },
)
with urllib.request.urlopen(request) as response:
    result = json.load(response)  # a 4xx or 5xx raises urllib.error.HTTPError

Response

Field	Type	Required
`ok`	`true`	yes
`messages`	array of message	yes
`next_cursor`	uuid or null	yes

{
  "ok": true,
  "messages": [
    {
      "id": "52f4c823-8e7f-4349-bb98-1ac8683aad13",
      "channel": "52f4c823-8e7f-4349-bb98-1ac8683aad13",
      "user": "52f4c823-8e7f-4349-bb98-1ac8683aad13",
      "text": "…",
      "parent_id": null,
      "mentions": [
        "52f4c823-8e7f-4349-bb98-1ac8683aad13"
      ],
      "reply_count": 0,
      "created_at": "2026-11-12T19:18:43.527829+00:00",
      "edited_at": null
    }
  ],
  "next_cursor": null
}

Errors

Failures answer { "ok": false, "error": "<code>", "message": "…" }; see Errors.

400: The request isn’t valid.
401: The token is missing, wrong or revoked.
403: A missing scope (the message names it), or a channel the app isn’t in.
429: Slow down; Retry-After says for how many seconds.