Messages

Retrieves a paginated list of messages for the specified assistant.

get

Retrieves a paginated list of messages for the specified assistant, optionally filtered and sorted.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

assistantIdentifierstring · uuidRequired

The unique identifier of the assistant.

projectIdentifierstringRequired

Query parameters

pageNumberinteger · int32Optional

The page number to retrieve.

pageSizeinteger · int32Optional

The number of items per page.

searchTextstringOptional

Optional search text to filter messages.

sortinginteger · enumOptional

The sorting option for the results.

Possible values:

descbooleanOptional

Whether to sort in descending order.

Default: true

Responses

200

OK

text/plainapplication/jsontext/json

textstring · nullableRequired

messageDocumentIdentifiersstring · uuid[] · nullableOptional

modelIdentifierstring · uuidRequired

streamboolean · nullableOptional

objectIdentifierstring · uuidOptional

textWithCitationsstring · nullableOptional

dateAddedstring · date-timeOptional

messageResponseTypeIdinteger · int32 · nullableOptional

addingCitationsboolean · nullableOptional

isAssistantbooleanRequired

403

Forbidden

text/plainapplication/jsontext/json

get

/projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages

HTTPcURLJavaScriptPython

GET /projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "text": "text",
    "messageDocumentIdentifiers": [
      "123e4567-e89b-12d3-a456-426614174000"
    ],
    "modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "stream": true,
    "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "textWithCitations": "text",
    "dateAdded": "2026-03-13T14:12:17.174Z",
    "messageResponseTypeId": 1,
    "addingCitations": true,
    "assistant": {
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "description": "text",
      "documents": [
        {
          "name": "text",
          "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "isDirectory": true,
          "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "contentType": "text",
          "size": 1,
          "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "dateAdded": "2026-03-13T14:12:17.174Z",
          "uploadSuccessful": true,
          "tokenCount": 1,
          "metadataTokenCount": 1,
          "unsupportedFileType": true,
          "unPackingComplete": true,
          "unPackingFailed": true,
          "uploadInProgress": true,
          "url": "text",
          "hasChildren": true,
          "resourceOwner": {
            "email": "text",
            "name": "text",
            "id": "text"
          }
        }
      ],
      "dateAdded": "2026-03-13T14:12:17.174Z",
      "documentMetadata": [
        {
          "paragraphs": [
            {
              "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
              "content": "text",
              "boundingRegions": [
                {
                  "points": [
                    1
                  ],
                  "page": 1
                }
              ],
              "role": "Title"
            }
          ],
          "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
        }
      ],
      "estimatedTokenCount": 1,
      "resourceOwner": {
        "email": "text",
        "name": "text",
        "id": "text"
      }
    },
    "isAssistant": true,
    "messageCitations": [
      {
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "quote": "text",
        "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "messageObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "citationsJsonResponse": {
      "citations": [
        {
          "assertion": "text",
          "evidence": [
            {
              "document": "123e4567-e89b-12d3-a456-426614174000",
              "quote": "text"
            }
          ]
        }
      ]
    },
    "documents": [
      {
        "name": "text",
        "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "isDirectory": true,
        "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "contentType": "text",
        "size": 1,
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "dateAdded": "2026-03-13T14:12:17.174Z",
        "uploadSuccessful": true,
        "tokenCount": 1,
        "metadataTokenCount": 1,
        "unsupportedFileType": true,
        "unPackingComplete": true,
        "unPackingFailed": true,
        "uploadInProgress": true,
        "url": "text",
        "hasChildren": true,
        "resourceOwner": {
          "email": "text",
          "name": "text",
          "id": "text"
        }
      }
    ],
    "resourceOwner": {
      "email": "text",
      "name": "text",
      "id": "text"
    }
  }
]

Creates a new message in the specified assistant.

post

Creates a new message in the specified assistant. Supports streaming responses.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

assistantIdentifierstring · uuidRequired

The unique identifier of the assistant.

projectIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

textstring · nullableRequired

messageDocumentIdentifiersstring · uuid[] · nullableOptional

modelIdentifierstring · uuidRequired

streamboolean · nullableOptional

Responses

200

OK

text/plainapplication/jsontext/json

textstring · nullableRequired

messageDocumentIdentifiersstring · uuid[] · nullableOptional

modelIdentifierstring · uuidRequired

streamboolean · nullableOptional

objectIdentifierstring · uuidOptional

textWithCitationsstring · nullableOptional

dateAddedstring · date-timeOptional

messageResponseTypeIdinteger · int32 · nullableOptional

addingCitationsboolean · nullableOptional

isAssistantbooleanRequired

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

post

/projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages

HTTPcURLJavaScriptPython

POST /projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 156

{
  "text": "text",
  "messageDocumentIdentifiers": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "stream": true
}

application/jsontext/jsonapplication/*+json

{
  "text": "text",
  "messageDocumentIdentifiers": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "stream": true,
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "textWithCitations": "text",
  "dateAdded": "2026-03-13T14:12:17.174Z",
  "messageResponseTypeId": 1,
  "addingCitations": true,
  "assistant": {
    "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "documents": [
      {
        "name": "text",
        "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "isDirectory": true,
        "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "contentType": "text",
        "size": 1,
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "dateAdded": "2026-03-13T14:12:17.174Z",
        "uploadSuccessful": true,
        "tokenCount": 1,
        "metadataTokenCount": 1,
        "unsupportedFileType": true,
        "unPackingComplete": true,
        "unPackingFailed": true,
        "uploadInProgress": true,
        "url": "text",
        "hasChildren": true,
        "resourceOwner": {
          "email": "text",
          "name": "text",
          "id": "text"
        }
      }
    ],
    "dateAdded": "2026-03-13T14:12:17.174Z",
    "documentMetadata": [
      {
        "paragraphs": [
          {
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "content": "text",
            "boundingRegions": [
              {
                "points": [
                  1
                ],
                "page": 1
              }
            ],
            "role": "Title"
          }
        ],
        "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "estimatedTokenCount": 1,
    "resourceOwner": {
      "email": "text",
      "name": "text",
      "id": "text"
    }
  },
  "isAssistant": true,
  "messageCitations": [
    {
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "quote": "text",
      "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "messageObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "citationsJsonResponse": {
    "citations": [
      {
        "assertion": "text",
        "evidence": [
          {
            "document": "123e4567-e89b-12d3-a456-426614174000",
            "quote": "text"
          }
        ]
      }
    ]
  },
  "documents": [
    {
      "name": "text",
      "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "isDirectory": true,
      "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "contentType": "text",
      "size": 1,
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "dateAdded": "2026-03-13T14:12:17.174Z",
      "uploadSuccessful": true,
      "tokenCount": 1,
      "metadataTokenCount": 1,
      "unsupportedFileType": true,
      "unPackingComplete": true,
      "unPackingFailed": true,
      "uploadInProgress": true,
      "url": "text",
      "hasChildren": true,
      "resourceOwner": {
        "email": "text",
        "name": "text",
        "id": "text"
      }
    }
  ],
  "resourceOwner": {
    "email": "text",
    "name": "text",
    "id": "text"
  }
}

Retrieves a message by its object identifier.

get

Retrieves a message by its object identifier.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

The unique identifier of the message to retrieve.

projectIdentifierstringRequired

assistantIdentifierstringRequired

Responses

200

OK

text/plainapplication/jsontext/json

textstring · nullableRequired

messageDocumentIdentifiersstring · uuid[] · nullableOptional

modelIdentifierstring · uuidRequired

streamboolean · nullableOptional

objectIdentifierstring · uuidOptional

textWithCitationsstring · nullableOptional

dateAddedstring · date-timeOptional

messageResponseTypeIdinteger · int32 · nullableOptional

addingCitationsboolean · nullableOptional

isAssistantbooleanRequired

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

get

/projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages/{objectIdentifier}

HTTPcURLJavaScriptPython

GET /projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "text": "text",
  "messageDocumentIdentifiers": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "stream": true,
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "textWithCitations": "text",
  "dateAdded": "2026-03-13T14:12:17.174Z",
  "messageResponseTypeId": 1,
  "addingCitations": true,
  "assistant": {
    "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "documents": [
      {
        "name": "text",
        "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "isDirectory": true,
        "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "contentType": "text",
        "size": 1,
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "dateAdded": "2026-03-13T14:12:17.174Z",
        "uploadSuccessful": true,
        "tokenCount": 1,
        "metadataTokenCount": 1,
        "unsupportedFileType": true,
        "unPackingComplete": true,
        "unPackingFailed": true,
        "uploadInProgress": true,
        "url": "text",
        "hasChildren": true,
        "resourceOwner": {
          "email": "text",
          "name": "text",
          "id": "text"
        }
      }
    ],
    "dateAdded": "2026-03-13T14:12:17.174Z",
    "documentMetadata": [
      {
        "paragraphs": [
          {
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "content": "text",
            "boundingRegions": [
              {
                "points": [
                  1
                ],
                "page": 1
              }
            ],
            "role": "Title"
          }
        ],
        "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "estimatedTokenCount": 1,
    "resourceOwner": {
      "email": "text",
      "name": "text",
      "id": "text"
    }
  },
  "isAssistant": true,
  "messageCitations": [
    {
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "quote": "text",
      "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "messageObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "citationsJsonResponse": {
    "citations": [
      {
        "assertion": "text",
        "evidence": [
          {
            "document": "123e4567-e89b-12d3-a456-426614174000",
            "quote": "text"
          }
        ]
      }
    ]
  },
  "documents": [
    {
      "name": "text",
      "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "isDirectory": true,
      "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "contentType": "text",
      "size": 1,
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "dateAdded": "2026-03-13T14:12:17.174Z",
      "uploadSuccessful": true,
      "tokenCount": 1,
      "metadataTokenCount": 1,
      "unsupportedFileType": true,
      "unPackingComplete": true,
      "unPackingFailed": true,
      "uploadInProgress": true,
      "url": "text",
      "hasChildren": true,
      "resourceOwner": {
        "email": "text",
        "name": "text",
        "id": "text"
      }
    }
  ],
  "resourceOwner": {
    "email": "text",
    "name": "text",
    "id": "text"
  }
}

Updates a message by its object identifier.

put

Updates a message by its object identifier.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

The unique identifier of the message to update.

projectIdentifierstringRequired

assistantIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

textstring · nullableRequired

messageDocumentIdentifiersstring · uuid[] · nullableOptional

modelIdentifierstring · uuidRequired

streamboolean · nullableOptional

Responses

200

OK

text/plainapplication/jsontext/json

textstring · nullableRequired

messageDocumentIdentifiersstring · uuid[] · nullableOptional

modelIdentifierstring · uuidRequired

streamboolean · nullableOptional

objectIdentifierstring · uuidOptional

textWithCitationsstring · nullableOptional

dateAddedstring · date-timeOptional

messageResponseTypeIdinteger · int32 · nullableOptional

addingCitationsboolean · nullableOptional

isAssistantbooleanRequired

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

put

/projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages/{objectIdentifier}

HTTPcURLJavaScriptPython

PUT /projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 156

{
  "text": "text",
  "messageDocumentIdentifiers": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "stream": true
}

application/jsontext/jsonapplication/*+json

{
  "text": "text",
  "messageDocumentIdentifiers": [
    "123e4567-e89b-12d3-a456-426614174000"
  ],
  "modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "stream": true,
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "textWithCitations": "text",
  "dateAdded": "2026-03-13T14:12:17.174Z",
  "messageResponseTypeId": 1,
  "addingCitations": true,
  "assistant": {
    "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "description": "text",
    "documents": [
      {
        "name": "text",
        "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "isDirectory": true,
        "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "contentType": "text",
        "size": 1,
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "dateAdded": "2026-03-13T14:12:17.174Z",
        "uploadSuccessful": true,
        "tokenCount": 1,
        "metadataTokenCount": 1,
        "unsupportedFileType": true,
        "unPackingComplete": true,
        "unPackingFailed": true,
        "uploadInProgress": true,
        "url": "text",
        "hasChildren": true,
        "resourceOwner": {
          "email": "text",
          "name": "text",
          "id": "text"
        }
      }
    ],
    "dateAdded": "2026-03-13T14:12:17.174Z",
    "documentMetadata": [
      {
        "paragraphs": [
          {
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "content": "text",
            "boundingRegions": [
              {
                "points": [
                  1
                ],
                "page": 1
              }
            ],
            "role": "Title"
          }
        ],
        "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
      }
    ],
    "estimatedTokenCount": 1,
    "resourceOwner": {
      "email": "text",
      "name": "text",
      "id": "text"
    }
  },
  "isAssistant": true,
  "messageCitations": [
    {
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "quote": "text",
      "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "messageObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "citationsJsonResponse": {
    "citations": [
      {
        "assertion": "text",
        "evidence": [
          {
            "document": "123e4567-e89b-12d3-a456-426614174000",
            "quote": "text"
          }
        ]
      }
    ]
  },
  "documents": [
    {
      "name": "text",
      "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "isDirectory": true,
      "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "contentType": "text",
      "size": 1,
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "dateAdded": "2026-03-13T14:12:17.174Z",
      "uploadSuccessful": true,
      "tokenCount": 1,
      "metadataTokenCount": 1,
      "unsupportedFileType": true,
      "unPackingComplete": true,
      "unPackingFailed": true,
      "uploadInProgress": true,
      "url": "text",
      "hasChildren": true,
      "resourceOwner": {
        "email": "text",
        "name": "text",
        "id": "text"
      }
    }
  ],
  "resourceOwner": {
    "email": "text",
    "name": "text",
    "id": "text"
  }
}

Deletes a message by its object identifier.

delete

Deletes a message by its object identifier.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

The unique identifier of the message to delete.

projectIdentifierstringRequired

assistantIdentifierstringRequired

Responses

204

No Content

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

delete

/projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages/{objectIdentifier}

HTTPcURLJavaScriptPython

DELETE /projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Uploads a document to be attached to a message.

post

Uploads a document to be attached to a message.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

projectIdentifierstringRequired

assistantIdentifierstringRequired

Body

multipart/form-data

filestring · binaryOptional

The file to upload.

Responses

200

OK

text/plainapplication/jsontext/json

namestring · nullableRequired

parentObjectIdentifierstring · uuid · nullableOptional

isDirectorybooleanOptional

documentUploadObjectIdentifierstring · uuidRequired

contentTypestring · nullableOptional

sizeinteger · int64 · nullableOptional

objectIdentifierstring · uuidOptional

dateAddedstring · date-timeOptional

uploadSuccessfulboolean · nullableOptional

tokenCountinteger · int64 · nullableOptional

metadataTokenCountinteger · int64 · nullableOptional

unsupportedFileTypeboolean · nullableOptional

unPackingCompleteboolean · nullableOptional

unPackingFailedboolean · nullableOptional

uploadInProgressboolean · nullableOptional

urlstring · nullableOptional

hasChildrenboolean · nullableOptional

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

post

/projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages/document

HTTPcURLJavaScriptPython

POST /projects/{projectIdentifier}/assistants/{assistantIdentifier}/messages/document HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 17

{
  "file": "binary"
}

{
  "name": "text",
  "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "isDirectory": true,
  "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "contentType": "text",
  "size": 1,
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "dateAdded": "2026-03-13T14:12:17.174Z",
  "uploadSuccessful": true,
  "tokenCount": 1,
  "metadataTokenCount": 1,
  "unsupportedFileType": true,
  "unPackingComplete": true,
  "unPackingFailed": true,
  "uploadInProgress": true,
  "url": "text",
  "hasChildren": true,
  "resourceOwner": {
    "email": "text",
    "name": "text",
    "id": "text"
  }
}