Agent Conversations API

Manage agent conversations and message history.

Base URL: https://api.bluenexus.ai/api/v1/agents/:agentId

GET /agents/:agentId/conversations

List conversations for an agent.

Auth: Bearer token with agents-all or agents-use scope

Response (200): Paginated list of conversations with IDs and timestamps.

---

POST /agents/:agentId/conversations

Create a new conversation.

Auth: Bearer token with agents-all or agents-use scope

---

GET /agents/:agentId/conversations/:conversationId/messages

Get messages in a conversation.

Auth: Bearer token with agents-all or agents-use scope

Response (200): Array of messages with role, content, and timestamps.

---

GET /agents/:agentId/conversations/:conversationId/events

Subscribe to conversation events via Server-Sent Events.

Auth: Bearer token with agents-all or agents-use scope

---

DELETE /agents/:agentId/conversations/:conversationId

Delete a conversation and its message history.

Auth: Bearer token with agents-all or agents-use scope

---

Agent Memory

GET /agents/:agentId/memories

List all memories for an agent.

Auth: Bearer token with agents-all or agents-use scope

GET /agents/:agentId/memories/search?query=...

Search agent memories by keyword.

Auth: Bearer token with agents-all or agents-use scope