Read a channel context window | Runtype Documentation

{
  "channelId": "string",
  "labels": [
    {
      "decision": {
        "activated": true,
        "decision": "not_judged",
        "capability": {
          "outcome": "route",
          "capabilityId": "string",
          "probability": 1.1
        },
        "failure": "error",
        "probability": 1.1
      },
      "externalMessageId": "string",
      "label": "gate_false_negative",
      "labeledAt": "string",
      "source": "mention_after_silence"
    }
  ],
  "messages": [
    {
      "authorId": "string",
      "authorKind": "user",
      "decision": {
        "activated": true,
        "decision": "not_judged",
        "capability": {
          "outcome": "route",
          "capabilityId": "string",
          "probability": 1.1
        },
        "failure": "error",
        "probability": 1.1
      },
      "externalMessageId": "string",
      "hasAttachment": true,
      "mentionsAssistant": true,
      "text": "string",
      "timestamp": "string",
      "threadId": "string"
    }
  ],
  "provider": "slack",
  "surfaceId": "string"
}

Read the recent channel messages a Slack, Telegram or iMessage surface holds for one channel or group (at most 20, newest 24 hours, oldest first), each with the response gate decision recorded for it, and the next-turn labels recorded on those decisions. Skipped messages create no conversation, so this is where their decisions are read.

Authentication

AuthorizationBearer

API key or Clerk session token

Path parameters

surfaceIdstringRequired

Query parameters

channelIdstringRequired>=1 character

Slack channel ID, Telegram chat ID, or iMessage group ID.

Response

The channel window with its gate decisions and labels

channelIdstring

labelslist of objects

Labels on decisions the channel still retains (newest 50 messages, 24 hours), oldest first. Empty until a next turn produces one.

messageslist of objects

providerenum

Allowed values:

surfaceIdstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error