For the complete documentation index, see llms.txt. This page is also available as Markdown.

Prompts

List comments for a prompt answer.

get

Returns a paginated list of comments attached to a prompt answer, suitable for rendering a discussion thread.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
promptAnswerObjectIdentifierstring · uuidRequired
projectIdentifierstringRequired
Query parameters
pageinteger · int32OptionalDefault: 1
pageSizeinteger · int32OptionalDefault: 20
Responses
200

OK

totalCountinteger · int32Optional
get/projects/{projectIdentifier}/prompt-answers/{promptAnswerObjectIdentifier}/comments

Add a comment to a prompt answer.

post

Creates a new comment against a prompt answer so collaborators can discuss the generated result. Returns the created comment.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
promptAnswerObjectIdentifierstring · uuidRequired
projectIdentifierstringRequired
Body
commentstring · nullableRequired
Responses
201

Created

objectIdentifierstring · uuidOptional
promptAnswerObjectIdentifierstring · uuidOptional
commentstring · nullableOptional
dateAddedstring · date-timeOptional
resourceOwnerIdstring · nullableOptional
post/projects/{projectIdentifier}/prompt-answers/{promptAnswerObjectIdentifier}/comments

Get a prompt answer comment.

get

Returns the details of a single prompt answer comment identified by its GUID.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
objectIdentifierstring · uuidRequired
projectIdentifierstringRequired
promptAnswerObjectIdentifierstringRequired
Responses
200

OK

objectIdentifierstring · uuidOptional
promptAnswerObjectIdentifierstring · uuidOptional
commentstring · nullableOptional
dateAddedstring · date-timeOptional
resourceOwnerIdstring · nullableOptional
get/projects/{projectIdentifier}/prompt-answers/{promptAnswerObjectIdentifier}/comments/{objectIdentifier}

Update a prompt answer comment.

put

Edits the text of an existing prompt answer comment and returns the updated comment.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
objectIdentifierstring · uuidRequired
projectIdentifierstringRequired
promptAnswerObjectIdentifierstringRequired
Body
commentstring · nullableRequired
Responses
200

OK

objectIdentifierstring · uuidOptional
promptAnswerObjectIdentifierstring · uuidOptional
commentstring · nullableOptional
dateAddedstring · date-timeOptional
resourceOwnerIdstring · nullableOptional
put/projects/{projectIdentifier}/prompt-answers/{promptAnswerObjectIdentifier}/comments/{objectIdentifier}

Delete a prompt answer comment.

delete

Permanently deletes a prompt answer comment. The deletion cannot be undone.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
objectIdentifierstring · uuidRequired
projectIdentifierstringRequired
promptAnswerObjectIdentifierstringRequired
Responses
204

No Content

No content

delete/projects/{projectIdentifier}/prompt-answers/{promptAnswerObjectIdentifier}/comments/{objectIdentifier}

No content

List prompts.

get

Returns prompts in a flow group, filterable by parent, search term, explicit identifiers or numeric id, with optional answer options.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
flowGroupObjectIdentifierstring · uuidRequired
projectIdentifierstringRequired
Query parameters
includeOptionsbooleanOptional
flattenbooleanOptional
parentObjectIdentifierstring · uuidOptional
offsetObjectIdentifierstring · uuidOptional
takeinteger · int32OptionalDefault: 100
searchTermstringOptional
sortingstring · enumOptionalPossible values:
descbooleanOptionalDefault: true
idinteger · int32Optional
objectIdentifiersstringOptional
Responses
200

OK

dateAddedstring · date-timeOptional
objectIdentifierstring · uuidOptional
stableObjectIdentifierstring · uuidOptional
labelstring · nullableOptional
descriptionstring · nullableOptional
promptDataTypestring · enumOptionalPossible values:
conditionOperatorstring · enumOptionalPossible values:
minimumValuenumber · double · nullableOptional
maximumValuenumber · double · nullableOptional
foundboolean · nullableOptional
hasChildrenboolean · nullableOptional
startDatestring · date-time · nullableOptional
endDatestring · date-time · nullableOptional
parentObjectIdentifierstring · uuid · nullableOptional
runStatusstring · enumOptionalPossible values:
questionstring · nullableOptional
modelIdentifierstring · uuid · nullableOptional
reasoningEffortstring · enumOptionalPossible values:
canEditbooleanOptional
includeDocumentsbooleanOptional
resourceOwnerIdstring · nullableOptional
get/projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts

Create a prompt.

post

Adds a new prompt to a flow group, including its question, model and any answer-based conditions.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
flowGroupObjectIdentifierstring · uuidRequired
projectIdentifierstringRequired
Body
resourceOwnerstring · nullableOptional
labelstring · nullableOptional
descriptionstring · nullableOptional
modelIdentifierstring · uuid · nullableOptional
parentObjectIdentifierstring · uuid · nullableOptional
promptDataTypestring · enumOptionalPossible values:
conditionOperatorstring · enumOptionalPossible values:
reasoningEffortstring · enumOptionalPossible values:
canEditbooleanOptional
includeDocumentsbooleanOptional
Responses
200

OK

dateAddedstring · date-timeOptional
objectIdentifierstring · uuidOptional
stableObjectIdentifierstring · uuidOptional
labelstring · nullableOptional
descriptionstring · nullableOptional
promptDataTypestring · enumOptionalPossible values:
conditionOperatorstring · enumOptionalPossible values:
minimumValuenumber · double · nullableOptional
maximumValuenumber · double · nullableOptional
foundboolean · nullableOptional
hasChildrenboolean · nullableOptional
startDatestring · date-time · nullableOptional
endDatestring · date-time · nullableOptional
parentObjectIdentifierstring · uuid · nullableOptional
runStatusstring · enumOptionalPossible values:
questionstring · nullableOptional
modelIdentifierstring · uuid · nullableOptional
reasoningEffortstring · enumOptionalPossible values:
canEditbooleanOptional
includeDocumentsbooleanOptional
resourceOwnerIdstring · nullableOptional
post/projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts

Get a prompt.

get

Returns a single prompt by its GUID, optionally including its answer options and rich question JSON.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
objectIdentifierstring · uuidRequired
projectIdentifierstringRequired
flowGroupObjectIdentifierstringRequired
Query parameters
includeOptionsbooleanOptional
includeQuestionJsonbooleanOptional
Responses
200

OK

dateAddedstring · date-timeOptional
objectIdentifierstring · uuidOptional
stableObjectIdentifierstring · uuidOptional
labelstring · nullableOptional
descriptionstring · nullableOptional
promptDataTypestring · enumOptionalPossible values:
conditionOperatorstring · enumOptionalPossible values:
minimumValuenumber · double · nullableOptional
maximumValuenumber · double · nullableOptional
foundboolean · nullableOptional
hasChildrenboolean · nullableOptional
startDatestring · date-time · nullableOptional
endDatestring · date-time · nullableOptional
parentObjectIdentifierstring · uuid · nullableOptional
runStatusstring · enumOptionalPossible values:
questionstring · nullableOptional
modelIdentifierstring · uuid · nullableOptional
reasoningEffortstring · enumOptionalPossible values:
canEditbooleanOptional
includeDocumentsbooleanOptional
resourceOwnerIdstring · nullableOptional
get/projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{objectIdentifier}

Update a prompt.

put

Edits an existing prompt's question, model, data type and conditions.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
objectIdentifierstring · uuidRequired
projectIdentifierstringRequired
flowGroupObjectIdentifierstringRequired
Body
labelstring · nullableOptional
descriptionstring · nullableOptional
modelIdentifierstring · uuid · nullableOptional
questionstring · nullableOptional
parentObjectIdentifierstring · uuid · nullableOptional
promptDataTypestring · enumOptionalPossible values:
conditionOperatorstring · enumOptionalPossible values:
reasoningEffortstring · enumOptionalPossible values:
canEditboolean · nullableOptional
includeDocumentsboolean · nullableOptional
Responses
200

OK

dateAddedstring · date-timeOptional
objectIdentifierstring · uuidOptional
stableObjectIdentifierstring · uuidOptional
labelstring · nullableOptional
descriptionstring · nullableOptional
promptDataTypestring · enumOptionalPossible values:
conditionOperatorstring · enumOptionalPossible values:
minimumValuenumber · double · nullableOptional
maximumValuenumber · double · nullableOptional
foundboolean · nullableOptional
hasChildrenboolean · nullableOptional
startDatestring · date-time · nullableOptional
endDatestring · date-time · nullableOptional
parentObjectIdentifierstring · uuid · nullableOptional
runStatusstring · enumOptionalPossible values:
questionstring · nullableOptional
modelIdentifierstring · uuid · nullableOptional
reasoningEffortstring · enumOptionalPossible values:
canEditbooleanOptional
includeDocumentsbooleanOptional
resourceOwnerIdstring · nullableOptional
put/projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{objectIdentifier}

Delete a prompt.

delete

Permanently removes a prompt from a flow group, provided it is not referenced elsewhere and no run is active.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
objectIdentifierstring · uuidRequired
projectIdentifierstringRequired
flowGroupObjectIdentifierstringRequired
Responses
204

No Content

No content

delete/projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{objectIdentifier}

No content

Count prompts.

get

Returns the total count of prompts in the flow group.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
flowGroupObjectIdentifierstring · uuidRequired
projectIdentifierstringRequired
Responses
200

OK

integer · int32Optional
get/projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/count

List a prompt's ancestors.

get

Returns the chain of parent prompts above a given prompt in its flow group.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
flowGroupObjectIdentifierstring · uuidRequired
objectIdentifierstring · uuidRequired
projectIdentifierstringRequired
Query parameters
searchTextstringOptional
Responses
200

OK

dateAddedstring · date-timeOptional
objectIdentifierstring · uuidOptional
stableObjectIdentifierstring · uuidOptional
labelstring · nullableOptional
descriptionstring · nullableOptional
promptDataTypestring · enumOptionalPossible values:
conditionOperatorstring · enumOptionalPossible values:
minimumValuenumber · double · nullableOptional
maximumValuenumber · double · nullableOptional
foundboolean · nullableOptional
hasChildrenboolean · nullableOptional
startDatestring · date-time · nullableOptional
endDatestring · date-time · nullableOptional
parentObjectIdentifierstring · uuid · nullableOptional
runStatusstring · enumOptionalPossible values:
questionstring · nullableOptional
modelIdentifierstring · uuid · nullableOptional
reasoningEffortstring · enumOptionalPossible values:
canEditbooleanOptional
includeDocumentsbooleanOptional
resourceOwnerIdstring · nullableOptional
get/projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{objectIdentifier}/ancestors

List ancestors by parent.

get

Returns the ancestor prompts for a new prompt that would sit under the given parent.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
flowGroupObjectIdentifierstring · uuidRequired
projectIdentifierstringRequired
Query parameters
parentObjectIdentifierstring · uuidOptional
searchTextstringOptional
Responses
200

OK

dateAddedstring · date-timeOptional
objectIdentifierstring · uuidOptional
stableObjectIdentifierstring · uuidOptional
labelstring · nullableOptional
descriptionstring · nullableOptional
promptDataTypestring · enumOptionalPossible values:
conditionOperatorstring · enumOptionalPossible values:
minimumValuenumber · double · nullableOptional
maximumValuenumber · double · nullableOptional
foundboolean · nullableOptional
hasChildrenboolean · nullableOptional
startDatestring · date-time · nullableOptional
endDatestring · date-time · nullableOptional
parentObjectIdentifierstring · uuid · nullableOptional
runStatusstring · enumOptionalPossible values:
questionstring · nullableOptional
modelIdentifierstring · uuid · nullableOptional
reasoningEffortstring · enumOptionalPossible values:
canEditbooleanOptional
includeDocumentsbooleanOptional
resourceOwnerIdstring · nullableOptional
get/projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/ancestors-by-parent

List mention options.

get

Returns the prompts that may be referenced in a mention or condition, excluding those that would create a cycle.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
flowGroupObjectIdentifierstring · uuidRequired
projectIdentifierstringRequired
Query parameters
objectIdentifierstring · uuidOptional
parentObjectIdentifierstring · uuidOptional
searchTextstringOptional
Responses
200

OK

dateAddedstring · date-timeOptional
objectIdentifierstring · uuidOptional
stableObjectIdentifierstring · uuidOptional
labelstring · nullableOptional
descriptionstring · nullableOptional
promptDataTypestring · enumOptionalPossible values:
conditionOperatorstring · enumOptionalPossible values:
minimumValuenumber · double · nullableOptional
maximumValuenumber · double · nullableOptional
foundboolean · nullableOptional
hasChildrenboolean · nullableOptional
startDatestring · date-time · nullableOptional
endDatestring · date-time · nullableOptional
parentObjectIdentifierstring · uuid · nullableOptional
runStatusstring · enumOptionalPossible values:
questionstring · nullableOptional
modelIdentifierstring · uuid · nullableOptional
reasoningEffortstring · enumOptionalPossible values:
canEditbooleanOptional
includeDocumentsbooleanOptional
resourceOwnerIdstring · nullableOptional
get/projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/mention-options

Move a prompt.

put

Repositions a prompt within its flow group by changing its parent and order.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
flowGroupObjectIdentifierstring · uuidRequired
objectIdentifierstring · uuidRequired
projectIdentifierstringRequired
Body
parentObjectIdentifierstring · uuid · nullableOptional
orderNumberinteger · int32Optional
Responses
200

OK

dateAddedstring · date-timeOptional
objectIdentifierstring · uuidOptional
stableObjectIdentifierstring · uuidOptional
labelstring · nullableOptional
descriptionstring · nullableOptional
promptDataTypestring · enumOptionalPossible values:
conditionOperatorstring · enumOptionalPossible values:
minimumValuenumber · double · nullableOptional
maximumValuenumber · double · nullableOptional
foundboolean · nullableOptional
hasChildrenboolean · nullableOptional
startDatestring · date-time · nullableOptional
endDatestring · date-time · nullableOptional
parentObjectIdentifierstring · uuid · nullableOptional
runStatusstring · enumOptionalPossible values:
questionstring · nullableOptional
modelIdentifierstring · uuid · nullableOptional
reasoningEffortstring · enumOptionalPossible values:
canEditbooleanOptional
includeDocumentsbooleanOptional
resourceOwnerIdstring · nullableOptional
put/projects/{projectIdentifier}/flow-groups/{flowGroupObjectIdentifier}/prompts/{objectIdentifier}/position

List prompts with answers.

get

Returns a page of prompts for a flow document collection, each with its answer in that collection.

Authorizations
AuthorizationstringRequired

Bearer authentication with JWT

Path parameters
flowIdstring · uuidRequired
flowDocumentCollectionIdstring · uuidRequired
projectIdentifierstringRequired
Query parameters
parentObjectIdentifierstring · uuidOptional
pageinteger · int32OptionalDefault: 1
pageSizeinteger · int32OptionalDefault: 100
searchTermstringOptional
sortingstring · enumOptionalPossible values:
descbooleanOptionalDefault: true
Responses
200

OK

totalCountinteger · int32Optional
pageinteger · int32Optional
pageSizeinteger · int32Optional
get/projects/{projectIdentifier}/flows/{flowId}/flow-document-collections/{flowDocumentCollectionId}/prompts

Last updated