ConnectorBindingInput

A run input whose value is written straight into a tool’s calls, such as a customer id, so the model never sees or chooses it.

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

In a request

Field	Type	Required	Description
externalOperationId	uuid		The id of the tool whose calls get the value.
agentId	uuid | null		Only the participant filled by this agent gets the value. Null: every participant does.
target	string		Where the value goes: the name of the request body field (a nested field’s names separated by /), or of the path or query parameter, as type says.
defaultValue	string | null		The value used when a run does not give one. Null: none.
type	ConnectorBindingInputType		What target names: a request body field, a query parameter or a path parameter.
name	string	yes	The input’s name: a run gives the input’s value under this name. Constraints: required (empty or whitespace-only strings are rejected).
description	string | null		What the input is for, shown to whoever starts a run. Constraints: minLength: 1.
isRequired	boolean		Whether a run must give the input. A run started without a required input is refused.

{
  "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "agentId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "target": "...",
  "defaultValue": "...",
  "type": "Request",
  "name": "...",
  "description": "...",
  "isRequired": false
}

In a response

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

Field	Type	Description
externalOperationId	uuid	The id of the tool whose calls get the value.
agentId	uuid | null	Only the participant filled by this agent gets the value. Null: every participant does.
target	string	Where the value goes: the name of the request body field (a nested field’s names separated by /), or of the path or query parameter, as type says.
defaultValue	string | null	The value used when a run does not give one. Null: none.
type	ConnectorBindingInputType	What target names: a request body field, a query parameter or a path parameter.
name	string	The input’s name: a run gives the input’s value under this name. Constraints: required (empty or whitespace-only strings are rejected).
description	string | null	What the input is for, shown to whoever starts a run. Constraints: minLength: 1.
isRequired	boolean	Whether a run must give the input. A run started without a required input is refused.

{
  "externalOperationId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "agentId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "target": "...",
  "defaultValue": "...",
  "type": "Request",
  "name": "...",
  "description": "...",
  "isRequired": false
}

Where it’s used

• Inside CodePipelineCreateRequest
• Inside CodePipelineUpdateRequest
• Inside CodePipelineVersion
• Inside ManagedInteractionCreateRequest
• Inside ManagedInteractionUpdateRequest
• Inside ManagedInteractionVersion
• Inside OneShotInteractionCreateRequest
• Inside OneShotInteractionUpdateRequest
• Inside OneShotInteractionVersion
• Inside RoundRobinInteractionCreateRequest
• Inside RoundRobinInteractionUpdateRequest
• Inside RoundRobinInteractionVersion