---
title: "POST /api/v1/actions"
method: POST
path: "/api/v1/actions"
---

# POST /api/v1/actions

`POST /api/v1/actions`

Create a new action.

## Request body

- ActionCreateRequest
  - `pack` string — The content pack this action belongs to.
  - `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.
  - `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 `201`

Single action being created

## Other responses

- `default` — Unexpected error

---

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