Skip to content
GAMPEONCreate
New project

Messages of a channel

GET
/v1/communities/{id}/channels/{channelId}/messages
curl --request GET \
--url https://api.gampeon.com/v1/communities/1/channels/1/messages \
--header 'Authorization: Bearer <token>'

Without parameters the newest page (oldest first inside the page); before loads older pages. For updates, poll every 2 to 5 seconds with updatedSince set to now from the previous answer: you get new, edited and removed messages since then (removed ones as placeholders). Slow down or stop polling while the window is hidden.

Not available with access tokens.

id
required
integer
>= 1

Community ID

channelId
required
integer
>= 1

Channel ID

before
integer
>= 1

Message ID: only older messages

updatedSince
integer

Time from now of the last answer

limit
integer
>= 1 <= 100

1 to 100 (default 50)

Messages

Media typeapplication/json
object
messages
required
Array
One of:
object
id
required
integer
channelId
required
integer
author
required
One of:
object
handle
required
string
/^[a-z0-9_]{3,24}$/
displayName
required
string
avatar
required
One of:

Image path under /v1/media/ (studio logo or project key art)

string
body
required
string
replyTo
required
One of:
One of:
object
id
required
integer
author
required
One of:
object
handle
required
string
displayName
required
string
excerpt
required
string
mentions
required

Handles mentioned with @

Array<string>
createdAt
required

Unix time in milliseconds

integer format: int64
updatedAt
required

Unix time in milliseconds

integer format: int64
editedAt
required
One of:

Unix time in milliseconds

integer format: int64
hasMore
required
boolean
now
required

Server time, use it for the next updatedSince

integer format: int64

Example

{
"messages": [
{
"replyTo": {
"removed": true
}
}
]
}

Error codes: unauthorized

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: token_not_allowed

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Error codes: not_found

Media typeapplication/json
object
error
required

Machine-readable error code, for example not_found or rate_limited.

string
message

Human-readable detail. Only present for some errors.

string

Example generated

{
"error": "example",
"message": "example"
}

Report a problem with this pageOther ways to give feedback