Open or close a human-channel conversation

Authentication

AuthorizationBearer

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

Path parameters

conversationIdstringRequiredformat: "^ccv_"

Request

This endpoint expects an object.

statusenumRequired

Response

Updated channel conversation

conversationobject

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error

500

Internal Server Error

$	curl -X PATCH https://api.agentmailer.ai/v1/channel-conversations/conversationId \
>	-H "Authorization: Bearer <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"status": "active"
>	}'

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