---
title: "Invoke Action Binding"
method: POST
path: "/api/v1/apps/{app_id}/action-bindings/{alias}/invoke"
tags: ["apps"]
---

# Invoke Action Binding

`POST /api/v1/apps/{app_id}/action-bindings/{alias}/invoke`

## Request

- Base URL: `https://api.netter.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.netter.ai/api/v1/apps/{app_id}/action-bindings/{alias}/invoke`
- Auth: none declared

## Path parameters

- `app_id` string, uuid, required
- `alias` string, required

## Query parameters

- `embed_host_app_id` string, uuid, nullable

## Request body

- AppActionInvokeRequest
  - `app_version_id` string, uuid, required
  - `preview_branch_id` string, uuid, nullable
  - `params` object
  - `idempotency_key` string, required
  - `expected_versions` object

## Response `200`

Successful Response

- ActionExecutionRead
  - `batch_id` string, uuid, nullable
  - `details_redacted` boolean
  - `created_at` string, date-time, nullable
  - `actor_id` string, uuid, nullable
  - `source` string, nullable
  - `source_id` string, uuid, nullable
  - `revision_number` integer, nullable
  - `invocation_id` string, uuid, required
  - `action_id` string, uuid, required
  - `revision_id` string, uuid, required
  - `status` 'accepted' | 'committed' | 'denied' | 'failed', required
  - `result` object
  - `follow_ups` ActionFollowUpRead[]
    - `id` string, uuid, required
    - `effect_id` string, required
    - `run_id` string, uuid, nullable
    - `status` 'pending' | 'running' | 'succeeded' | 'failed' | 'blocked' | 'needs_attention', required
    - `attempt` integer
    - `error` string, nullable
    - `can_retry` boolean
  - `error` object, nullable

## Other responses

- `422`: Validation Error

## Changes

> 60 revisions in range; 1 not diffed.

- **2026-10-15** `97698540d22b`: 1 info
  - added the optional property `batch_id` to the response with the `200` status
- **2026-10-02** `11cfdb04b2ca`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/netter/apis/dmi-backend/changes/api/v1/apps/:app_id/action-bindings/:alias/invoke/post.md)

---

[API](https://skmtc.dev/netter/apis/dmi-backend.md) - [All operations](https://skmtc.dev/netter/apis/dmi-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/netter/apis/dmi-backend/revisions/29c68bd8ba7b?raw)