---
title: "Update assistant action"
method: PATCH
path: "/orgs/assistants/{assistant_id}/actions/{action_id}"
tags: ["Assistants"]
---

# Update assistant action

`PATCH /orgs/assistants/{assistant_id}/actions/{action_id}`

## Request

- Base URL: `https://api.useinvent.com`
- URL: `https://api.useinvent.com/orgs/assistants/{assistant_id}/actions/{action_id}`
- Auth: HTTP bearer

Update an existing assistant action.

## Path parameters

- `assistant_id` string, required
- `action_id` string, required

## Request body

- UpdateAssistantActionSchema: Schema for updating an existing assistant action
  - `enabled` boolean: Whether the action is available to the assistant.
  - `name` string, nullable: The name of the action, e.g. "Send email"
  - `instructions` string, nullable: Extra instructions for the action
  - `connection_id` string, nullable: The ID of the connection to use for the action if required, e.g. "con_XXX"
  - `config` InputValuesWithDefinitionsSchema: The input values with their dynamic field definitions
    - `input` object, required: Values of the fields
    - `definitions` DynamicFieldsSchema[]
      - `path` string, required
      - `definition` FieldsSchema, required: The definition of the field schemas
  - `approval_mode` 'auto' | 'ask' | 'never': When the assistant must ask for approval in the chat before running the action. Always use "never" (run without asking).

## Response `200`

The updated assistant action.

- AssistantActionSchema: Schema for an assistant action
  - `id` string, required: The ID of the action
  - `enabled` boolean, required: Whether the action is enabled
  - `name` string, nullable, required: The name of the action
  - `instructions` string, nullable, required: The instructions for the action
  - `action_id` string, required: The ID of the action, e.g. "TOOLS:HTTP_REQUEST"
  - `assistant_id` string, required: The ID of the assistant
  - `connection_id` string, nullable, required: The ID of the connection to use for the action if required
  - `config` InputValuesWithDefinitionsSchema, required: The input values with their dynamic field definitions
    - `input` object, required: Values of the fields
    - `definitions` DynamicFieldsSchema[]
      - `path` string, required
      - `definition` FieldsSchema, required: The definition of the field schemas
  - `approval_mode` 'auto' | 'ask' | 'never', required: When the assistant must ask before running the action
  - `position` integer, required: The position of the action within its group. Bucketed in multiples of 100, e.g. 100, 101, 102 for the first group, 200, 201, 202 for the second
  - `created_at` string, date-time, nullable, required
  - `updated_at` string, date-time, nullable, required

---

[API](https://skmtc.dev/useinvent/apis/invent-api.md) · [All operations](https://skmtc.dev/useinvent/apis/invent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/useinvent/apis/invent-api/revisions/98824f3fde82?raw)