POST /v1/rooms/:id/chat

The POST /v1/rooms/:id/chat endpoint allows you to send a message in the specific room.

HTTP Method

POST

URL

https://api.nomi.ai/v1/rooms/:id/chat

Request Body Format

{
  messageText: string; // 800 characters max
}

Response Body Format

{
  sentMessage: {
    uuid: UUID;
    text: string;
    sent: ISODateString;
  };
}

Error Response Types

Type	Description
RoomNotFound	The specified room was not found. It may not exist or may not be associated with this account.
InvalidRouteParams	The id parameter is not a valid UUID.
InvalidContentType	The Content-Type header is not application/json.
InsufficientPlan	User plan is not entitled to room feature.
MessageCharacterLimitExceeded	The provided messageText is too long. Maximum message length is 800.
RoomStillCreating	Immediately after the creation of a room, there is a short period of several seconds before any messages can be sent to the room.
InvalidBody	Issue will be detailed in the errors.issues key, but there is an issue with the request body. This can happen if the messageText key is missing, or the wrong type.