Send Message

POST

conversations

send-message

Send Message

curl --request POST \
  --url http://localhost:3000/api/conversations/send-message \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversationId": "<string>",
  "messageData": {
    "type": "TEXT",
    "text": "<string>"
  },
  "fileUrls": [
    {
      "url": "<string>",
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "messageId": "<string>"
}
'

{
  "success": true,
  "message": {
    "id": "<string>",
    "senderId": "<string>",
    "content": "<string>",
    "timestamp": 123,
    "readBy": [
      "<string>"
    ],
    "type": "<string>"
  },
  "fileMessages": [
    {
      "id": "<string>",
      "senderId": "<string>",
      "content": "<string>",
      "timestamp": 123,
      "readBy": [
        "<string>"
      ],
      "type": "<string>"
    }
  ]
}

Body

application/json

conversationId

string

required

ID of the conversation to send the message to

messageData

object

required

Data for the message to send

Option 1
Option 2

Show child attributes

messageData.type

enum<string>

required

Type of message

Available options:

TEXT

messageData.text

string

required

Content of the text message

fileUrls

object[]

Optional array of file URLs to send as separate file messages

Show child attributes

fileUrls.url

string

required

URL where the file is stored

fileUrls.name

string

required

Name of the file

fileUrls.type

string

required

MIME type of the file

messageId

string

Optional frontend-generated unique ID for message correlation

Response

Message sent successfully

success

boolean

required

Whether the message was sent successfully

message

object

The text message that was sent, if any

Show child attributes

message.id

string

Message ID

message.senderId

string

ID of the user who sent the message

message.content

string

Message content

message.timestamp

number

Timestamp when the message was sent

message.readBy

string[]

Array of user IDs who have read this message

message.type

string

Message type (text, system, etc.)

fileMessages

object[]

Array of file messages that were sent, if any

Show child attributes

fileMessages.id

string

Message ID

fileMessages.senderId

string

ID of the user who sent the message

fileMessages.content

string

Message content

fileMessages.timestamp

number

Timestamp when the message was sent

fileMessages.readBy

string[]

Array of user IDs who have read this message

fileMessages.type

string

Message type (text, system, etc.)

Get ConversationsRetrieves all conversations for the authenticated user

⌘I

Send Message

curl --request POST \
  --url http://localhost:3000/api/conversations/send-message \
  --header 'Content-Type: application/json' \
  --data '
{
  "conversationId": "<string>",
  "messageData": {
    "type": "TEXT",
    "text": "<string>"
  },
  "fileUrls": [
    {
      "url": "<string>",
      "name": "<string>",
      "type": "<string>"
    }
  ],
  "messageId": "<string>"
}
'

{
  "success": true,
  "message": {
    "id": "<string>",
    "senderId": "<string>",
    "content": "<string>",
    "timestamp": 123,
    "readBy": [
      "<string>"
    ],
    "type": "<string>"
  },
  "fileMessages": [
    {
      "id": "<string>",
      "senderId": "<string>",
      "content": "<string>",
      "timestamp": 123,
      "readBy": [
        "<string>"
      ],
      "type": "<string>"
    }
  ]
}

Endpoints

Body

Response