---
title: "Execute node"
method: POST
path: "/orchestration/nodes/execute"
tags: ["Orchestration - Nodes"]
---

# Execute node

`POST /orchestration/nodes/execute`

Execute a node

## Request body

- object — Request body schema.
  - `workflowUuid` string, uuid, required — Workflow identifier.
  - `releaseUuid` string, uuid, required — Release identifier.
  - `node` union, required
    - object — Node configuration.
      - `uuid` string, uuid, required
      - `slug` string, required
      - `name` string
      - `config` object, required
      - `description` string
      - `retry` object
        - `maximumAttempts` number
        - `initialInterval` number
        - `backoffCoefficient` number
      - `childrenUuids` string[], required
      - `fallbackChildUuid` string
      - `fallbackOnFailure` boolean, required
      - `position` object, required
        - `x` number, required
        - `y` number, required
      - `kind` 'native', required
      - `actionSlug` string, required
    - object — Node configuration.
      - `uuid` string, uuid, required
      - `slug` string, required
      - `name` string
      - `config` object, required
      - `description` string
      - `retry` object
        - `maximumAttempts` number
        - `initialInterval` number
        - `backoffCoefficient` number
      - `childrenUuids` string[], required
      - `fallbackChildUuid` string
      - `fallbackOnFailure` boolean, required
      - `position` object, required
        - `x` number, required
        - `y` number, required
      - `kind` 'connector', required
      - `connectorUuid` string
      - `integrationSlug` string, required
      - `actionSlug` string, required
    - object — Node configuration.
      - `uuid` string, uuid, required
      - `slug` string, required
      - `name` string
      - `config` object, required
      - `description` string
      - `retry` object
        - `maximumAttempts` number
        - `initialInterval` number
        - `backoffCoefficient` number
      - `childrenUuids` string[], required
      - `fallbackChildUuid` string
      - `fallbackOnFailure` boolean, required
      - `position` object, required
        - `x` number, required
        - `y` number, required
      - `kind` 'tool', required
      - `toolUuid` string
      - `templateSlug` string
      - `releaseUuid` string
      - `waitUntilFinished` boolean
    - object — Node configuration.
      - `uuid` string, uuid, required
      - `slug` string, required
      - `name` string
      - `config` object, required
      - `description` string
      - `retry` object
        - `maximumAttempts` number
        - `initialInterval` number
        - `backoffCoefficient` number
      - `childrenUuids` string[], required
      - `fallbackChildUuid` string
      - `fallbackOnFailure` boolean, required
      - `position` object, required
        - `x` number, required
        - `y` number, required
      - `kind` 'agent', required
      - `agentUuid` string
      - `templateSlug` string
      - `releaseUuid` string
      - `waitUntilFinished` boolean
  - `computedConfig` object, required — Computed node configuration.
  - `context` object, required — Execution context for the node.
  - `groupContext` object — Group context for the node.

## Response `200`

Successful response

- object
  - `status` 'pending', required — Execution status.
  - `message` string, required — Status message.
  - `runUuid` string, uuid — Identifier of the launched run, when available, so the client can poll for its result.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal server error

---

[API](https://skmtc.net/getcargo/apis/cargo-api.md) · [All operations](https://skmtc.net/getcargo/apis/cargo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getcargo/cargo-api/revisions/1d5a19e01d83/schema)