Prompts
Returns a paginated list of comments attached to a prompt answer, suitable for rendering a discussion thread.
Bearer authentication with JWT
120OK
Bad Request
Unauthorized
Forbidden
GET /projects/{projectIdentifier}/prompt-answers/{promptAnswerObjectIdentifier}/comments HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"items": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptAnswerObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"comment": "text",
"dateAdded": "2026-01-01T00:00:00.000Z",
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}
],
"totalCount": 1
}Creates a new comment against a prompt answer so collaborators can discuss the generated result. Returns the created comment.
Bearer authentication with JWT
Created
Bad Request
Unauthorized
Forbidden
POST /projects/{projectIdentifier}/prompt-answers/{promptAnswerObjectIdentifier}/comments HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18
{
"comment": "text"
}{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptAnswerObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"comment": "text",
"dateAdded": "2026-01-01T00:00:00.000Z",
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}Returns the details of a single prompt answer comment identified by its GUID.
Bearer authentication with JWT
OK
Unauthorized
Forbidden
GET /projects/{projectIdentifier}/prompt-answers/{promptAnswerObjectIdentifier}/comments/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptAnswerObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"comment": "text",
"dateAdded": "2026-01-01T00:00:00.000Z",
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}Edits the text of an existing prompt answer comment and returns the updated comment.
Bearer authentication with JWT
OK
Bad Request
Unauthorized
Forbidden
PUT /projects/{projectIdentifier}/prompt-answers/{promptAnswerObjectIdentifier}/comments/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18
{
"comment": "text"
}{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptAnswerObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"comment": "text",
"dateAdded": "2026-01-01T00:00:00.000Z",
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}Permanently deletes a prompt answer comment. The deletion cannot be undone.
Bearer authentication with JWT
No Content
No content
Unauthorized
Forbidden
DELETE /projects/{projectIdentifier}/prompt-answers/{promptAnswerObjectIdentifier}/comments/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Returns prompts in a flow group, filterable by parent, search term, explicit identifiers or numeric id, with optional answer options.
Bearer authentication with JWT
100trueOK
Unauthorized
Forbidden
GET /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
"[Circular Reference]"
]
}
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}
]Adds a new prompt to a flow group, including its question, model and any answer-based conditions.
Bearer authentication with JWT
OK
Bad Request
Unauthorized
Forbidden
Conflict
POST /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2413
{
"resourceOwner": "text",
"label": "text",
"description": "text",
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": "[Circular Reference]"
}
]
}
]
},
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"conditions": [
{
"promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"promptDataType": "boolean",
"conditionOperator": "and",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true
}{
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": "[Circular Reference]"
}
]
}
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}Creates a copy of a prompt in the same flow group as new entities.
Bearer authentication with JWT
OK
Bad Request
Unauthorized
Forbidden
Conflict
POST /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{promptObjectIdentifier}/duplicate HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": "[Circular Reference]"
}
]
}
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}Returns a single prompt by its GUID, optionally including its answer options and rich question JSON.
Bearer authentication with JWT
OK
Unauthorized
Forbidden
GET /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": "[Circular Reference]"
}
]
}
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}Edits an existing prompt's question, model, data type and conditions.
Bearer authentication with JWT
OK
Bad Request
Unauthorized
Forbidden
Conflict
PUT /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 2408
{
"label": "text",
"description": "text",
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"question": "text",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": "[Circular Reference]"
}
]
}
]
},
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptDataType": "boolean",
"conditionOperator": "and",
"conditions": [
{
"promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true
}{
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": "[Circular Reference]"
}
]
}
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}Permanently removes a prompt from a flow group, provided it is not referenced elsewhere and no run is active.
Bearer authentication with JWT
No Content
No content
Unauthorized
Forbidden
Conflict
DELETE /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{objectIdentifier} HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
No content
Returns the total count of prompts in the flow group.
Bearer authentication with JWT
OK
Unauthorized
Forbidden
GET /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/count HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
1Returns the chain of parent prompts above a given prompt in its flow group.
Bearer authentication with JWT
OK
Unauthorized
Forbidden
GET /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{objectIdentifier}/ancestors HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
"[Circular Reference]"
]
}
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}
]Returns the ancestor prompts for a new prompt that would sit under the given parent.
Bearer authentication with JWT
OK
Unauthorized
Forbidden
GET /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/ancestors-by-parent HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
"[Circular Reference]"
]
}
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}
]Returns the prompts that may be referenced in a mention or condition, excluding those that would create a cycle.
Bearer authentication with JWT
OK
Unauthorized
Forbidden
GET /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/mention-options HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
[
{
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
"[Circular Reference]"
]
}
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}
]Repositions a prompt within its flow group by changing its parent and order.
Bearer authentication with JWT
OK
Bad Request
Unauthorized
Forbidden
PUT /projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{objectIdentifier}/position HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 81
{
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"orderNumber": 1
}{
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": [
{
"type": "text",
"text": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
},
"marks": [
{
"type": "text",
"attrs": {
"id": "text",
"label": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"type": "text",
"promptDataType": "boolean",
"properties": [
{
"type": "text",
"attrs": {
"type": "text",
"uuid": "123e4567-e89b-12d3-a456-426614174000",
"id": "text",
"label": "text",
"renderAs": "text",
"parentMentionId": "123e4567-e89b-12d3-a456-426614174000"
}
}
],
"level": 1,
"href": "text",
"textAlign": "text"
}
}
],
"content": "[Circular Reference]"
}
]
}
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
}Returns a page of prompts for a flow document collection, each with its answer in that collection.
Bearer authentication with JWT
1100trueOK
Bad Request
Unauthorized
Forbidden
GET /projects/{projectIdentifier}/flows/{flowId}/flow-document-collections/{flowDocumentCollectionId}/prompts HTTP/1.1
Host: api.example.uk.jylo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"totalCount": 1,
"page": 1,
"pageSize": 1,
"items": [
{
"prompt": {
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
"[Circular Reference]"
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
},
"answer": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"booleanAnswer": true,
"textAnswer": "text",
"decimalAnswer": 1,
"dateAnswer": "2026-01-01T00:00:00.000Z",
"assignedTo": "text",
"reviewedBy": "text",
"approved": true,
"dateAdded": "2026-01-01T00:00:00.000Z",
"assignedToMember": {
"id": "text",
"name": "text",
"email": "text"
},
"reviewedByMember": {
"id": "text",
"name": "text",
"email": "text"
},
"hasChildren": true,
"approvedPromptCount": 1,
"rejectedPromptCount": 1,
"awaitingVerificationCount": 1,
"prompt": {
"dateAdded": "2026-01-01T00:00:00.000Z",
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"stableObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"description": "text",
"promptDataType": "boolean",
"conditionOperator": "and",
"categories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": "primary"
}
],
"minimumValue": 1,
"maximumValue": 1,
"found": true,
"hasChildren": true,
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"parentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"runStatus": "pending",
"question": "text",
"questionJson": {
"type": "text",
"content": [
"[Circular Reference]"
]
},
"modelIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"reasoningEffort": "none",
"canEdit": true,
"includeDocuments": true,
"conditions": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"promptPredicate": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"label": "text",
"promptDataType": "boolean"
},
"isYes": true,
"fuzzyMatch": true,
"minimumDecimalAnswer": 1,
"maximumDecimalAnswer": 1,
"textAnswer": "text",
"allCategoriesMatch": true,
"decimalAnswer": 1,
"decimalOperator": "equal",
"dateOperator": "equal",
"startDate": "2026-01-01T00:00:00.000Z",
"endDate": "2026-01-01T00:00:00.000Z",
"dateAnswer": "2026-01-01T00:00:00.000Z",
"categories": [
{
"category": "text"
}
]
}
],
"resourceOwnerId": "text",
"resourceOwner": {
"name": "text",
"id": "text",
"email": "text",
"picture": "text",
"roles": [
{
"id": "text",
"name": "text"
}
]
}
},
"promptAnswerCategories": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"category": {
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"name": "text",
"colour": 1
},
"name": "text",
"colour": 1,
"evidence": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"polygonPoints": [
1
],
"pageNumber": 1,
"quoteOnly": true,
"paragraphObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
}
]
}
],
"evidence": [
{
"objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"text": "text",
"polygonPoints": [
1
],
"pageNumber": 1,
"quoteOnly": true,
"paragraphObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
"documentObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000"
}
]
},
"conditionsNotMet": true,
"skipReason": "none",
"skipDetail": "text",
"skipOperator": "text",
"skipClauses": [
{
"predicate": "text",
"condition": "text",
"actual": "text",
"expectedValues": [
"text"
],
"actualValues": [
"text"
]
}
]
}
]
}Last updated
