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

# POST /api/v1/aliasexecution

`POST /api/v1/aliasexecution`

Create alias execution.

## Query parameters

- `show_secrets` boolean

## Request body

- AliasExecution
  - `actionalias` object — Alias for an action
    - `id` string — Unique identifier for the action alias.
    - `ref` string — System computed user friendly reference for the alias. Provided value will be overridden by computed value.
    - `uid` string
    - `name` string — Name of the action alias.
    - `pack` string — The content pack this actionalias belongs to.
    - `description` string — Description of the executed alias.
    - `enabled` boolean — Flag indicating if action alias is enabled.
    - `action_ref` string — Reference to the aliased action
    - `formats` unknown[] — Possible parameter format.
      - unknown
    - `ack` object — Acknowledgement message format.
      - `enabled` boolean
      - `format` string
      - `extra` object
      - `append_url` boolean
    - `result` object — Execution message format.
      - `enabled` boolean
      - `format` string
      - `extra` object
    - `extra` object — Extra parameters, usually adapter-specific
    - `delay` integer — How long (in milliseconds) to delay the execution before scheduling.
  - `execution` Execution — Record of the execution of an action.
    - `id` string, required
    - `trigger` Trigger
    - `trigger_type` TriggerType
    - `trigger_instance` TriggerInstance
    - `rule` Rule
    - `action` object
    - `runner` object
    - `liveaction` LiveAction — 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.
    - `liveaction_id` string
    - `task_execution` string
    - `workflow_execution` string
    - `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.
    - `elapsed_seconds` number — Time duration in seconds taken for completion of this execution.
    - `web_url` string — History URL for this execution if you want to view in UI.
    - `parameters` object — Input parameters for the action.
    - `context` object
    - `result` object
    - `result_size` integer
    - `parent` string
    - `children` string[]
    - `log` object[] — Contains information about execution state transitions.
      - `timestamp` string
      - `status` 'requested' | 'scheduled' | 'delayed' | 'running' | 'succeeded' | 'failed' | 'timeout' | 'abandoned' | 'canceling' | 'canceled' | 'pending' | 'pausing' | 'paused' | 'resuming'
    - `delay` integer — How long (in milliseconds) to delay the execution before scheduling.
  - `message` string

## Response `201`

Action alias 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)