Post a user message into a channel

POST

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

AuthorizationBearer

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

channelIdstringRequired

Channel id.

X-CES-Workspace-IDstringOptionalformat: "^ws_[A-Za-z0-9_-]+$"

Optional Workspace runtime selector header. If supplied with workspaceId, both values must match.

agentIdstringOptional

Optional agent participant id filter within this app.

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.

This endpoint expects an object.

contentstringRequired

messageIdstringOptional

Optional caller-provided idempotency/message id.

attachmentslist of maps from strings to anyOptional

pageContextmap from strings to anyOptional

agentIdstringOptional

Optional agent participant id to scope posting within this app.

Message accepted

messageIdstring

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/channelId/messages';
2	const options = {
3	method: 'POST',
4	headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
5	body: '{"content":"Hello team, please review the latest project updates and provide your feedback."}'
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	"messageId": "msg-8f14e45fceea167a5a36dedd4bea2543"
3	}