Skip to main content

AgentUpdateInput

Input data for updating an existing agent.

All fields are optional, allowing selective modification of agent configuration, webhook settings, and behavioral properties.

input AgentUpdateInput {
  names: [LocalizedStringInput!]
  descriptions: [LocalizedStringInput!]
  welcomeMessages: [LocalizedStringInput!]
  buttonLabels: [LocalizedStringInput!]
  active: Boolean
  types: [String!]
  trigger: AgentTrigger
  interactionMode: AgentInteractionMode
  webhookUrl: String
  webhookTimeoutMs: Int = 30000
  webhookSignatureSalt: String
  webhookBasicAuthUsername: String
  webhookBasicAuthPassword: String
}

Fields​

AgentUpdateInput.names ● [LocalizedStringInput!] list input​

Localized display names for the agent.

Validation: Array must not be empty, must contain unique language entries.

AgentUpdateInput.descriptions ● [LocalizedStringInput!] list input​

Localized descriptions for the agent.

Validation: Array must not be empty, must contain unique language entries.

AgentUpdateInput.welcomeMessages ● [LocalizedStringInput!] list input​

Localized welcome messages displayed when the agent is activated.

Validation: Array must not be empty, must contain unique language entries.

AgentUpdateInput.buttonLabels ● [LocalizedStringInput!] list input​

Localized button labels for the agent.

Validation: Array must not be empty, must contain unique language entries.

AgentUpdateInput.active ● Boolean scalar​

Whether the agent should be active upon creation.

AgentUpdateInput.types ● [String!] list scalar​

Classification types for the agent.

Validation: Must be in SCREAMING_SNAKE_CASE format (e.g., ORDER_SUPPORT, PRODUCT_INFO).

AgentUpdateInput.trigger ● AgentTrigger enum​

Trigger mechanism that activates the agent interaction.

AgentUpdateInput.interactionMode ● AgentInteractionMode enum​

Interaction mode defining the conversational pattern.

AgentUpdateInput.webhookUrl ● String scalar​

URL of the external webhook that processes agent requests. Maximum length of 2048 characters.

AgentUpdateInput.webhookTimeoutMs ● Int scalar​

Timeout in milliseconds for webhook requests.

AgentUpdateInput.webhookSignatureSalt ● String scalar​

The salt used to generate HMAC-SHA256 signature for webhook authentication.

When configured, the webhook will include an 'X-Propeller-Signature' header with format 'sha256=<hex_signature>'.

To verify the signature:

  1. JSON stringify the payload
  2. Generate HMAC-SHA256 using this salt and the stringified payload
  3. Compare with the received signature using crypto.timingSafeEqual() to prevent timing attacks

Example (Node.js): const expectedSig = crypto.createHmac('sha256', salt).update(JSON.stringify(payload), 'utf8').digest('hex'); const receivedSig = signature.replace('sha256=', ''); return crypto.timingSafeEqual(Buffer.from(expectedSig, 'hex'), Buffer.from(receivedSig, 'hex'));

AgentUpdateInput.webhookBasicAuthUsername ● String scalar​

Username for HTTP Basic Authentication.

Used together with basicAuthPassword to provide authentication credentials for webhook requests. Both username and password must be provided or both omitted.

AgentUpdateInput.webhookBasicAuthPassword ● String scalar​

Password for HTTP Basic Authentication.

Used together with basicAuthUsername to provide authentication credentials for webhook requests. Both username and password must be provided or both omitted.

Member Of​

agentUpdate mutation