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

List human-channel conversations

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_"

channelenumOptional

Allowed values:

statusenumOptional

Allowed values:

Response

Channel conversation page

conversationslist of objects

nextPageTokenstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

1	{
2	"conversations": [
3	{
4	"id": "string",
5	"endpointId": "string",
6	"channel": "sms",
7	"remoteAddress": "string",
8	"status": "active",
9	"messageCount": 1,
10	"lastMessageAt": "2024-01-15T09:30:00Z",
11	"lastInboundAt": "2024-01-15T09:30:00Z",
12	"createdAt": "2024-01-15T09:30:00Z",
13	"updatedAt": "2024-01-15T09:30:00Z"
14	}
15	],
16	"nextPageToken": "string"
17	}

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