Send Chat Message

POST 
/api/chat/message

This endpoint sends a message to a specified conversation within a workspace. The request must include a valid API key and user ID.

Request

Header Parameters

x-api-key stringrequired

API key to authorize the request.

userId stringrequired

ID of the user making the request.

application/json

Body

required

workspaceId stringrequired

ID of the workspace.

conversationId stringrequired

ID of the conversation.

message stringrequired

The message to be sent.

isFirst boolean

Indicates if this is the first message in the conversation.

Responses

200

Successfully sent the message and retrieved follow-up questions and source snippets.

application/json

Schema

Schema

data

object

id string

The ID of the response.

query string

The query that was sent.

followUps

object[]

Array [

id string

The ID of the follow-up question.

text string

The text of the follow-up question.

]

sourceSnips

object[]

Array [

id string

The ID of the source snippet.

text string

The text of the source snippet.

]

likes string[]

dislikes string[]

type string

The type of the message, which is 'response'.

Example (from schema)

{
  "data": {
    "id": "string",
    "query": "string",
    "followUps": [
      {
        "id": "string",
        "text": "string"
      }
    ],
    "sourceSnips": [
      {
        "id": "string",
        "text": "string"
      }
    ],
    "likes": [
      "string"
    ],
    "dislikes": [
      "string"
    ],
    "type": "string"
  }
}

400

Invalid body or fetch operation failed.

application/json

Schema

Schema

error string

Error message indicating the issue with the request body or fetch operation.

Example (from schema)

{
  "error": "string"
}

403

Invalid API key.

application/json

Schema

Schema

error

object

message string

Detailed error message indicating that the API key is invalid.

Example (from schema)

{
  "error": {
    "message": "string"
  }
}

404

Conversation or workspace not found.

application/json

Schema

Schema

error

object

message string

Error message indicating that the conversation or workspace was not found.

Example (from schema)

{
  "error": {
    "message": "string"
  }
}

500

Internal server error.

application/json

Schema

Schema

message string

Error message indicating an internal server error.

Example (from schema)

{
  "message": "string"
}

Loading...