Flow Chats

List flow chats.

get

Returns a paged, searchable and sortable list of the chats belonging to the specified flow.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

projectIdentifierstringRequired

flowIdentifierstringRequired

Query parameters

pageNumberinteger · int32Optional

pageSizeinteger · int32Optional

searchTextstringOptional

sortingstring · enumOptionalPossible values:

descbooleanOptionalDefault: true

Responses

200

OK

text/plainapplication/jsontext/json

objectIdentifierstring · uuidOptional

namestring · nullableRequired

descriptionstring · nullableOptional

dateAddedstring · date-timeOptional

estimatedTokenCountinteger · int32Optional

assistantMessageCountinteger · int32Optional

userMessageCountinteger · int32Optional

totalCountinteger · int32Optional

403

Forbidden

text/plainapplication/jsontext/json

get/projects/{projectIdentifier}/flows/{flowIdentifier}/chats

HTTPcURLJavaScriptPython

GET /projects/{projectIdentifier}/flows/{flowIdentifier}/chats HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "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-07-11T01:56:48.271Z",
        "uploadSuccessful": true,
        "tokenCount": 1,
        "metadataTokenCount": 1,
        "indexingNotPossible": true,
        "unsupportedFileType": true,
        "unPackingComplete": true,
        "unPackingFailed": true,
        "uploadInProgress": true,
        "url": "text",
        "hasChildren": true,
        "extension": "text",
        "convertedToPdf": true,
        "fileType": "unknown",
        "uploadFailedReason": "outOfMemory",
        "resourceOwner": {
          "email": "text",
          "name": "text",
          "id": "text"
        },
        "progress": 1,
        "path": "text",
        "parent": {
          "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "name": "text",
          "isDirectory": true
        },
        "ocrStrategy": "never",
        "ocrEngine": "azureDocumentIntelligence",
        "coordinateExtractionStrategy": "never",
        "documentUploadSource": "local",
        "pageCount": 1,
        "metadata": [
          {
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "key": "text",
            "value": "text"
          }
        ]
      }
    ],
    "dateAdded": "2026-07-11T01:56:48.271Z",
    "documentMetadata": [
      {
        "paragraphs": [
          {
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "content": "text",
            "boundingRegions": [
              {
                "points": [
                  1
                ],
                "page": 1
              }
            ],
            "role": "title"
          }
        ],
        "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "documentType": "standard",
        "comparedDocumentObjectIdentifiers": [
          "123e4567-e89b-12d3-a456-426614174000"
        ]
      }
    ],
    "estimatedTokenCount": 1,
    "assistantMessageCount": 1,
    "userMessageCount": 1,
    "totalCount": 1,
    "resourceOwner": {
      "email": "text",
      "name": "text",
      "id": "text"
    }
  }
]

Create a flow chat.

post

Creates a new chat conversation bound to the specified flow, optionally attaching documents to use as context.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

projectIdentifierstringRequired

flowIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

namestring · nullableRequired

descriptionstring · nullableOptional

documentObjectIdentifiersstring · uuid[] · nullableOptional

Responses

200

OK

text/plainapplication/jsontext/json

objectIdentifierstring · uuidOptional

namestring · nullableRequired

descriptionstring · nullableOptional

dateAddedstring · date-timeOptional

estimatedTokenCountinteger · int32Optional

assistantMessageCountinteger · int32Optional

userMessageCountinteger · int32Optional

totalCountinteger · int32Optional

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

post/projects/{projectIdentifier}/flows/{flowIdentifier}/chats

HTTPcURLJavaScriptPython

POST /projects/{projectIdentifier}/flows/{flowIdentifier}/chats HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 105

{
  "name": "text",
  "description": "text",
  "documentObjectIdentifiers": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

application/jsontext/jsonapplication/*+json

{
  "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-07-11T01:56:48.271Z",
      "uploadSuccessful": true,
      "tokenCount": 1,
      "metadataTokenCount": 1,
      "indexingNotPossible": true,
      "unsupportedFileType": true,
      "unPackingComplete": true,
      "unPackingFailed": true,
      "uploadInProgress": true,
      "url": "text",
      "hasChildren": true,
      "extension": "text",
      "convertedToPdf": true,
      "fileType": "unknown",
      "uploadFailedReason": "outOfMemory",
      "resourceOwner": {
        "email": "text",
        "name": "text",
        "id": "text"
      },
      "progress": 1,
      "path": "text",
      "parent": {
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "isDirectory": true
      },
      "ocrStrategy": "never",
      "ocrEngine": "azureDocumentIntelligence",
      "coordinateExtractionStrategy": "never",
      "documentUploadSource": "local",
      "pageCount": 1,
      "metadata": [
        {
          "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "key": "text",
          "value": "text"
        }
      ]
    }
  ],
  "dateAdded": "2026-07-11T01:56:48.271Z",
  "documentMetadata": [
    {
      "paragraphs": [
        {
          "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "content": "text",
          "boundingRegions": [
            {
              "points": [
                1
              ],
              "page": 1
            }
          ],
          "role": "title"
        }
      ],
      "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "documentType": "standard",
      "comparedDocumentObjectIdentifiers": [
        "123e4567-e89b-12d3-a456-426614174000"
      ]
    }
  ],
  "estimatedTokenCount": 1,
  "assistantMessageCount": 1,
  "userMessageCount": 1,
  "totalCount": 1,
  "resourceOwner": {
    "email": "text",
    "name": "text",
    "id": "text"
  }
}

Get a flow chat.

get

Retrieves a single chat belonging to the flow by its object identifier.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

projectIdentifierstringRequired

flowIdentifierstringRequired

Responses

200

OK

text/plainapplication/jsontext/json

objectIdentifierstring · uuidOptional

namestring · nullableRequired

descriptionstring · nullableOptional

dateAddedstring · date-timeOptional

estimatedTokenCountinteger · int32Optional

assistantMessageCountinteger · int32Optional

userMessageCountinteger · int32Optional

totalCountinteger · int32Optional

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

get/projects/{projectIdentifier}/flows/{flowIdentifier}/chats/{objectIdentifier}

HTTPcURLJavaScriptPython

GET /projects/{projectIdentifier}/flows/{flowIdentifier}/chats/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "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-07-11T01:56:48.271Z",
      "uploadSuccessful": true,
      "tokenCount": 1,
      "metadataTokenCount": 1,
      "indexingNotPossible": true,
      "unsupportedFileType": true,
      "unPackingComplete": true,
      "unPackingFailed": true,
      "uploadInProgress": true,
      "url": "text",
      "hasChildren": true,
      "extension": "text",
      "convertedToPdf": true,
      "fileType": "unknown",
      "uploadFailedReason": "outOfMemory",
      "resourceOwner": {
        "email": "text",
        "name": "text",
        "id": "text"
      },
      "progress": 1,
      "path": "text",
      "parent": {
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "isDirectory": true
      },
      "ocrStrategy": "never",
      "ocrEngine": "azureDocumentIntelligence",
      "coordinateExtractionStrategy": "never",
      "documentUploadSource": "local",
      "pageCount": 1,
      "metadata": [
        {
          "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "key": "text",
          "value": "text"
        }
      ]
    }
  ],
  "dateAdded": "2026-07-11T01:56:48.271Z",
  "documentMetadata": [
    {
      "paragraphs": [
        {
          "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "content": "text",
          "boundingRegions": [
            {
              "points": [
                1
              ],
              "page": 1
            }
          ],
          "role": "title"
        }
      ],
      "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "documentType": "standard",
      "comparedDocumentObjectIdentifiers": [
        "123e4567-e89b-12d3-a456-426614174000"
      ]
    }
  ],
  "estimatedTokenCount": 1,
  "assistantMessageCount": 1,
  "userMessageCount": 1,
  "totalCount": 1,
  "resourceOwner": {
    "email": "text",
    "name": "text",
    "id": "text"
  }
}

Update a flow chat.

put

Updates a flow chat's settings, such as its name, auto-rename behaviour, or the model it uses.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

projectIdentifierstringRequired

flowIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

namestring · nullableOptional

descriptionstring · nullableOptional

autoRenameboolean · nullableOptional

modelIdentifierstring · uuid · nullableOptional

Responses

200

OK

text/plainapplication/jsontext/json

objectIdentifierstring · uuidOptional

namestring · nullableRequired

descriptionstring · nullableOptional

dateAddedstring · date-timeOptional

estimatedTokenCountinteger · int32Optional

assistantMessageCountinteger · int32Optional

userMessageCountinteger · int32Optional

totalCountinteger · int32Optional

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

put/projects/{projectIdentifier}/flows/{flowIdentifier}/chats/{objectIdentifier}

HTTPcURLJavaScriptPython

PUT /projects/{projectIdentifier}/flows/{flowIdentifier}/chats/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 111

{
  "name": "text",
  "description": "text",
  "autoRename": true,
  "modelIdentifier": "123e4567-e89b-12d3-a456-426614174000"
}

application/jsontext/jsonapplication/*+json

{
  "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-07-11T01:56:48.271Z",
      "uploadSuccessful": true,
      "tokenCount": 1,
      "metadataTokenCount": 1,
      "indexingNotPossible": true,
      "unsupportedFileType": true,
      "unPackingComplete": true,
      "unPackingFailed": true,
      "uploadInProgress": true,
      "url": "text",
      "hasChildren": true,
      "extension": "text",
      "convertedToPdf": true,
      "fileType": "unknown",
      "uploadFailedReason": "outOfMemory",
      "resourceOwner": {
        "email": "text",
        "name": "text",
        "id": "text"
      },
      "progress": 1,
      "path": "text",
      "parent": {
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "isDirectory": true
      },
      "ocrStrategy": "never",
      "ocrEngine": "azureDocumentIntelligence",
      "coordinateExtractionStrategy": "never",
      "documentUploadSource": "local",
      "pageCount": 1,
      "metadata": [
        {
          "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "key": "text",
          "value": "text"
        }
      ]
    }
  ],
  "dateAdded": "2026-07-11T01:56:48.271Z",
  "documentMetadata": [
    {
      "paragraphs": [
        {
          "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "content": "text",
          "boundingRegions": [
            {
              "points": [
                1
              ],
              "page": 1
            }
          ],
          "role": "title"
        }
      ],
      "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "documentType": "standard",
      "comparedDocumentObjectIdentifiers": [
        "123e4567-e89b-12d3-a456-426614174000"
      ]
    }
  ],
  "estimatedTokenCount": 1,
  "assistantMessageCount": 1,
  "userMessageCount": 1,
  "totalCount": 1,
  "resourceOwner": {
    "email": "text",
    "name": "text",
    "id": "text"
  }
}

Delete a flow chat.

delete

Permanently deletes a chat from the flow. Requires container administrator rights.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

projectIdentifierstringRequired

flowIdentifierstringRequired

Responses

204

No Content

No content

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

delete/projects/{projectIdentifier}/flows/{flowIdentifier}/chats/{objectIdentifier}

HTTPcURLJavaScriptPython

DELETE /projects/{projectIdentifier}/flows/{flowIdentifier}/chats/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Get document token length.

post

Returns the combined token count of the supplied documents, useful for estimating context window usage before attaching them to a chat.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

projectIdentifierstringRequired

flowIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

idsstring · uuid[] · nullableOptional

Responses

200

OK

text/plainapplication/jsontext/json

integer · int64Optional

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

post/projects/{projectIdentifier}/flows/{flowIdentifier}/chats/query-token-length

HTTPcURLJavaScriptPython

POST /projects/{projectIdentifier}/flows/{flowIdentifier}/chats/query-token-length HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "ids": [
    "123e4567-e89b-12d3-a456-426614174000"
  ]
}

application/jsontext/jsonapplication/*+json

1