---
title: "PUT /api/v1/actions/{ref_or_id}"
method: PUT
path: "/api/v1/actions/{ref_or_id}"
---

# PUT /api/v1/actions/{ref_or_id}

`PUT /api/v1/actions/{ref_or_id}`

Update an action.

## Path parameters

- `ref_or_id` string, required

## Request body

- ActionUpdateRequest
  - `id` string — The unique identifier for the action.
  - `ref` string — System computed user friendly reference for the action. Provided value will be overridden by computed value.
  - `uid` string
  - `name` string, required — The name of the action.
  - `description` string — The description of the action.
  - `enabled` boolean — Enable or disable the action from invocation.
  - `runner_type` string, required — The type of runner that executes the action.
  - `entry_point` string — The entry point for the action.
  - `pack` string — The content pack this action belongs to.
  - `parameters` ActionParametersSubSchema — Input parameters for the action.
  - `tags` object[] — User associated metadata assigned to this object.
  - `notify` object — Notification settings for action.
    - `on-complete` NotificationPropertySubSchema
      - `message` string — Message to use for notification
      - `data` object — Data to be sent as part of notification
      - `routes` string[] — Channels to post notifications to.
      - `channels` string[] — Channels to post notifications to.
    - `on-failure` NotificationPropertySubSchema
      - `message` string — Message to use for notification
      - `data` object — Data to be sent as part of notification
      - `routes` string[] — Channels to post notifications to.
      - `channels` string[] — Channels to post notifications to.
    - `on-success` NotificationPropertySubSchema
      - `message` string — Message to use for notification
      - `data` object — Data to be sent as part of notification
      - `routes` string[] — Channels to post notifications to.
      - `channels` string[] — Channels to post notifications to.
  - `data_files` object[] — Optional action script and data files which are written to the filesystem.
    - `file_path` string, required — Path to the file relative to the pack actions directory (e.g. my_action.py).
    - `content` string, required — Raw file content.

## Response `200`

Action updated

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.dev/stackstorm/apis/stackstorm-api.md) · [All operations](https://skmtc.dev/stackstorm/apis/stackstorm-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stackstorm/stackstorm-api/revisions/85e49f390588/schema)