---
title: "POST /api/ee/action-v2/execute"
method: POST
path: "/api/ee/action-v2/execute"
tags: ["/api/ee/action-v2"]
---

# POST /api/ee/action-v2/execute

`POST /api/ee/action-v2/execute`

Execute an action with a single input.

   Takes:
   - `action`            - an identifier or an expression for what we want to execute.
   - `scope`             - where the action is being invoked from.
   - `input`             - a single map. currently these are typically a database table row pk, or query result.
   - `params` (optional) - a map of values for the parameters taken by the action's mapping.

   The `input` and `params` are used by the relevant mapping to calculate a map argument to the underlying action fn.
   If there is no mapping, `params` are simply used as overrides for `input`.

   Returns the outputs from the performed action.

## Request body

- object
  - `action` union, required — All the various ways of referring to an action with the v2 APIs.
    - union — Primitive actions, saved actions, and packed encodings from the picker.
      - integer — value must be an integer greater than zero.
      - string
    - MetabaseEnterpriseActionV2ApiApiActionExpression — A more relaxed version of ::action-expression that can still have opaque identifiers inside inside.
  - `input` object
  - `params` object
  - `scope` union, required
    - object
      - `dashboard-id` integer, required — value must be an integer greater than zero.
    - object
      - `dashcard-id` integer, required — value must be an integer greater than zero.
    - object
      - `card-id` integer, required — value must be an integer greater than zero.
    - object
      - `model-id` integer, required — value must be an integer greater than zero.
    - object
      - `table-id` integer, required — value must be an integer greater than zero.
    - object
      - `webhook-id` integer, required — value must be an integer greater than zero.
    - object
      - `unknown` 'model-action', required

## Response `2XX`

Successful response

## Other responses

- `4XX` — Client error response
- `5XX` — Server error response

---

[API](https://skmtc.net/metabase/apis/metabase-api.md) · [All operations](https://skmtc.net/metabase/apis/metabase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metabase/metabase-api/versions/08b5a2bafb4f/schema)