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

# POST /api/v1/executions

`POST /api/v1/executions`

Create a new execution.

## Query parameters

- `show_secrets` boolean

## Headers

- `st2-context` string

## Request body

- ExecutionRequest — An execution of an action.
  - `id` string — The unique identifier for the action execution.
  - `status` 'requested' | 'scheduled' | 'delayed' | 'running' | 'succeeded' | 'failed' | 'timeout' | 'abandoned' | 'canceling' | 'canceled' | 'pending' | 'pausing' | 'paused' | 'resuming' — The current status of the action execution.
  - `start_timestamp` string — The start time when the action is executed.
  - `end_timestamp` string — The timestamp when the action has finished.
  - `action` string, required — Reference to the action to be executed.
  - `action_is_workflow` boolean — Flag indicating workflow action.
  - `parameters` object — Input parameters for the action.
  - `result` object
  - `context` object
  - `callback` object
  - `runner_info` object
  - `notify` object — Notification settings for liveaction.
    - `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.
  - `delay` integer — How long (in milliseconds) to delay the execution before scheduling.
  - `user` string, nullable — User context under which action should run (admins only)

## Response `201`

Execution 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)