Update an NLUConnector - Cognigy Documentation

PATCH

v2.0

nluconnectors

{nluConnectorId}

Update an NLUConnector

curl --request PATCH \
  --url 'https://api-trial.cognigy.ai/new/v2.0/nluconnectors/{nluConnectorId}?api_key=' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "New NLUConnector",
  "type": "cognigy",
  "settings": {
    "invocationName": "<string>",
    "reparseAlexaSlots": true,
    "skill": {
      "lastUpdated": "<string>",
      "nameByLocale": {
        "en-US": "<string>",
        "de-DE": "<string>",
        "ja-JP": "<string>",
        "en-GB": "<string>",
        "en-IN": "<string>"
      },
      "skillId": "<string>",
      "stage": "<string>"
    }
  },
  "transformer": {
    "abortOnError": false,
    "transformerStackEnabled": false,
    "transformer": "<string>",
    "preNluTransformerEnabled": false,
    "postNluTransformerEnabled": false,
    "nluCodeTransformerEnabled": false
  }
}
'

{
  "type": "Bad Request",
  "title": "Bad Request Error",
  "status": 400,
  "detail": "Validation failed. Missing payload.",
  "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432",
  "code": 1000,
  "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f",
  "details": {}
}

Authorizations

X-API-Key

string

header

required

Supply the API Key in the HTTP-Header

api_key

string

query

required

Supply the API Key in the Url-Query

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Headers

enum<string>

The default media type is application/hal+json. Use application/json for pure data results.

Available options:

application/json,

application/hal+json,

application/xml,

text/xml,

text/csv

Path Parameters

nluConnectorId

string

required

The Id of the NLUConnector

Required string length: 24

Body

application/json

name

string

The name of the NLUConnector

Example:

"New NLUConnector"

type

enum<string>

The NLUConnector type

Available options:

alexa,

dialogflow,

dialogflowBuiltIn,

amazonLexBuiltIn,

luis,

watson,

noNlu,

cognigy,

code,

generativeAI,

lex

Example:

"cognigy"

settings

object

Settings used by the Alexa NLUConnector

Option 1
Option 2
Option 3
Option 4
Option 5

Show child attributes

settings.invocationName

string

The invocation name of the Alexa skill. Necessary to start Alexa simulations.

settings.reparseAlexaSlots

boolean

Whether to reparse slots from Alexa with our own keyphrase mapper. Used by Alexa.

settings.skill

object

Show child attributes

settings.skill.lastUpdated

string

When the skill was last updated

settings.skill.nameByLocale

object

Gives the name of the skill for different locales

Show child attributes

settings.skill.nameByLocale.en-US

string

settings.skill.nameByLocale.de-DE

string

settings.skill.nameByLocale.ja-JP

string

settings.skill.nameByLocale.en-GB

string

settings.skill.nameByLocale.en-IN

string

settings.skill.skillId

string

The unique id of the skill

settings.skill.stage

string

The current stage of the skills life cycle (e.g. is it in development, production..)

transformer

object

Show child attributes

transformer.abortOnError

string

If true, then we will abort the message processing if the transformer throws an error. Otherwise, we will continue with normal message processing in the event of an error.

Example:

false

transformer.transformerStackEnabled

string

If true, then we will write the transformer stack in the input object, when the channel is adminconsole.

Example:

false

transformer.transformer

string

The transformer object as written by the user. This will be displayed in the UI since it includes typings.

transformer.preNluTransformerEnabled

string

Example:

false

transformer.postNluTransformerEnabled

string

Example:

false

transformer.nluCodeTransformerEnabled

string

Example:

false

Response

Successfully updated NLUConnector

Resolves the options for a field.Resolves the options for a field.

⌘I

Update an NLUConnector

curl --request PATCH \
  --url 'https://api-trial.cognigy.ai/new/v2.0/nluconnectors/{nluConnectorId}?api_key=' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "name": "New NLUConnector",
  "type": "cognigy",
  "settings": {
    "invocationName": "<string>",
    "reparseAlexaSlots": true,
    "skill": {
      "lastUpdated": "<string>",
      "nameByLocale": {
        "en-US": "<string>",
        "de-DE": "<string>",
        "ja-JP": "<string>",
        "en-GB": "<string>",
        "en-IN": "<string>"
      },
      "skillId": "<string>",
      "stage": "<string>"
    }
  },
  "transformer": {
    "abortOnError": false,
    "transformerStackEnabled": false,
    "transformer": "<string>",
    "preNluTransformerEnabled": false,
    "postNluTransformerEnabled": false,
    "nluCodeTransformerEnabled": false
  }
}
'

{
  "type": "Bad Request",
  "title": "Bad Request Error",
  "status": 400,
  "detail": "Validation failed. Missing payload.",
  "instance": "/v2.0/flows/5ce7c2d833ea1e04d7e6c432",
  "code": 1000,
  "traceId": "api--f84324f4-98eb-4f02-abdd-375a2e6c3c1f",
  "details": {}
}

Overview

API

Authorizations

Headers

Path Parameters

Body

Response