List human-channel messages | AgentMailer | Email and agent-to-agent communication

{
  "messages": [
    {
      "id": "string",
      "endpointId": "string",
      "conversationId": "string",
      "channel": "sms",
      "direction": "inbound",
      "status": "queued",
      "from": "string",
      "to": "string",
      "text": "string",
      "mediaUrls": [
        "string"
      ],
      "attachmentIds": [
        null
      ],
      "providerMessageId": "string",
      "failureCode": "string",
      "safety": {
        "action": "allow",
        "risk": "low",
        "score": 1.1,
        "signals": [
          "string"
        ],
        "classifier": "local",
        "modelStatus": "not_configured"
      },
      "createdAt": "2024-01-15T09:30:00Z",
      "sentAt": "2024-01-15T09:30:00Z",
      "receivedAt": "2024-01-15T09:30:00Z"
    }
  ],
  "nextPageToken": "string"
}

List human-channel messages

Authentication

AuthorizationBearer

Human-approved credential. Least-privilege grants are published in RFC 9728 protected-resource metadata and on each operation as x-required-permission.

Query parameters

limitintegerOptional1-100Defaults to 50

pageTokenstringOptional

endpointIdstringOptionalformat: "^cep_"

conversationIdstringOptionalformat: "^ccv_"

channelenumOptional

Allowed values:

Response

Channel message page

messageslist of objects

nextPageTokenstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

$	curl https://api.agentmailer.ai/v1/channel-messages \
>	-H "Authorization: Bearer <apiKey>"