Actions42
- Agent Actions
- Channel Actions
- Chat Actions
- Intention Actions
- Interaction Actions
- Training Actions
- Workspace Actions
Intention → Update
AI-generatedSummary
Update an intention via PUT /v2/intention/{intentionId}
Inputs
- intentionId (required) — Intention ID (used by update/delete endpoints)
- updateFieldsUi — Fields to update on the intention. Each field supports Name, JSON Name, Description, Required flag, and Type (ARRAY, BOOLEAN, DATE, DATE_TIME, MONEY, NUMBER, OBJECT, STRING). Only fields you add are sent to the API.
- updateHeadersUi — Request headers. Each header has a Name and Value. Added to the request via the headers name-value array.
- updateParamsUi — Query parameters. Each param has a Name and Value. Added to the request query string.
- updateVariablesUi — Variables to set for the intention. Each variable has a Value Expression, Default Field Key, and optional Custom Field (with its own Field description, ID, JSON Name, Name, and Type).
- updateRequestBodyUi — Key-value pairs that will be stringified as requestBody. Leave empty to not change the request body.
Output shape
The API response body from the GPTMaker intention update endpoint.
The intention type must be WEBHOOK; specifying a different type causes an error. At least one of updateFieldsUi, updateHeadersUi, updateParamsUi, updateVariablesUi, or updateRequestBodyUi must provide data beyond the intention ID, otherwise the operation fails. HTTP method: PUT. Endpoint: /v2/intention/{intentionId}.