---
title: "Poll inbound messages (check_messages)"
method: GET
path: "/sdk/agents/{agentId}/messages"
tags: ["SDK — Messages"]
---

# Poll inbound messages (check_messages)

`GET /sdk/agents/{agentId}/messages`

## Request

- Base URL: `https://api.agentbrink.com/api`
- URL: `https://api.agentbrink.com/api/sdk/agents/{agentId}/messages`
- Auth: HTTP bearer

Returns recent inbound messages across all channels. Used by agents on a polling loop.

## Query parameters

- `limit` integer
- `since` string, date-time

## Response `200`

Array of messages

- Message[]
  - `_id` string
  - `agentId` string
  - `channel` 'telegram' | 'email' | 'sms' | 'webhook'
  - `direction` 'inbound' | 'outbound'
  - `externalChatId` string
  - `conversationId` string
  - `content` object
    - `type` string
    - `text` string
  - `status` 'pending' | 'delivered' | 'failed'
  - `createdAt` string, date-time

## Other responses

- `401`: Missing or invalid Bearer token

---

[API](https://skmtc.dev/agentbrink/apis/agentbrink-api.md) · [All operations](https://skmtc.dev/agentbrink/apis/agentbrink-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentbrink/apis/agentbrink-api/revisions/d2c782056161?raw)