---
title: "Execute a node app"
method: POST
path: "/node-apps/{id}/execute"
tags: ["Node Apps"]
---

# Execute a node app

`POST /node-apps/{id}/execute`

Execute a node app by version ID. The request body should contain the input data as a JSON object matching the node app's input schema. Returns a job that can be tracked using /jobs/{id}.

## Path parameters

- `id` string, required — Node app version ID

## Request body

- object — Input data for the node app execution, matching the node app's input schema

## Response `200`

Execution job created successfully. The job will be in a processing state until completed. Use /jobs/{id} to check progress.

- object[]
  - `job_id` string, uuid, required
  - `status` 'backlogged' | 'queued' | 'scheduled' | 'processing' | 'sampling' | 'intermediate-complete' | 'completed' | 'failed' | 'cancelled', required
  - `created_at` string, date-time, required
  - `completed_at` string, date-time
  - `result` object
    - `urls` union
      - string[]
      - object[]
        - `type` 'model' | 'preview', required
        - `url` string, uri, required
      - object
    - `style_id` string
  - `error` object
    - `code` string, required
    - `message` string

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized
- `402` — You have run out of credits.
- `403` — This node app cannot be used via the API.
- `404` — Node app version not found
- `429` — You have reached the maximum number of concurrent jobs.

---

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