---
title: "Run action"
method: POST
path: "/v1/connect/{project_id}/actions/run"
---

# Run action

`POST /v1/connect/{project_id}/actions/run`

Execute an action with the provided configuration and return results

## Headers

- `x-pd-environment` 'development' | 'production', required — The environment in which the server client is running

## Request body

- RunActionOpts — Request options for running an action
  - `id` string, required — The action component ID
  - `version` string, nullable — Action component semantic version
  - `external_user_id` string, required — The external user ID
  - `configured_props` ConfiguredProps — The configured properties of the component
  - `dynamic_props_id` string — The ID for dynamic props
  - `stash_id` union — The ID of the File Stash to use for syncing the action's /tmp directory, or either `true` or 'NEW' to create a new stash
    - string, nullable — The ID of the File Stash
    - 'NEW'
    - boolean

## Response `200`

action ran

- RunActionResponse — The response received after running an action. See https://pipedream.com/docs/components/api#returning-data-from-steps for more details.
  - `exports` object — The key-value pairs resulting from calls to `$.export`
  - `os` Observation[] — Any logs produced during the execution of the action
    - `err` ObservationError — Details about an observed error message
      - `name` string — The name of the error/exception
      - `message` string — The error message
      - `stack` string — The stack trace of the error
    - `k` string, required — The source of the log (e.g. `console.log`)
    - `msg` string — The log message
    - `ts` number, required — The time at which the log was produced, as milliseconds since the epoch
  - `ret` unknown
  - `stash_id` string, nullable — The ID of the File Stash

## Other responses

- `202` — Async operation started
- `429` — too many requests

---

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