---
title: "Run an action"
method: POST
path: "/act"
tags: ["Act"]
---

# Run an action

`POST /act`

## Request body

- ActRequestDto
  - `id` string — ID of the action to run.
  - `key` string — Key of the action to run. If the same key exists across multiple integrations, also pass `integrationId`, `integrationKey`, or `connectionId` so we know which one you mean.
  - `api` object — Inline HTTP request spec, sent through the resolved connection's auth layer and base URL. Pair with `connectionId`, `connectionKey`, `integrationId`, or `integrationKey` to pick the connection.
    - `method` 'GET' | 'POST' | 'PATCH' | 'PUT' | 'DELETE', required — HTTP method to use.
    - `path` string — Path appended to the connection's base URL, e.g. `/v2/users/me`. Required.
    - `body` unknown
    - `headers` object — Additional HTTP headers.
    - `query` object — Query-string parameters.
  - `code` string — Inline JavaScript executed in a sandbox. The module must export a function that receives `{ input, membrane, ... }`. Its return value becomes the action output.
  - `integrationId` string — ID of the integration to run the action on. When `key` is provided, looks up the action within this integration. When no connection is specified, runs against this integration's default connection.
  - `integrationKey` string — Key of the integration to run the action on. When `key` is provided, looks up the action within this integration. When no connection is specified, runs against this integration's default connection.
  - `connectionId` string — ID of the connection to run the action against. If a connection-level version of the action exists on this connection, that version is used; otherwise the integration-level or universal action is used.
  - `connectionKey` string — Key of the connection to run the action against. Use when you have a stable key for the connection instead of an ID.
  - `input` unknown
  - `meta` object — Arbitrary metadata stored on the action run log.

## Response `200`

- ActResponseDto
  - `output` object
  - `actionRunId` string

---

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