Parameters
The Parameter API handles global parameters that either affects the current environment, or Bots individually. Bot parameters overrides environment parameters locally.
Environment Parameters
Represents the id of organization
Represents the id of environment
DTO to request create or update parameter/configuration with key, value, description and enabled
Parameter's key
Parameter's value
Parameter's description
Flag that indicates if the parameter is enabled
POST /org/{orgUUID}/env/{envUUID}/parameters HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 65
{
"key": "text",
"value": "text",
"description": "text",
"enabled": true
}{
"data": {
"uuid": "text",
"enabled": true,
"description": "text",
"key": "text",
"value": "text"
},
"message": "text"
}It is the id that represents an organization
It is the id that represents an environment
Parameter key to search only for this
It is an identifier provided by the API client that will be used to identify distributed logs.
GET /org/{orgUUID}/env/{envUUID}/v2/parameters HTTP/1.1
Host:
Accept: */*
{
"parameters": {
"cockpitVersion": "text",
"confidenceMin": 1,
"timeouts": {
"genai": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"al": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"rephrasing": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"zeroShot": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"multilanguage": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
}
},
"maxTokens": {
"zeroShot": {
"min": 1,
"value": 1,
"max": 1
}
}
},
"extensions": {
"improveAnswers": true,
"generateExamples": true,
"genaiCell": true,
"rephrase": true,
"multilanguage": {
"enabled": true,
"properties": {
"ANY_ADDITIONAL_PROPERTY": {}
}
},
"kai": {
"enabled": true,
"properties": {
"ANY_ADDITIONAL_PROPERTY": {}
}
}
},
"list": [
{
"uuid": "text",
"key": "text",
"value": "text",
"description": "text",
"enabled": true
}
],
"parameter": {
"uuid": "text",
"key": "text",
"value": "text",
"description": "text",
"enabled": true
}
}Represents the id of organization
Represents the id of environment
It is the parameter's name to find
GET /org/{orgUUID}/env/{envUUID}/parameters HTTP/1.1
Host:
Accept: */*
{
"data": [
{
"id": "text",
"enabled": true,
"description": "text",
"key": "text",
"value": "text",
"extension": true
}
],
"extensions": {
"timeouts": {
"genai": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"al": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"rephrasing": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"zeroShot": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"multilanguage": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
}
}
},
"message": "text"
}Represents the id of organization
Represents the id of environment
Represents the id of configuration
DTO to request create or update parameter/configuration with key, value, description and enabled
Parameter's key
Parameter's value
Parameter's description
Flag that indicates if the parameter is enabled
PUT /org/{orgUUID}/env/{envUUID}/parameters/{parameterId} HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 65
{
"key": "text",
"value": "text",
"description": "text",
"enabled": true
}{
"data": {
"uuid": "text",
"enabled": true,
"description": "text",
"key": "text",
"value": "text"
},
"message": "text"
}Represents the id of organization
Represents the id of environment
Represents the id of configuration
DELETE /org/{orgUUID}/env/{envUUID}/parameters/{parameterId} HTTP/1.1
Host:
Accept: */*
No content
Represents the id of organization
Represents the id of environment
GET /org/{orgUUID}/env/{envUUID}/parameters/version HTTP/1.1
Host:
Accept: */*
{
"data": {
"value": "text"
},
"message": "text"
}Return if the environment has the license to use automated learning. Deprecated method which will me removed past 4.5.0
Represents the id of organization
Represents the id of environment
GET /org/{orgUUID}/env/{envUUID}/parameters/automated-learning HTTP/1.1
Host:
Accept: */*
{
"hasLicense": true
}Bot Parameters
Represents the id of organization
Represents the id of environment
Represents the id of bot
DTO to request create or update parameter/configuration with key, value, description and enabled
Parameter's key
Parameter's value
Parameter's description
Flag that indicates if the parameter is enabled
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/parameters HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 65
{
"key": "text",
"value": "text",
"description": "text",
"enabled": true
}{
"data": {
"uuid": "text",
"enabled": true,
"description": "text",
"key": "text",
"value": "text"
},
"message": "text"
}A valid organization uuid
A valid environment uuid
A valid bot uuid
It is an identifier provided by the API client that will be used to identify distributed logs.
DTO with type and value to the slides.
The slide type, it can be CONFIDENCE_MIN, GENAI, AL OR REPHRASING.
The slide value.
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/parameters/update-reserved HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 25
{
"type": "text",
"value": 1
}No content
It is the id that represents an organization
It is the id that represents an environment
It is the id that represents a bot.
Parameter key to search only for this
It is an identifier provided by the API client that will be used to identify distributed logs.
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/v2/parameters HTTP/1.1
Host:
Accept: */*
{
"parameters": {
"cockpitVersion": "text",
"confidenceMin": 1,
"timeouts": {
"genai": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"al": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"rephrasing": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"zeroShot": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"multilanguage": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
}
},
"maxTokens": {
"zeroShot": {
"min": 1,
"value": 1,
"max": 1
}
}
},
"extensions": {
"improveAnswers": true,
"generateExamples": true,
"genaiCell": true,
"rephrase": true,
"multilanguage": {
"enabled": true,
"properties": {
"ANY_ADDITIONAL_PROPERTY": {}
}
},
"kai": {
"enabled": true,
"properties": {
"ANY_ADDITIONAL_PROPERTY": {}
}
}
},
"list": [
{
"uuid": "text",
"key": "text",
"value": "text",
"description": "text",
"enabled": true
}
],
"parameter": {
"uuid": "text",
"key": "text",
"value": "text",
"description": "text",
"enabled": true
}
}Represents the id of organization
Represents the id of environment
Represents the id of bot
It is the parameter's name to find
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/parameters HTTP/1.1
Host:
Accept: */*
{
"data": [
{
"id": "text",
"enabled": true,
"description": "text",
"key": "text",
"value": "text",
"extension": true
}
],
"extensions": {
"timeouts": {
"genai": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"al": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"rephrasing": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"zeroShot": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
},
"multilanguage": {
"min": 1,
"recommendation": 1,
"value": 1,
"max": 1
}
}
},
"message": "text"
}Represents the id of organization
Represents the id of environment
Represents the id of bot
Represents the id of configuration
DTO to request create or update parameter/configuration with key, value, description and enabled
Parameter's key
Parameter's value
Parameter's description
Flag that indicates if the parameter is enabled
PUT /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/parameters/{parameterId} HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 65
{
"key": "text",
"value": "text",
"description": "text",
"enabled": true
}{
"data": {
"uuid": "text",
"enabled": true,
"description": "text",
"key": "text",
"value": "text"
},
"message": "text"
}Represents the id of organization
Represents the id of environment
Represents the id of bot
Represents the id of configuration
DELETE /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/parameters/{parameterId} HTTP/1.1
Host:
Accept: */*
No content
Environment Extensions
Represents the id of organization
Represents the id of environment
GET /org/{orgUUID}/env/{envUUID}/extensions/genai-enabled HTTP/1.1
Host:
Accept: */*
{
"hasLicense": true
}Bot Extensions
A valid organization uuid
A valid environment uuid
A valid bot uuid
It is the key extension to toggle. Possible values are: al.enabled, genai.cell.enabled, utterance.completetions.enabled, genai.enhancements.enabled and genai.rephrasing.enabled
It is an identifier provided by the API client that will be used to identify distributed logs.
DTO to enable or disable an extension in a bot.
Parameter's value
POST /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/extensions/update-status/{extension} HTTP/1.1
Host:
Content-Type: application/json
Accept: */*
Content-Length: 86
{
"value": true,
"properties": {
"ANY_ADDITIONAL_PROPERTY": {}
},
"configurationValue": "text"
}No content
It is the id that represents an organization
It is the id that represents an environment
It is the id that represents a bot.
GET /org/{orgUUID}/env/{envUUID}/bot/{botUUID}/extensions HTTP/1.1
Host:
Accept: */*
{
"improveAnswers": true,
"generateExamples": true,
"genaiCell": true,
"rephrase": true,
"multilanguage": {
"enabled": true,
"properties": {
"ANY_ADDITIONAL_PROPERTY": {}
}
},
"kai": {
"enabled": true,
"properties": {
"ANY_ADDITIONAL_PROPERTY": {}
}
}
}Last updated
Was this helpful?