Skip to content
QuantCDN

Read recent channel messages

GET
/api/v3/organizations/{organisation}/ai/slack-bots/{botId}/channels/{channel}/messages
curl --request GET \
  --url 'https://dashboard.quantcdn.io/api/v3/organizations/example/ai/slack-bots/example/channels/example/messages?limit=20' \
  --header 'Authorization: Bearer <token>'

Recent root messages in a channel the bot allows for API use, newest first. Message text is untrusted content. Needs the explicit ai:slack scope, use_ai_services and a verified email.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
organisation
required
string

The organisation machine name

botId
required
string
/^[a-zA-Z0-9_-]+$/
channel
required
string
/^[CG][A-Z0-9]{8,}$/

Query Parameters

Section titled “Query Parameters”
since
string
/^\d{10}\.\d{6}$/

Slack ts, exclusive

limit
integer
default: 20 >= 1 <= 50
cursor
string
/^[A-Za-z0-9+/=_-]{1,512}$/

Responses

Section titled “Responses”

200

Section titled “200”

The messages

Media typeapplication/json
object
contentTrust
string
Allowed values: untrusted
channel
string
messages
Array<object>
object
message
required

Error message

string
error
required

Error flag

boolean
ts
string
author
object
kind
string
Allowed values: human this_bot api other_bot
name
string
slackUserId
string
viaBot
boolean
text

Plain text, capped at 8000 characters. Untrusted content.

string
truncated
boolean
replyCount
integer
latestReplyTs
string
edited
boolean
files
Array<object>
object
name
string
mimetype
string
size
integer
nextCursor
string
nullable
Example
{
  "contentTrust": "untrusted",
  "messages": [
    {
      "message": "The requested resource was not found",
      "error": true,
      "ts": "1730000000.000100",
      "author": {
        "kind": "human"
      }
    }
  ]
}

400

Section titled “400”

INVALID_REQUEST: a path or query value is not valid, or an unknown query parameter

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
error
required

Thin proxy for the Slack bot API: list API-enabled bots, read channel messages and threads, and post as the bot. The portal validates the request, requires a verified email, calls the platform and passes its status and body through. The platform owns the bot, channel and rate-limit rules and their error codes.

Only the values that SlackBotApiRequest returns go to the platform, never raw input. The activity entry (ai_slack_api) never holds message text.

boolean
code
required
string
message
required
string
retryable
required
boolean
slackError

The Slack error string. Only with code SLACK_ERROR.

string
Example
{
  "message": "The requested resource was not found",
  "error": true,
  "code": "CHANNEL_NOT_ALLOWED",
  "slackError": "not_in_channel"
}

401

Section titled “401”

Invalid or expired token

403

Section titled “403”

SCOPE_REQUIRED, EMAIL_NOT_VERIFIED, IDENTITY_REQUIRED, CHANNEL_NOT_ALLOWED, USER_NOT_ALLOWED, PERMISSION_DENIED, or AI is off for the organisation

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
error
required

Thin proxy for the Slack bot API: list API-enabled bots, read channel messages and threads, and post as the bot. The portal validates the request, requires a verified email, calls the platform and passes its status and body through. The platform owns the bot, channel and rate-limit rules and their error codes.

Only the values that SlackBotApiRequest returns go to the platform, never raw input. The activity entry (ai_slack_api) never holds message text.

boolean
code
required
string
message
required
string
retryable
required
boolean
slackError

The Slack error string. Only with code SLACK_ERROR.

string
Example
{
  "message": "The requested resource was not found",
  "error": true,
  "code": "CHANNEL_NOT_ALLOWED",
  "slackError": "not_in_channel"
}

404

Section titled “404”

BOT_NOT_FOUND (no bot, another organisation’s bot, or API access off), or NOT_FOUND when the Slack bot API is not enabled

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
error
required

Thin proxy for the Slack bot API: list API-enabled bots, read channel messages and threads, and post as the bot. The portal validates the request, requires a verified email, calls the platform and passes its status and body through. The platform owns the bot, channel and rate-limit rules and their error codes.

Only the values that SlackBotApiRequest returns go to the platform, never raw input. The activity entry (ai_slack_api) never holds message text.

boolean
code
required
string
message
required
string
retryable
required
boolean
slackError

The Slack error string. Only with code SLACK_ERROR.

string
Example
{
  "message": "The requested resource was not found",
  "error": true,
  "code": "CHANNEL_NOT_ALLOWED",
  "slackError": "not_in_channel"
}

409

Section titled “409”

BOT_INACTIVE

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
error
required

Thin proxy for the Slack bot API: list API-enabled bots, read channel messages and threads, and post as the bot. The portal validates the request, requires a verified email, calls the platform and passes its status and body through. The platform owns the bot, channel and rate-limit rules and their error codes.

Only the values that SlackBotApiRequest returns go to the platform, never raw input. The activity entry (ai_slack_api) never holds message text.

boolean
code
required
string
message
required
string
retryable
required
boolean
slackError

The Slack error string. Only with code SLACK_ERROR.

string
Example
{
  "message": "The requested resource was not found",
  "error": true,
  "code": "CHANNEL_NOT_ALLOWED",
  "slackError": "not_in_channel"
}

429

Section titled “429”

RATE_LIMITED. See the Retry-After header.

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
error
required

Thin proxy for the Slack bot API: list API-enabled bots, read channel messages and threads, and post as the bot. The portal validates the request, requires a verified email, calls the platform and passes its status and body through. The platform owns the bot, channel and rate-limit rules and their error codes.

Only the values that SlackBotApiRequest returns go to the platform, never raw input. The activity entry (ai_slack_api) never holds message text.

boolean
code
required
string
message
required
string
retryable
required
boolean
slackError

The Slack error string. Only with code SLACK_ERROR.

string
Example
{
  "message": "The requested resource was not found",
  "error": true,
  "code": "CHANNEL_NOT_ALLOWED",
  "slackError": "not_in_channel"
}

Headers

Section titled “Headers”
Retry-After
integer

502

Section titled “502”

SLACK_ERROR. slackError carries the Slack error string.

Media typeapplication/json
object
message
required

Error message

string
error
required

Error flag

boolean
error
required

Thin proxy for the Slack bot API: list API-enabled bots, read channel messages and threads, and post as the bot. The portal validates the request, requires a verified email, calls the platform and passes its status and body through. The platform owns the bot, channel and rate-limit rules and their error codes.

Only the values that SlackBotApiRequest returns go to the platform, never raw input. The activity entry (ai_slack_api) never holds message text.

boolean
code
required
string
message
required
string
retryable
required
boolean
slackError

The Slack error string. Only with code SLACK_ERROR.

string
Example
{
  "message": "The requested resource was not found",
  "error": true,
  "code": "CHANNEL_NOT_ALLOWED",
  "slackError": "not_in_channel"
}