---
title: "Returns a node version to be installed."
method: GET
path: "/nodes/{nodeId}/install"
tags: ["Nodes"]
---

# Returns a node version to be installed.

`GET /nodes/{nodeId}/install`

Retrieves the node data for installation, either the latest or a specific version.

## Path parameters

- `nodeId` string, required

## Query parameters

- `version` string

## Response `200`

Node data returned successfully.

- NodeVersion
  - `id` string
  - `version` string — The version identifier, following semantic versioning. Must be unique for the node.
  - `createdAt` string, date-time — The date and time the version was created.
  - `changelog` string — Summary of changes made in this version
  - `dependencies` string[] — A list of pip dependencies required by the node.
  - `downloadUrl` string — [Output Only] URL to download this version of the node
  - `deprecated` boolean — Indicates if this version is deprecated.
  - `status` 'NodeVersionStatusActive' | 'NodeVersionStatusDeleted' | 'NodeVersionStatusBanned' | 'NodeVersionStatusPending' | 'NodeVersionStatusFlagged'
  - `status_reason` string — The reason for the status change.

## Other responses

- `400` — Invalid input, such as a bad version format.
- `403` — Forbidden
- `404` — Node not found.
- `500` — Internal server error

## Changes

- **2024-06-19** `71d8dae509a8` — 1 warning
  - added the new `NodeVersionStatusFlagged` enum value to the `status` response property for the response status `200`
- **2024-06-15** `c013102b098c` — 1 info
  - added the optional property `status_reason` to the response with the `200` status
- **2024-06-14** `9c9567cc3e15` — 1 info
  - added the optional property `status` to the response with the `200` status
- **2024-05-23** `9d088b2401a5` — 3 warning
  - removed the optional property `node_id` from the response with the `200` status
  - removed the optional property `status` from the response with the `200` status
  - removed the optional property `status_reason` from the response with the `200` status

[Change history](https://skmtc.dev/comfy-org/apis/comfy-api/changes/nodes/:nodeId/install/get.md)

---

[API](https://skmtc.dev/comfy-org/apis/comfy-api.md) · [All operations](https://skmtc.dev/comfy-org/apis/comfy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/comfy-org/comfy-api/revisions/71d8dae509a8/schema)