v1

latestOpenAPI 3.0.0Cognigy Proprietary License2026-07-2239524.1 MB
Intents

Train Intents

Starts a Task to train the Intents of a Flow.

post/v2.0/flows/{flowId}/intents/train

Path parameters

flowIdstring required

The unique identifier for the Flow.

Query parameters

filterstring

Filter records by specific field eg:name.

limitinteger

The maximum number of items to return. Use this parameter to control page size. The default value is 25, and the maximum permitted value is 100.

skipinteger

The number of items to skip before returning the results. Use this parameter with limit for offset-based pagination. The default value is 0.

sortstring

The order in which results are returned. Set a sorting rule in the format field:direction, where direction can be asc for ascending order or desc for descending order. For example, name:asc sorts by name in ascending order.

nextstring

The cursor that points to the next page of results. Use the nextCursor value returned in a previous response to request the next set of items.

previousstring

The cursor that points to the previous page of results. Use the previousCursor value returned in a previous response to request the previous set of items.

Headers

Accept'application/json' | 'application/hal+json' | 'application/xml' | 'text/xml' | 'text/csv'

The Accept header specifies the media type that the client expects in the response. Available options: application/json, application/hal+json, application/xml, text/xml, text/csv. The default value is application/json.

Request body

localeIdstring
mode'full' | 'quick'

Response

The Intents were successfully queued for training.

_idstring
status'queued' | 'active' | 'done' | 'cancelling' | 'cancelled' | 'error'

The status of the task

typestring
parametersobject
lastChangedAtnumber
lastCreatedAtnumber
currentStepinteger
totalStepinteger

Example response

{
  "status": "queued",
  "type": "trainIntents",
  "lastChangedAt": 1594243850,
  "lastCreatedAt": 1594243850,
  "totalStep": 100
}