RevoEngine Documentation

POST

/

api

/

v1

/

chat

/

threads

/

{threadId}

/

messages

Create a message.

curl --request POST \
  --url https://api.revoengine.com/api/v1/chat/threads/{threadId}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "The nightly sync has completed successfully.",
  "replyToMessageId": "00000000-0000-4000-8000-000000000001",
  "attachments": [
    {
      "type": "STORAGE_UPLOAD",
      "storageUploadSessionId": "00000000-0000-4000-8000-000000000001",
      "chatAttachmentId": "00000000-0000-4000-8000-000000000002",
      "name": "report.pdf",
      "mimeType": "application/pdf"
    }
  ],
  "chatUploadBatchId": "00000000-0000-4000-8000-000000000003",
  "clientDraftId": "draft-01hx3k4z7pq9",
  "metadata": {
    "source": "system",
    "severity": "info"
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    text: 'The nightly sync has completed successfully.',
    replyToMessageId: '00000000-0000-4000-8000-000000000001',
    attachments: [
      {
        type: 'STORAGE_UPLOAD',
        storageUploadSessionId: '00000000-0000-4000-8000-000000000001',
        chatAttachmentId: '00000000-0000-4000-8000-000000000002',
        name: 'report.pdf',
        mimeType: 'application/pdf'
      }
    ],
    chatUploadBatchId: '00000000-0000-4000-8000-000000000003',
    clientDraftId: 'draft-01hx3k4z7pq9',
    metadata: {source: 'system', severity: 'info'}
  })
};

fetch('https://api.revoengine.com/api/v1/chat/threads/{threadId}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/chat/threads/{threadId}/messages"

payload = {
    "text": "The nightly sync has completed successfully.",
    "replyToMessageId": "00000000-0000-4000-8000-000000000001",
    "attachments": [
        {
            "type": "STORAGE_UPLOAD",
            "storageUploadSessionId": "00000000-0000-4000-8000-000000000001",
            "chatAttachmentId": "00000000-0000-4000-8000-000000000002",
            "name": "report.pdf",
            "mimeType": "application/pdf"
        }
    ],
    "chatUploadBatchId": "00000000-0000-4000-8000-000000000003",
    "clientDraftId": "draft-01hx3k4z7pq9",
    "metadata": {
        "source": "system",
        "severity": "info"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Authorizations

Authorization

string

header

required

Bearer JWT token or API Key (sk-*).

Path Parameters

threadId

string

required

Body

application/json

text

string

Message body. Maximum 10kB.

Maximum string length: 10000

Example:

"The nightly sync has completed successfully."

replyToMessageId

string

Message id this message replies to. Must belong to the same thread.

Example:

"00000000-0000-4000-8000-000000000001"

attachments

object[]

Attachment descriptors included with the message. Use STORAGE_UPLOAD with storageUploadSessionId for direct uploads that may still be finalizing.

Example:

[
  {
    "type": "STORAGE_UPLOAD",
    "storageUploadSessionId": "00000000-0000-4000-8000-000000000001",
    "chatAttachmentId": "00000000-0000-4000-8000-000000000002",
    "name": "report.pdf",
    "mimeType": "application/pdf"
  }
]

chatUploadBatchId

string

Upload batch id whose finalized files are bound to this message.

Example:

"00000000-0000-4000-8000-000000000003"

clientDraftId

string

Client draft id used to bind finalized pending uploads to this message.

Maximum string length: 128

Example:

"draft-01hx3k4z7pq9"

metadata

object

Additional application metadata persisted with the message. Values may use any JSON type. Maximum 16 KiB and 64 top-level keys. Top-level keys starting with "__" are reserved for backend use.

Example:

{ "source": "system", "severity": "info" }

Response

200

OK.

Last modified on September 5, 2026

Create a message.

curl --request POST \
  --url https://api.revoengine.com/api/v1/chat/threads/{threadId}/messages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "text": "The nightly sync has completed successfully.",
  "replyToMessageId": "00000000-0000-4000-8000-000000000001",
  "attachments": [
    {
      "type": "STORAGE_UPLOAD",
      "storageUploadSessionId": "00000000-0000-4000-8000-000000000001",
      "chatAttachmentId": "00000000-0000-4000-8000-000000000002",
      "name": "report.pdf",
      "mimeType": "application/pdf"
    }
  ],
  "chatUploadBatchId": "00000000-0000-4000-8000-000000000003",
  "clientDraftId": "draft-01hx3k4z7pq9",
  "metadata": {
    "source": "system",
    "severity": "info"
  }
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    text: 'The nightly sync has completed successfully.',
    replyToMessageId: '00000000-0000-4000-8000-000000000001',
    attachments: [
      {
        type: 'STORAGE_UPLOAD',
        storageUploadSessionId: '00000000-0000-4000-8000-000000000001',
        chatAttachmentId: '00000000-0000-4000-8000-000000000002',
        name: 'report.pdf',
        mimeType: 'application/pdf'
      }
    ],
    chatUploadBatchId: '00000000-0000-4000-8000-000000000003',
    clientDraftId: 'draft-01hx3k4z7pq9',
    metadata: {source: 'system', severity: 'info'}
  })
};

fetch('https://api.revoengine.com/api/v1/chat/threads/{threadId}/messages', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.revoengine.com/api/v1/chat/threads/{threadId}/messages"

payload = {
    "text": "The nightly sync has completed successfully.",
    "replyToMessageId": "00000000-0000-4000-8000-000000000001",
    "attachments": [
        {
            "type": "STORAGE_UPLOAD",
            "storageUploadSessionId": "00000000-0000-4000-8000-000000000001",
            "chatAttachmentId": "00000000-0000-4000-8000-000000000002",
            "name": "report.pdf",
            "mimeType": "application/pdf"
        }
    ],
    "chatUploadBatchId": "00000000-0000-4000-8000-000000000003",
    "clientDraftId": "draft-01hx3k4z7pq9",
    "metadata": {
        "source": "system",
        "severity": "info"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)