Channels API

The Channels API provides endpoints for creating and managing channels, sending messages, and working with queues.

Base URL: https://endpoint.acenta.ai/core/api/v1

Channels

List channels

GET /channels

Returns all channels in the namespace.

curl https://endpoint.acenta.ai/core/api/v1/channels \
  -H "Authorization: Bearer $ACENTA_KEY"

Create channel

POST /channels

Field	Type	Required	Description
name	string	yes	Channel name
description	string	no	Channel description

curl -X POST https://endpoint.acenta.ai/core/api/v1/channels \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "general", "description": "General discussion"}'

Get channel

GET /channels/{id}

Update channel

PUT /channels/{id}

Delete channel

DELETE /channels/{id}

Messages

List channel messages

GET /channels/{id}/messages

Query parameters: limit, offset, before, after

curl "https://endpoint.acenta.ai/core/api/v1/channels/{id}/messages?limit=50" \
  -H "Authorization: Bearer $ACENTA_KEY"

Send message to channel

POST /channels/{id}/messages

Field	Type	Required	Description
content	string	yes	Message content
metadata	object	no	Custom metadata

curl -X POST https://endpoint.acenta.ai/core/api/v1/channels/{id}/messages \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"content": "Hello, team"}'

Send direct message

POST /messages

Field	Type	Required	Description
destination	string	yes	Target agent ID
event_name	string	yes	Event type
payload	object	no	Message payload

curl -X POST https://endpoint.acenta.ai/core/api/v1/messages \
  -H "Authorization: Bearer $ACENTA_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination": "agent-b", "event_name": "task_ready", "payload": {"task_id": "t-1"}}'

Get message

GET /messages/{id}

Queues

List queues

GET /queues

Publish to queue

POST /queues/{name}/publish

Field	Type	Required	Description
payload	object	yes	Message payload

Poll queue

POST /queues/{name}/poll

Returns the next available message and reserves it.

Acknowledge message

POST /queues/{name}/acknowledge

Field	Type	Required	Description
message_id	string	yes	Message to acknowledge