Agent Conversations

Get all conversations

get

Retrieves all conversations for the authenticated user sorted by last updated date

Authorizations

bearerapi-key

Responses

200

List of user conversations with metadata

application/json

idstringRequired

Conversation ID

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

titlestringRequired

Conversation title/summary

Example: Account balance inquiry

createdAtstring · date-timeRequired

Date when conversation was created

Example: 2023-05-20T14:30:00Z

updatedAtstring · date-timeRequired

Date when conversation was last updated

Example: 2023-05-20T14:35:00Z

isPinnedbooleanRequired

Whether conversation is pinned

Example: false

messageCountnumberRequired

Number of messages in conversation

Example: 5

401

Missing or invalid authentication token

get

/api/v1/agent/conversations

HTTPcURLJavaScriptPython

GET /api/v1/agent/conversations HTTP/1.1
Host: api.monei.cc
Accept: */*

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "title": "Account balance inquiry",
    "createdAt": "2023-05-20T14:30:00Z",
    "updatedAt": "2023-05-20T14:35:00Z",
    "isPinned": false,
    "messageCount": 5
  }
]

Chat with Mr. Monei AI Agent

post

Processes natural language queries about finances, transactions, and account management. Creates a new conversation if no conversationId is provided, or continues an existing one.

Authorizations

bearerapi-key

Body

application/json

messagestringRequired

User message to the agent

Example: What's my current account balance?

conversationIdstringRequired

Existing conversation ID to continue

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

Responses

201

Successful AI agent response

application/json

400

Invalid request payload

401

Missing or invalid authentication token

404

Conversation not found when providing conversationId

post

/api/v1/agent/conversations

HTTPcURLJavaScriptPython

POST /api/v1/agent/conversations HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 96

{
  "message": "What about my USD account?",
  "conversationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}

Continue conversationTransaction historyAirtime purchase

{
  "response": "Your current balance is ₦25,430.00",
  "conversationId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "title": "Account balance inquiry"
}

Get conversation messages

get

Retrieves messages for a specific conversation with pagination

Authorizations

bearerapi-key

Path parameters

conversationIdstringRequired

UUID of the conversation

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

Query parameters

limitnumberOptional

Number of messages to return (default: 20, max: 100)

Responses

200

List of messages in the conversation

application/json

idstringRequired

Message ID

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

rolestring · enumRequired

Message role (user or assistant)

Example: userPossible values:

contentstringRequired

Message content

Example: What's my current account balance?

createdAtstring · date-timeRequired

Message creation timestamp

Example: 2023-05-20T14:30:00Z

404

Conversation not found or access denied

get

/api/v1/agent/conversations/{conversationId}/messages

HTTPcURLJavaScriptPython

GET /api/v1/agent/conversations/{conversationId}/messages HTTP/1.1
Host: api.monei.cc
Accept: */*

[
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "role": "user",
    "content": "What's my current account balance?",
    "createdAt": "2023-05-20T14:30:00Z"
  }
]

Initialize conversation

post

initialize conversation before making chat request

Authorizations

bearerapi-key

Body

application/json

idstringRequired

Responses

default

application/json

post

/api/v1/agent/conversations/init-conversation

HTTPcURLJavaScriptPython

POST /api/v1/agent/conversations/init-conversation HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 13

{
  "id": "text"
}

default

{
  "statusCode": 1,
  "message": "text",
  "data": {}
}

Delete conversation

delete

Permanently deletes a conversation and all its messages

Authorizations

bearerapi-key

Path parameters

conversationIdstringRequired

UUID of the conversation to delete

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

Responses

204

Conversation successfully deleted

404

Conversation not found or access denied

delete

/api/v1/agent/conversations/{conversationId}

HTTPcURLJavaScriptPython

DELETE /api/v1/agent/conversations/{conversationId} HTTP/1.1
Host: api.monei.cc
Accept: */*

No content

Pin/unpin conversation

patch

Marks a conversation as pinned or unpinned for easy access

Authorizations

bearerapi-key

Path parameters

conversationIdstringRequired

UUID of the conversation to pin/unpin

Example: 3fa85f64-5717-4562-b3fc-2c963f66afa6

Body

application/json

pinbooleanRequired

Whether to pin or unpin the conversation

Example: true

Responses

200

Conversation pin status updated

No content

404

Conversation not found or access denied

patch

/api/v1/agent/conversations/{conversationId}/pin

HTTPcURLJavaScriptPython

PATCH /api/v1/agent/conversations/{conversationId}/pin HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 12

{
  "pin": true
}

No content

Stream conversation with AI agent

post

Real-time Server-Sent Events stream of agent responses

Authorizations

bearerapi-key

Header parameters

AcceptstringOptional

Must be "text/event-stream"

Body

application/json

messagestringRequired

User message to the agent

conversationIdstringRequired

Existing conversation ID

chainIdnumberOptional

Chain ID for blockchain operations

Default: 56

Responses

200

SSE stream

text/event-stream

stringOptionalExample: data: {"event":"token","data":"Hello"}

400

Invalid request format

401

Unauthorized

500

Server error

text/event-stream

post

/api/v1/agent/conversations/stream

HTTPcURLJavaScriptPython

POST /api/v1/agent/conversations/stream HTTP/1.1
Host: api.monei.cc
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "message": "text",
  "conversationId": "text",
  "chainId": 56
}

data: {"event":"token","data":"Hello"}