Skip to content

PromptInput

An input a run is started with, filled into the interaction’s prompt wherever it says %%name%%.

Kind: an object, used in requests and responses. In a request it is called PromptInputInput.

FieldTypeRequiredDescription
dataTypeInteractionInputTypeThe type of value the input takes.
namestringyesThe input’s name: a run gives the input’s value under this name. Constraints: required (empty or whitespace-only strings are rejected).
descriptionstring | nullWhat the input is for, shown to whoever starts a run. Constraints: minLength: 1.
isRequiredbooleanWhether a run must give the input. A run started without a required input is refused.
{
"dataType": "String",
"name": "...",
"description": "...",
"isRequired": false
}

Every field is present in a response; empty ones are null.

FieldTypeDescription
dataTypeInteractionInputTypeThe type of value the input takes.
namestringThe input’s name: a run gives the input’s value under this name. Constraints: required (empty or whitespace-only strings are rejected).
descriptionstring | nullWhat the input is for, shown to whoever starts a run. Constraints: minLength: 1.
isRequiredbooleanWhether a run must give the input. A run started without a required input is refused.
{
"dataType": "String",
"name": "...",
"description": "...",
"isRequired": false
}