Flow Documents

List documents in a flow collection.

get

Returns a paginated list of documents in the specified flow document collection, including the total count for pagination.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

collectionObjectIdentifierstring · uuidRequired

projectIdentifierstringRequired

Query parameters

skipinteger · int32OptionalDefault: 0

takeinteger · int32OptionalDefault: 50

Responses

200

OK

text/plainapplication/jsontext/json

totalCountinteger · int32Optional

skipinteger · int32Optional

takeinteger · int32Optional

401

Unauthorized

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

get/projects/{projectIdentifier}/flow-document-collections/{collectionObjectIdentifier}/documents

HTTPcURLJavaScriptPython

GET /projects/{projectIdentifier}/flow-document-collections/{collectionObjectIdentifier}/documents HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalCount": 1,
  "skip": 1,
  "take": 1,
  "items": [
    {
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "flowDocumentCollectionObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "dateAdded": "2026-07-10T20:28:48.427Z",
      "document": {
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "name": "text",
        "contentType": "text",
        "extension": "text",
        "size": 1,
        "dateAdded": "2026-07-10T20:28:48.427Z",
        "fileType": "unknown",
        "tokenCount": 1,
        "pageCount": 1,
        "convertedToPdf": true
      }
    }
  ]
}

Add a document to a flow collection.

post

Links an existing document into a flow document collection so it can be used by flows in the project.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

collectionObjectIdentifierstring · uuidRequired

projectIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

documentObjectIdentifierstring · uuidRequired

Responses

200

OK

text/plainapplication/jsontext/json

objectIdentifierstring · uuidOptional

namestring · nullableOptional

flowDocumentCollectionObjectIdentifierstring · uuidOptional

dateAddedstring · date-timeOptional

401

Unauthorized

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

post/projects/{projectIdentifier}/flow-document-collections/{collectionObjectIdentifier}/documents

HTTPcURLJavaScriptPython

POST /projects/{projectIdentifier}/flow-document-collections/{collectionObjectIdentifier}/documents HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 67

{
  "documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
}

application/jsontext/jsonapplication/*+json

{
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "flowDocumentCollectionObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "dateAdded": "2026-07-10T20:28:48.427Z",
  "document": {
    "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "name": "text",
    "contentType": "text",
    "extension": "text",
    "size": 1,
    "dateAdded": "2026-07-10T20:28:48.427Z",
    "fileType": "unknown",
    "tokenCount": 1,
    "pageCount": 1,
    "convertedToPdf": true
  }
}

Remove a document from a flow collection.

delete

Unlinks a document from its flow document collection. The original document is not deleted, only its association with the collection. All prompt answers for that collection are deleted because they are no longer valid once the collection's documents change.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

projectIdentifierstringRequired

Responses

204

No Content

No content

401

Unauthorized

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

delete/projects/{projectIdentifier}/flow-documents/{objectIdentifier}

HTTPcURLJavaScriptPython

DELETE /projects/{projectIdentifier}/flow-documents/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List flow reference material documents.

get

Returns a paginated list of the documents and folders within a flow reference material.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

referenceMaterialObjectIdentifierstring · uuidRequired

projectIdentifierstringRequired

flowObjectIdentifierstringRequired

Query parameters

pageNumberinteger · int32OptionalDefault: 1

pageSizeinteger · int32OptionalDefault: 20

Responses

200

OK

text/plainapplication/jsontext/json

totalCountinteger · int32Optional

400

Bad Request

text/plainapplication/jsontext/json

401

Unauthorized

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

get/projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents

HTTPcURLJavaScriptPython

GET /projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "name": "text",
      "isDirectory": true,
      "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "flowReferenceMaterialObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "dateAdded": "2026-07-10T20:28:48.427Z",
      "resourceOwnerId": "text",
      "resourceOwner": {
        "name": "text",
        "id": "text",
        "email": "text",
        "picture": "text",
        "roles": [
          {
            "id": "text",
            "name": "text"
          }
        ]
      }
    }
  ],
  "totalCount": 1
}

Create a flow document or folder.

post

Creates a new document or folder within a flow reference material's file tree, optionally nested under a parent folder.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

referenceMaterialObjectIdentifierstring · uuidRequired

projectIdentifierstringRequired

flowObjectIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

namestring · nullableRequired

parentObjectIdentifierstring · uuid · nullableOptional

isDirectorybooleanOptional

documentUploadObjectIdentifierstring · uuid · nullableOptional

Responses

201

Created

text/plainapplication/jsontext/json

objectIdentifierstring · uuidOptional

namestring · nullableOptional

isDirectorybooleanOptional

parentObjectIdentifierstring · uuid · nullableOptional

documentUploadObjectIdentifierstring · uuid · nullableOptional

flowReferenceMaterialObjectIdentifierstring · uuidOptional

dateAddedstring · date-timeOptional

resourceOwnerIdstring · nullableOptional

401

Unauthorized

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

post/projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents

HTTPcURLJavaScriptPython

POST /projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 170

{
  "name": "text",
  "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "isDirectory": true,
  "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
}

application/jsontext/jsonapplication/*+json

{
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "isDirectory": true,
  "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "flowReferenceMaterialObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "dateAdded": "2026-07-10T20:28:48.427Z",
  "resourceOwnerId": "text",
  "resourceOwner": {
    "name": "text",
    "id": "text",
    "email": "text",
    "picture": "text",
    "roles": [
      {
        "id": "text",
        "name": "text"
      }
    ]
  }
}

Get a flow document by id.

get

Returns the details of a single document or folder within a flow reference material.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

projectIdentifierstringRequired

flowObjectIdentifierstringRequired

referenceMaterialObjectIdentifierstringRequired

Responses

200

OK

text/plainapplication/jsontext/json

objectIdentifierstring · uuidOptional

namestring · nullableOptional

isDirectorybooleanOptional

parentObjectIdentifierstring · uuid · nullableOptional

documentUploadObjectIdentifierstring · uuid · nullableOptional

flowReferenceMaterialObjectIdentifierstring · uuidOptional

dateAddedstring · date-timeOptional

resourceOwnerIdstring · nullableOptional

401

Unauthorized

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

get/projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents/{objectIdentifier}

HTTPcURLJavaScriptPython

GET /projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "isDirectory": true,
  "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "flowReferenceMaterialObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "dateAdded": "2026-07-10T20:28:48.427Z",
  "resourceOwnerId": "text",
  "resourceOwner": {
    "name": "text",
    "id": "text",
    "email": "text",
    "picture": "text",
    "roles": [
      {
        "id": "text",
        "name": "text"
      }
    ]
  }
}

Update a flow document.

put

Updates a flow document or folder, for example to move it to a different parent folder.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

projectIdentifierstringRequired

flowObjectIdentifierstringRequired

referenceMaterialObjectIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

parentObjectIdentifierstring · uuid · nullableOptional

Responses

200

OK

text/plainapplication/jsontext/json

objectIdentifierstring · uuidOptional

namestring · nullableOptional

isDirectorybooleanOptional

parentObjectIdentifierstring · uuid · nullableOptional

documentUploadObjectIdentifierstring · uuid · nullableOptional

flowReferenceMaterialObjectIdentifierstring · uuidOptional

dateAddedstring · date-timeOptional

resourceOwnerIdstring · nullableOptional

401

Unauthorized

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

put/projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents/{objectIdentifier}

HTTPcURLJavaScriptPython

PUT /projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 65

{
  "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
}

application/jsontext/jsonapplication/*+json

{
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "name": "text",
  "isDirectory": true,
  "parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "documentUploadObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "flowReferenceMaterialObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "dateAdded": "2026-07-10T20:28:48.427Z",
  "resourceOwnerId": "text",
  "resourceOwner": {
    "name": "text",
    "id": "text",
    "email": "text",
    "picture": "text",
    "roles": [
      {
        "id": "text",
        "name": "text"
      }
    ]
  }
}

Delete a flow document or folder.

delete

Permanently deletes a document or folder from a flow reference material.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

projectIdentifierstringRequired

flowObjectIdentifierstringRequired

referenceMaterialObjectIdentifierstringRequired

Responses

204

No Content

No content

401

Unauthorized

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

delete/projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents/{objectIdentifier}

HTTPcURLJavaScriptPython

DELETE /projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

Download a flow document file.

get

Streams the file content of a flow document, optionally as a PDF rendition.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

projectIdentifierstringRequired

flowObjectIdentifierstringRequired

referenceMaterialObjectIdentifierstringRequired

Query parameters

usePdfbooleanOptionalDefault: false

Responses

200

OK

text/plainapplication/jsontext/json

string · binaryOptional

401

Unauthorized

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

get/projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents/{objectIdentifier}/download

HTTPcURLJavaScriptPython

GET /projects/{projectIdentifier}/flows/{flowObjectIdentifier}/reference-materials/{referenceMaterialObjectIdentifier}/documents/{objectIdentifier}/download HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary