Skip to main content
POST
/
nodes
Register a custom node after uploading
curl --request POST \
  --url https://core.cyberun.cloud/api/v1/nodes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "display_name": "Impact Pack",
  "package_name": "ComfyUI-Impact-Pack",
  "storage_key": "<string>",
  "file_size": 123,
  "file_hash": "<string>",
  "node_version": "4.2.0",
  "pip_requirements": "opencv-python>=4.8\nultralytics>=8.0"
}
'
{
  "id": "019abc12-3456-7890-abcd-ef1234567890"
}

Documentation Index

Fetch the complete documentation index at: https://docs.cyberun.cloud/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

User session JWT (Bearer ). Must be paired with the X-Team-ID request header on team-scoped endpoints so the server knows which team's resources to operate on.

Headers

​
X-Team-ID
string<uuid>

UUID of the team to scope the request to. Used by dual-auth endpoints (runtime + scoped management):

  • JWT callers MUST send it — a user may belong to multiple teams and the runtime cannot otherwise know which one to operate on. Missing header → 400.
  • Credential callers (sk-, dk-) can omit it because the team is derived from the credential row itself. Any value sent is ignored.
Example:

"019abc12-4567-7890-abcd-ef1234567891"

Body

application/json

Confirm node package upload and register metadata.

​
display_name
string
required

Human-readable name for the custom node.

Required string length: 1 - 255
Example:

"Impact Pack"

​
package_name
string
required

Directory name under custom_nodes/ (unique per team). Alphanumeric, hyphens, underscores, dots only.

Required string length: 1 - 100
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9._-]{0,99}$
Example:

"ComfyUI-Impact-Pack"

​
storage_key
string
required

S3 object key returned from the presign endpoint.

​
file_size
integer<int64>
required

File size in bytes.

​
file_hash
string
required

SHA-256 hex digest (prefixed with sha256:).

​
node_version
string
required

Version tag of the custom node package.

Maximum string length: 50
Example:

"4.2.0"

​
pip_requirements
string

Extra pip dependencies beyond the node's own requirements.txt (one package per line). The agent auto-detects and installs requirements.txt from the zip; this field is for additional packages only. Leave empty or omit if not needed.

Example:

"opencv-python>=4.8\nultralytics>=8.0"

Response

Node created

​
id
string<uuid>
required

UUID of the created or updated resource.

Example:

"019abc12-3456-7890-abcd-ef1234567890"