---
title: "Create Demo Node Endpoint"
method: POST
path: "/user/create-demo-node"
tags: ["user"]
---

# Create Demo Node Endpoint

`POST /user/create-demo-node`

## Request body

- CreateDemoNodeRequest — Create a new demo node. Return an error if that user already has a demo node.
  - `tenant_id` string, required
  - `node_name` string, required
  - `env_overrides` string[]

## Response `200`

Successful Response

- NodeStatus — Describes the current status of a node This object represents both the internal connection state of the Node domain object and the result of a live connectivity check. DEPRECATED: `connected` is deprecated, use `lifecycle_state` instead.
  - `name` string, required
  - `node_id` string, required
  - `create_date_time` string, required
  - `destroy_date_time` string, nullable, required
  - `last_known_version` string, nullable, required
  - `last_known_features` string[], required
  - `demo` boolean, required
  - `ephemeral` boolean
  - `connected` boolean, required — DEPRECATED: Use `lifecycle_state` field instead
  - `lifecycle_state` 'created' | 'connected' | 'disconnected', required
  - `has_failed_pipelines` boolean, required

## Other responses

- `400` — `{"detail": "Demo node already exists"}`
- `403` — `{"detail": "Invalid API Key"}` `{"detail": "Not permitted to access this tenant"}`
- `404` — `{"detail": "Tenant not found"}`
- `422` — Validation Error

---

[API](https://skmtc.dev/tenzir/apis/tenzir-platform-api.md) · [All operations](https://skmtc.dev/tenzir/apis/tenzir-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tenzir/tenzir-platform-api/revisions/1c6c33bb8ba3/schema)