Open a user-delegated agent DM channel

POST

https://cessy.ai/api/rest/tenant-id/app-id/channels/dm

Creates or reuses a human-to-agent DM channel and channel-linked session for the authenticated OAuth user. If content is supplied and createOnly is not true, the first message is posted as that user.

Authentication

AuthorizationBearer

Tenant/app API key or OAuth/JWT bearer token.

Query parameters

workspaceIdstringOptionalformat: "^ws_[A-Za-z0-9_-]+$"

Optional Workspace runtime selector for preview or validation calls. If supplied with X-CES-Workspace-ID, both values must match.

Request

This endpoint expects an object.

agentIdstringRequired

contentstringOptional

Optional initial user message.

createOnlybooleanOptionalDefaults to false

When true, open the DM channel without posting content.

messageIdstringOptional

Optional caller-provided idempotency/message id.

attachmentslist of maps from strings to anyOptional

pageContextmap from strings to anyOptional

Response

DM channel created or resolved

channelIdstring

sessionIdstring

createdboolean

messageIdstring

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

1	const url = 'https://cessy.ai/api/rest/tenant-id/app-id/channels/dm';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"agentId":"agent_12345"}'
6	};
7
8	try {
9	const response = await fetch(url, options);
10	const data = await response.json();
11	console.log(data);
12	} catch (error) {
13	console.error(error);
14	}

1	{
2	"channelId": "channel_67890",
3	"sessionId": "session_abcde12345",
4	"created": true,
5	"messageId": "msg_98765"
6	}

Authentication

Headers

Query parameters

Request

Response

Errors