---
title: "Run a canvas action"
method: POST
path: "/projects/{projectId}/actions/{nodeId}/run"
tags: ["Canvas"]
---

# Run a canvas action

`POST /projects/{projectId}/actions/{nodeId}/run`

Runs an existing canvas action node through the action execution workflow.

## Path parameters

- `projectId` string, required — Project identifier
- `nodeId` string, required — Canvas action node identifier

## Response `201`

Canvas action run started.

- object
  - `run_id` string, required — Run identifier
  - `type` 'generation' | 'technique' | 'action', required — Run type
  - `model` object, nullable
    - `model_id` string, required — Model identifier
  - `technique` object, nullable
    - `technique_id` string, required — Technique identifier
    - `name` string, required — Technique name
  - `action` object, nullable
    - `action_id` 'split-text' | 'find-and-replace-text' | 'concat-text' | 'ken-burns-video' | 'color-grade-image' | 'change-image-ar' | 'rotate-image' | 'flip-image' | 'color-filter-image' | 'color-tint-image' | 'filter-color-image' | 'blur-image' | 'duplicate-image' | 'side-by-side-composite' | 'add-shape-to-image' | 'generate-shape-image' | 'add-text-to-image' | 'generate-text-image' | 'qr-code-generator' | 'stitch-videos' | 'split-video' | 'extract-video-frames' | 'color-grade-video' | 'video-to-frame-grid' | 'boomerang-video' | 'reverse-video' | 'video-to-long-exposure' | 'video-effect' | 'color-filter-video' | 'speed-up-video' | 'slow-down-video' | 'duplicate-video' | 'greenscreen-video' | 'resize-video' | 'change-video-ar' | 'split-audio-from-video' | 'merge-audio-into-video', required — Action identifier
  - `estimated_seconds` integer, nullable, required
  - `charged_cost` number, required — Cost charged in USD
  - `poll_url` string, uri, nullable
  - `project_id` string, nullable — Project identifier

## Other responses

- `400` — 400
- `401` — 401
- `402` — 402
- `403` — 403
- `404` — 404
- `409` — 409
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/florafauna-ai/apis/flora-ai-api.md) · [All operations](https://skmtc.net/florafauna-ai/apis/flora-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/florafauna-ai/flora-ai-api/versions/2f4a714f8ce9/schema)