Flow Prompts

Retrieves a paginated list of prompts for the specified flow.

get

Retrieves a paginated list of prompts for the specified flow, optionally filtered and sorted.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

flowIdentifierstring · uuidRequired

The unique identifier of the flow.

projectIdentifierstringRequired

Query parameters

includeOptionsbooleanOptional

Whether to include prompt options in the result.

flattenbooleanOptional

Whether to flatten the prompt structure.

parentObjectIdentifierstring · uuidOptional

Optional parent object identifier.

pageNumberinteger · int32Optional

The page number to retrieve.

pageSizeinteger · int32Optional

The number of items per page.

searchTextstringOptional

Optional search text to prompt prompts.

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

403

Forbidden

text/plainapplication/jsontext/json

get

/projects/{projectIdentifier}/flows/{flowIdentifier}/prompts

HTTPcURLJavaScriptPython

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

[
  {
    "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",
            "filterDataTypeId": 1,
            "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",
                "filterDataTypeId": 1,
                "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": [
      {
        "fuzzyMatch": true,
        "isYes": true,
        "minimumDecimalAnswer": 1,
        "maximumDecimalAnswer": 1,
        "decimalOperator": "Equal",
        "decimalAnswer": 1,
        "textAnswer": "text",
        "promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "categories": [
          {
            "fuzzyMatch": true,
            "text": "text"
          }
        ],
        "allCategoriesMatch": true,
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "promptPredicate": {
          "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",
                  "filterDataTypeId": 1,
                  "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",
                      "filterDataTypeId": 1,
                      "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": [
            "[Circular Reference]"
          ],
          "promptDataTypeId": 1,
          "dateAdded": "2026-01-27T17:31:14.912Z",
          "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
          "categories": [
            {
              "name": "text",
              "colour": 0,
              "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
              "colourHex": "text"
            }
          ],
          "minimumValue": 1,
          "maximumValue": 1,
          "found": true,
          "hasChildren": true
        }
      }
    ],
    "promptDataTypeId": 1,
    "dateAdded": "2026-01-27T17:31:14.912Z",
    "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
    "categories": [
      {
        "name": "text",
        "colour": 0,
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "colourHex": "text"
      }
    ],
    "minimumValue": 1,
    "maximumValue": 1,
    "found": true,
    "hasChildren": true
  }
]

Creates a new prompt for the specified flow.

post

Creates a new prompt for the specified flow.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

projectIdentifierstringRequired

flowIdentifierstringRequired

Query parameters

parentResourceObjectIdentifierstring · uuidOptional

The object identifier of the flow.

Body

application/jsontext/jsonapplication/*+json

labelstring · nullableRequired

descriptionstring · nullableRequired

modelIdentifierstring · uuid · nullableOptional

questionstring · nullableOptional

parentObjectIdentifierstring · uuid · nullableOptional

promptDataTypeIdinteger · int32Required

Responses

200

OK

text/plainapplication/jsontext/json

400

Bad Request

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

post

/projects/{projectIdentifier}/flows/{flowIdentifier}/prompts

HTTPcURLJavaScriptPython

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

{
  "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",
          "filterDataTypeId": 1,
          "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",
              "filterDataTypeId": 1,
              "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",
              "filterDataTypeId": 1,
              "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",
                  "filterDataTypeId": 1,
                  "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": [
    {
      "fuzzyMatch": true,
      "isYes": true,
      "minimumDecimalAnswer": 1,
      "maximumDecimalAnswer": 1,
      "decimalOperator": "Equal",
      "decimalAnswer": 1,
      "textAnswer": "text",
      "promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "categories": [
        {
          "fuzzyMatch": true,
          "text": "text"
        }
      ],
      "allCategoriesMatch": true
    }
  ],
  "promptDataTypeId": 1
}

application/jsontext/jsonapplication/*+json

{
  "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",
          "filterDataTypeId": 1,
          "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",
              "filterDataTypeId": 1,
              "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",
              "filterDataTypeId": 1,
              "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",
                  "filterDataTypeId": 1,
                  "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": [
    {
      "fuzzyMatch": true,
      "isYes": true,
      "minimumDecimalAnswer": 1,
      "maximumDecimalAnswer": 1,
      "decimalOperator": "Equal",
      "decimalAnswer": 1,
      "textAnswer": "text",
      "promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "categories": [
        {
          "fuzzyMatch": true,
          "text": "text"
        }
      ],
      "allCategoriesMatch": true,
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "promptPredicate": {
        "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",
                "filterDataTypeId": 1,
                "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",
                    "filterDataTypeId": 1,
                    "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",
                    "filterDataTypeId": 1,
                    "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",
                        "filterDataTypeId": 1,
                        "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": [
          {
            "fuzzyMatch": true,
            "isYes": true,
            "minimumDecimalAnswer": 1,
            "maximumDecimalAnswer": 1,
            "decimalOperator": "Equal",
            "decimalAnswer": 1,
            "textAnswer": "text",
            "promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "categories": [
              {
                "fuzzyMatch": true,
                "text": "text"
              }
            ],
            "allCategoriesMatch": true,
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "promptPredicate": "[Circular Reference]"
          }
        ],
        "promptDataTypeId": 1,
        "dateAdded": "2026-01-27T17:31:14.912Z",
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "categories": [
          {
            "name": "text",
            "colour": 0,
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "colourHex": "text"
          }
        ],
        "minimumValue": 1,
        "maximumValue": 1,
        "found": true,
        "hasChildren": true
      }
    }
  ],
  "promptDataTypeId": 1,
  "dateAdded": "2026-01-27T17:31:14.912Z",
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "categories": [
    {
      "name": "text",
      "colour": 0,
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "colourHex": "text"
    }
  ],
  "minimumValue": 1,
  "maximumValue": 1,
  "found": true,
  "hasChildren": true
}

Retrieves a prompt by its object identifier.

get

Retrieves a prompt by its object identifier.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

The unique identifier of the prompt.

projectIdentifierstringRequired

flowIdentifierstringRequired

Query parameters

includeOptionsbooleanOptional

Whether to include prompt options in the result.

Responses

200

OK

text/plainapplication/jsontext/json

403

Forbidden

text/plainapplication/jsontext/json

404

Not Found

text/plainapplication/jsontext/json

get

/projects/{projectIdentifier}/flows/{flowIdentifier}/prompts/{objectIdentifier}

HTTPcURLJavaScriptPython

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

{
  "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",
          "filterDataTypeId": 1,
          "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",
              "filterDataTypeId": 1,
              "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",
              "filterDataTypeId": 1,
              "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",
                  "filterDataTypeId": 1,
                  "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": [
    {
      "fuzzyMatch": true,
      "isYes": true,
      "minimumDecimalAnswer": 1,
      "maximumDecimalAnswer": 1,
      "decimalOperator": "Equal",
      "decimalAnswer": 1,
      "textAnswer": "text",
      "promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "categories": [
        {
          "fuzzyMatch": true,
          "text": "text"
        }
      ],
      "allCategoriesMatch": true,
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "promptPredicate": {
        "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",
                "filterDataTypeId": 1,
                "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",
                    "filterDataTypeId": 1,
                    "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",
                    "filterDataTypeId": 1,
                    "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",
                        "filterDataTypeId": 1,
                        "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": [
          {
            "fuzzyMatch": true,
            "isYes": true,
            "minimumDecimalAnswer": 1,
            "maximumDecimalAnswer": 1,
            "decimalOperator": "Equal",
            "decimalAnswer": 1,
            "textAnswer": "text",
            "promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "categories": [
              {
                "fuzzyMatch": true,
                "text": "text"
              }
            ],
            "allCategoriesMatch": true,
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "promptPredicate": "[Circular Reference]"
          }
        ],
        "promptDataTypeId": 1,
        "dateAdded": "2026-01-27T17:31:14.912Z",
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "categories": [
          {
            "name": "text",
            "colour": 0,
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "colourHex": "text"
          }
        ],
        "minimumValue": 1,
        "maximumValue": 1,
        "found": true,
        "hasChildren": true
      }
    }
  ],
  "promptDataTypeId": 1,
  "dateAdded": "2026-01-27T17:31:14.912Z",
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "categories": [
    {
      "name": "text",
      "colour": 0,
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "colourHex": "text"
    }
  ],
  "minimumValue": 1,
  "maximumValue": 1,
  "found": true,
  "hasChildren": true
}

Updates a prompt by its object identifier.

put

Updates a prompt by its object identifier.

Authorizations

Bearer

AuthorizationstringRequired

Bearer authentication with JWT

Path parameters

objectIdentifierstring · uuidRequired

The unique identifier of the prompt to update.

projectIdentifierstringRequired

flowIdentifierstringRequired

Body

application/jsontext/jsonapplication/*+json

labelstring · nullableRequired

descriptionstring · nullableRequired

modelIdentifierstring · uuid · nullableOptional

questionstring · nullableOptional

parentObjectIdentifierstring · uuid · nullableOptional

promptDataTypeIdinteger · int32Required

Responses

200

OK

text/plainapplication/jsontext/json

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}/prompts/{objectIdentifier}

HTTPcURLJavaScriptPython

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

{
  "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",
          "filterDataTypeId": 1,
          "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",
              "filterDataTypeId": 1,
              "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",
              "filterDataTypeId": 1,
              "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",
                  "filterDataTypeId": 1,
                  "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": [
    {
      "fuzzyMatch": true,
      "isYes": true,
      "minimumDecimalAnswer": 1,
      "maximumDecimalAnswer": 1,
      "decimalOperator": "Equal",
      "decimalAnswer": 1,
      "textAnswer": "text",
      "promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "categories": [
        {
          "fuzzyMatch": true,
          "text": "text"
        }
      ],
      "allCategoriesMatch": true
    }
  ],
  "promptDataTypeId": 1
}

application/jsontext/jsonapplication/*+json

{
  "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",
          "filterDataTypeId": 1,
          "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",
              "filterDataTypeId": 1,
              "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",
              "filterDataTypeId": 1,
              "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",
                  "filterDataTypeId": 1,
                  "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": [
    {
      "fuzzyMatch": true,
      "isYes": true,
      "minimumDecimalAnswer": 1,
      "maximumDecimalAnswer": 1,
      "decimalOperator": "Equal",
      "decimalAnswer": 1,
      "textAnswer": "text",
      "promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "categories": [
        {
          "fuzzyMatch": true,
          "text": "text"
        }
      ],
      "allCategoriesMatch": true,
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "promptPredicate": {
        "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",
                "filterDataTypeId": 1,
                "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",
                    "filterDataTypeId": 1,
                    "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",
                    "filterDataTypeId": 1,
                    "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",
                        "filterDataTypeId": 1,
                        "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": [
          {
            "fuzzyMatch": true,
            "isYes": true,
            "minimumDecimalAnswer": 1,
            "maximumDecimalAnswer": 1,
            "decimalOperator": "Equal",
            "decimalAnswer": 1,
            "textAnswer": "text",
            "promptPredicateObjectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "categories": [
              {
                "fuzzyMatch": true,
                "text": "text"
              }
            ],
            "allCategoriesMatch": true,
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "promptPredicate": "[Circular Reference]"
          }
        ],
        "promptDataTypeId": 1,
        "dateAdded": "2026-01-27T17:31:14.912Z",
        "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
        "categories": [
          {
            "name": "text",
            "colour": 0,
            "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
            "colourHex": "text"
          }
        ],
        "minimumValue": 1,
        "maximumValue": 1,
        "found": true,
        "hasChildren": true
      }
    }
  ],
  "promptDataTypeId": 1,
  "dateAdded": "2026-01-27T17:31:14.912Z",
  "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
  "categories": [
    {
      "name": "text",
      "colour": 0,
      "objectIdentifier": "123e4567-e89b-12d3-a456-426614174000",
      "colourHex": "text"
    }
  ],
  "minimumValue": 1,
  "maximumValue": 1,
  "found": true,
  "hasChildren": true
}