# Cyberun ## Docs - [Close tunnel session(s)](https://docs.cyberun.cloud/api-reference/agent/close-tunnel-sessions.md): Closes tunnel sessions for the specified agent. When `session_id` is provided, closes only that specific session. When omitted, closes **all** active tunnel sessions for the agent. The agent returns to idle status once all sessions are closed. - [Get agent system logs](https://docs.cyberun.cloud/api-reference/agent/get-agent-system-logs.md): Fetches the latest system logs directly from the running agent. Data is proxied through the platform. Accepts JWT Bearer or `dk-` device credential — both run through the authorization layer against the underlying user, so Team Owner/Admin is still required. - [Get tunnel status](https://docs.cyberun.cloud/api-reference/agent/get-tunnel-status.md): Returns the current tunnel status for the specified agent. - [List active tunnel sessions](https://docs.cyberun.cloud/api-reference/agent/list-active-tunnel-sessions.md): Returns all active tunnel sessions for this team. Each item includes the agent ID, session ID, tunnel URL, and creation time. No pagination — active tunnel count per team is typically small. - [List connected agents](https://docs.cyberun.cloud/api-reference/agent/list-connected-agents.md): Returns agents currently registered for this team via WebSocket. Data is read from the the platform's runtime state (the cache), not from a database. Maximum 500 agents scanned. Supports pagination. - [List connected agents (runtime)](https://docs.cyberun.cloud/api-reference/agent/list-connected-agents-runtime.md): Returns agents currently registered for this team via WebSocket. Identical to the management endpoint but also accepts the runtime credential bearers. Data is read from the the platform's runtime state (the cache), not from a database. Supports pagination. Accepts JWT Bearer, `sk-` integration crede… - [Open tunnel](https://docs.cyberun.cloud/api-reference/agent/open-tunnel.md): Opens a reverse proxy tunnel to a service running on the specified agent. By default, the tunnel connects to ComfyUI (port 8188). Use `target_port` to tunnel to a different service (e.g. Jupyter on 8888, Gradio on 7860). While the tunnel is active, the agent will not accept new tasks. Multiple team… - [Exchange OAuth login code](https://docs.cyberun.cloud/api-reference/auth/exchange-oauth-login-code.md): Exchanges a one-time OAuth login code for the normal the Cyberun platform access and refresh token pair. Intended to be called by the the Cyberun dashboard server. - [Login with email and password](https://docs.cyberun.cloud/api-reference/auth/login-with-email-and-password.md): Authenticates the user and returns a JWT access token and refresh token. The access token is short-lived (default 1 hour); use the refresh endpoint to obtain new tokens. - [Logout all sessions](https://docs.cyberun.cloud/api-reference/auth/logout-all-sessions.md): Sets a user-level invalidation timestamp in the cache. All access and refresh tokens issued before this timestamp are rejected. Effectively logs out every device. - [Logout current session](https://docs.cyberun.cloud/api-reference/auth/logout-current-session.md): Invalidates the provided refresh token and blacklists the current access token's JTI. Other sessions remain active. Use logout-all to invalidate all sessions. - [OAuth provider callback](https://docs.cyberun.cloud/api-reference/auth/oauth-provider-callback.md): Handles provider callback, links or creates the platform user, then redirects to the Cyberun dashboard with a one-time login code. - [Refresh access token](https://docs.cyberun.cloud/api-reference/auth/refresh-access-token.md): Exchanges a valid refresh token for a new access/refresh token pair. The old refresh token is invalidated (token rotation). If the refresh token has been used before or is blacklisted, returns 401. - [Register a new user](https://docs.cyberun.cloud/api-reference/auth/register-a-new-user.md): Creates a new user account and a personal team. A verification email is sent automatically — the user must verify their email before logging in. - [Request password reset email](https://docs.cyberun.cloud/api-reference/auth/request-password-reset-email.md): Sends a password reset email if the account exists. Always returns 200 regardless of whether the email is registered (prevents user enumeration). The reset token is valid for 1 hour. Maximum 3 active tokens per user. - [Resend email verification](https://docs.cyberun.cloud/api-reference/auth/resend-email-verification.md): Resends the verification email if the account exists and is unverified. Always returns 200 regardless of whether the email is registered. Maximum 3 active verification tokens per user. - [Reset password using token](https://docs.cyberun.cloud/api-reference/auth/reset-password-using-token.md): Resets the user's password using a one-time token from the password reset email. On success, all existing sessions are invalidated (logout-all effect). The token is single-use and expires after 1 hour. - [Revoke the calling device credential](https://docs.cyberun.cloud/api-reference/auth/revoke-the-calling-device-credential.md): Revokes the `dk-` device credential used to authenticate this request and any linked agent credentials minted during client pair. Intended for CLI/Desktop logout without a JWT refresh-token session. - [Start OAuth sign-in](https://docs.cyberun.cloud/api-reference/auth/start-oauth-sign-in.md): Redirects the browser to the configured OAuth/OIDC provider. The optional return_to value is validated and carried through the flow. - [Verify email address using token](https://docs.cyberun.cloud/api-reference/auth/verify-email-address-using-token.md): Verifies the user's email address using the token sent during registration. Email verification is required before the user can log in. The token is valid for 24 hours and is single-use. - [Get ComfyUI Cloud credential status](https://docs.cyberun.cloud/api-reference/cloudprovider/get-comfyui-cloud-credential-status.md): Returns the current status of the team's ComfyUI Cloud credential including a masked key preview and fallback configuration. - [Remove ComfyUI Cloud credential](https://docs.cyberun.cloud/api-reference/cloudprovider/remove-comfyui-cloud-credential.md): Removes the team's ComfyUI Cloud API key. Any running cloud tasks will continue until completion, but new cloud tasks cannot be submitted. - [Set ComfyUI Cloud API key](https://docs.cyberun.cloud/api-reference/cloudprovider/set-comfyui-cloud-api-key.md): Configures or updates the ComfyUI Cloud API key for a team. If a credential already exists, it is replaced. The API key is encrypted at rest. - [Create a container service definition](https://docs.cyberun.cloud/api-reference/container/create-a-container-service-definition.md): Define a new Docker container service that can be deployed to agents. The service_slug must be unique within the team and is used for API routing. - [Delete a container service](https://docs.cyberun.cloud/api-reference/container/delete-a-container-service.md): Delete a service definition. The service must be undeployed first (no running instances). - [Deploy a container service to agents](https://docs.cyberun.cloud/api-reference/container/deploy-a-container-service-to-agents.md): Starts deployment of the service to matching agents based on labels and replica count. Agents pull the Docker image and start the container. - [Get a container service by ID](https://docs.cyberun.cloud/api-reference/container/get-a-container-service-by-id.md) - [Get a container service by slug (runtime)](https://docs.cyberun.cloud/api-reference/container/get-a-container-service-by-slug-runtime.md): Returns details of a specific container service by its slug. Used by API key holders to check service status before calling. - [Get container logs for a specific instance](https://docs.cyberun.cloud/api-reference/container/get-container-logs-for-a-specific-instance.md): Retrieves the last N lines of container logs from a specific instance. Useful when a service has multiple replicas. - [Invoke a container service (runtime)](https://docs.cyberun.cloud/api-reference/container/invoke-a-container-service-runtime.md): Sends an HTTP request to a container service — either through the gateway tunnel to a docker container (deployed type) or through the gateway tunnel to an external URL via agent egress (external type; ADR-0007). Designed as the structured, MCP-friendly entry point. - [List available container services (runtime)](https://docs.cyberun.cloud/api-reference/container/list-available-container-services-runtime.md): Returns running container services for the team. Used by API key holders to discover available service endpoints. - [List container services for a team](https://docs.cyberun.cloud/api-reference/container/list-container-services-for-a-team.md): Returns all container service definitions for the team with pagination. - [List instances of a container service](https://docs.cyberun.cloud/api-reference/container/list-instances-of-a-container-service.md): Returns container instances for the given service, optionally filtered by status. - [Undeploy a container service from all agents](https://docs.cyberun.cloud/api-reference/container/undeploy-a-container-service-from-all-agents.md): Stops and removes all running instances of the service. Agents are instructed to stop and remove the Docker containers. - [Update a container service definition](https://docs.cyberun.cloud/api-reference/container/update-a-container-service-definition.md): Update the service configuration. Changes take effect on next deploy. Cannot update while the service is in deploying/stopping state. - [Call a container service](https://docs.cyberun.cloud/api-reference/containers.md): Three ways to reach a running container service — transparent proxy, structured invoke, and discovery. - [Create a credential](https://docs.cyberun.cloud/api-reference/credential/create-a-credential.md): Issues a new credential for the team. The raw secret is returned only once in the response — store it securely; subsequent list responses only show the prefix. - [List credentials](https://docs.cyberun.cloud/api-reference/credential/list-credentials.md): Returns a paginated list of credentials for the team. Only the prefix is shown — the full secret is never returned after creation. Pass `kind` to filter by credential type. - [Revoke a credential](https://docs.cyberun.cloud/api-reference/credential/revoke-a-credential.md): Permanently revokes the credential. Revoked credentials cannot be reactivated. In-flight requests using this credential fail on the next authentication check. - [Confirm a desktop pairing](https://docs.cyberun.cloud/api-reference/devicepair/confirm-a-desktop-pairing.md): Called by the Cyberun dashboard after the user reviews the consent screen and clicks confirm. Requires an authenticated user session (JWT) — the credential is issued to that user inside the X-Team-ID team. - [Poll for desktop pairing approval](https://docs.cyberun.cloud/api-reference/devicepair/poll-for-desktop-pairing-approval.md): Anonymous endpoint. The desktop calls this at the recommended `interval` until it sees `status=approved`, at which point the response includes the dk- credential exactly once. - [Start a desktop pairing](https://docs.cyberun.cloud/api-reference/devicepair/start-a-desktop-pairing.md): Anonymous endpoint. The desktop calls this first, opens the browser at the returned `verification_uri`, and starts polling `pollDevicePair` with the returned `device_code`. - [Upload input files](https://docs.cyberun.cloud/api-reference/file-upload.md): Stage a file once, then pass its reference to any workflow that takes a file input. - [Request a presigned upload URL](https://docs.cyberun.cloud/api-reference/file/request-a-presigned-upload-url.md): Request a presigned S3 PUT URL to upload a file for use as a workflow input. - [API reference](https://docs.cyberun.cloud/api-reference/introduction.md): REST endpoints exposed by the Cyberun platform. Auto-generated from the OpenAPI spec. - [Accept an invitation](https://docs.cyberun.cloud/api-reference/invitation/accept-an-invitation.md): Accepts a team invitation using the token from the invitation email. The authenticated user is added to the team with the role specified in the invitation. The user must be logged in and their email must match the invitation recipient. - [Cancel a pending invitation](https://docs.cyberun.cloud/api-reference/invitation/cancel-a-pending-invitation.md): Deletes a pending invitation. The invitation link in the email becomes invalid. - [Decline an invitation](https://docs.cyberun.cloud/api-reference/invitation/decline-an-invitation.md): Declines and deletes the invitation. The team admin can re-invite later. - [Invite a user to the team](https://docs.cyberun.cloud/api-reference/invitation/invite-a-user-to-the-team.md): Sends an invitation email to the specified address. The invitee does not need an existing account — they can register after receiving the invitation. Returns 409 if the user is already a member or has a pending invitation. When email is disabled on the server, the response includes the `invitation_t… - [List pending invitations for a team](https://docs.cyberun.cloud/api-reference/invitation/list-pending-invitations-for-a-team.md): Returns a paginated list of pending (not yet accepted/declined) invitations for the team. - [List team members](https://docs.cyberun.cloud/api-reference/member/list-team-members.md): Returns a paginated list of all members in the team, including their roles. - [Remove a member from the team](https://docs.cyberun.cloud/api-reference/member/remove-a-member-from-the-team.md): Removes a member from the team. Only owner and admin can remove members. The team owner cannot be removed. Use this to kick a member; members can also leave voluntarily via the leave endpoint. - [Update a member's role](https://docs.cyberun.cloud/api-reference/member/update-a-members-role.md): Changes a team member's role. Only owner and admin can update roles. Cannot set the role to owner (use the transfer endpoint instead). Cannot change your own role. - [Delete a model](https://docs.cyberun.cloud/api-reference/model/delete-a-model.md): Permanently removes the model record and its S3 object. - [Get model details](https://docs.cyberun.cloud/api-reference/model/get-model-details.md) - [List models for a team](https://docs.cyberun.cloud/api-reference/model/list-models-for-a-team.md): Returns a paginated list of all models belonging to the team. - [Register a model after uploading](https://docs.cyberun.cloud/api-reference/model/register-a-model-after-uploading.md): Confirms a model upload and creates the metadata record. The file must already exist at the storage_key. - [Request a presigned upload URL for a model file](https://docs.cyberun.cloud/api-reference/model/request-a-presigned-upload-url-for-a-model-file.md): Returns a presigned S3 PUT URL for uploading a model file. After uploading, call POST /models to register the model metadata. - [Update model metadata](https://docs.cyberun.cloud/api-reference/model/update-model-metadata.md) - [Delete a custom node](https://docs.cyberun.cloud/api-reference/node/delete-a-custom-node.md): Permanently removes the custom node record and its S3 object. - [Get custom node details](https://docs.cyberun.cloud/api-reference/node/get-custom-node-details.md) - [List custom nodes for a team](https://docs.cyberun.cloud/api-reference/node/list-custom-nodes-for-a-team.md): Returns a paginated list of all custom nodes belonging to the team. - [Register a custom node after uploading](https://docs.cyberun.cloud/api-reference/node/register-a-custom-node-after-uploading.md): Confirms a custom node package upload and creates the metadata record. - [Request a presigned upload URL for a custom node package](https://docs.cyberun.cloud/api-reference/node/request-a-presigned-upload-url-for-a-custom-node-package.md): Returns a presigned S3 PUT URL for uploading a custom node zip archive. After uploading, call POST /nodes to register the node metadata. - [Update custom node metadata](https://docs.cyberun.cloud/api-reference/node/update-custom-node-metadata.md) - [Get count of unread notifications](https://docs.cyberun.cloud/api-reference/notifications/get-count-of-unread-notifications.md) - [List notifications for the current user](https://docs.cyberun.cloud/api-reference/notifications/list-notifications-for-the-current-user.md) - [Mark a single notification as read](https://docs.cyberun.cloud/api-reference/notifications/mark-a-single-notification-as-read.md) - [Mark all notifications as read](https://docs.cyberun.cloud/api-reference/notifications/mark-all-notifications-as-read.md) - [Stream real-time notifications via SSE](https://docs.cyberun.cloud/api-reference/notifications/stream-real-time-notifications-via-sse.md): Server-Sent Events (SSE) endpoint for real-time notification delivery. Connect with `EventSource` to receive push notifications instantly. - [Quickstart](https://docs.cyberun.cloud/api-reference/quickstart.md): Run your first workflow from code — submit a task, follow it to completion, fetch the output. - [Get server information](https://docs.cyberun.cloud/api-reference/server/get-server-information.md): Returns public server configuration and status. No authentication required — intended for frontend to display server state (e.g. whether registration is open). - [Stream task events (SSE)](https://docs.cyberun.cloud/api-reference/streaming-events.md): Follow task progress in real time with the Server-Sent Events endpoint. - [Cancel a task](https://docs.cyberun.cloud/api-reference/task/cancel-a-task.md): Cancel a task that has not yet reached a terminal state. Tasks in pending, waiting, queued, or running status can be cancelled. If the task is already completed, failed, or cancelled, this is a no-op (returns success). If the task is currently running on an agent, the gateway will notify the agent t… - [Execute a workflow by ID](https://docs.cyberun.cloud/api-reference/task/execute-a-workflow-by-id.md): Submit a ComfyUI workflow for execution with optional parameter overrides. Creates an asynchronous task and returns the task ID immediately. Use GET /r/tasks/{taskId} to poll for status updates. Accepts JWT Bearer, `sk-` integration credential, or `dk-` device credential. - [Execute a workflow by slug or slug@version](https://docs.cyberun.cloud/api-reference/task/execute-a-workflow-by-slug-or-slug@version.md): Submit a workflow for execution using its globally unique slug. Identical to runWorkflow but uses the human-readable slug instead of UUID. The slug must belong to the specified team's workflows. Pass `slug@version` (for example, `text-to-image@2`) to run the workflow JSON and parameter definitions s… - [Get task result](https://docs.cyberun.cloud/api-reference/task/get-task-result.md): Retrieve the execution result of a task. Returns output data for completed tasks or error details for failed tasks. Available for tasks in any terminal status (completed, failed, cancelled). Accepts JWT Bearer, `sk-` integration credential, or `dk-` device credential. - [Get task status](https://docs.cyberun.cloud/api-reference/task/get-task-status.md): Retrieve the current status and metadata of a task. Use this to poll for task completion. Accepts JWT Bearer, `sk-` integration credential, or `dk-` device credential. - [List tasks](https://docs.cyberun.cloud/api-reference/task/list-tasks.md): List all tasks for the specified team. Supports pagination and optional status filtering. Accepts JWT Bearer, `sk-` integration credential, or `dk-` device credential. - [Stream task events (SSE)](https://docs.cyberun.cloud/api-reference/task/stream-task-events-sse.md): Opens a Server-Sent Events (SSE) stream for real-time task status updates. The connection stays open until the task reaches a terminal state (completed, failed, or cancelled), then closes automatically. - [Create a new team](https://docs.cyberun.cloud/api-reference/team/create-a-new-team.md): Creates a new team. The authenticated user becomes the owner automatically. A personal team is also created during registration; this endpoint is for creating additional teams. - [Delete team](https://docs.cyberun.cloud/api-reference/team/delete-team.md): Permanently deletes the team and all associated resources (members, invitations, workflows, API keys, cloud provider credentials, webhooks). Only the team owner can delete a team. This action cannot be undone. - [Get team details](https://docs.cyberun.cloud/api-reference/team/get-team-details.md): Returns the display name and ID of the specified team. Requires membership in the team. - [Leave a team](https://docs.cyberun.cloud/api-reference/team/leave-a-team.md): Removes the authenticated user from the team. The team owner cannot leave; transfer ownership first using the transfer endpoint. - [List teams the current user belongs to](https://docs.cyberun.cloud/api-reference/team/list-teams-the-current-user-belongs-to.md): Returns a paginated list of all teams the authenticated user is a member of, including teams where they are owner, admin, member, or viewer. - [Transfer team ownership](https://docs.cyberun.cloud/api-reference/team/transfer-team-ownership.md): Transfers ownership of the team to another existing team member. The current owner is demoted to admin. Only the current owner can transfer. The new owner must already be a member of the team. - [Update team](https://docs.cyberun.cloud/api-reference/team/update-team.md): Updates the team's display name. Only the team owner or admin can update. - [Abort a multipart upload](https://docs.cyberun.cloud/api-reference/upload/abort-a-multipart-upload.md): Cancel a multipart upload and delete all uploaded parts from S3. Use this when the user cancels or an unrecoverable error occurs. - [Complete a multipart upload](https://docs.cyberun.cloud/api-reference/upload/complete-a-multipart-upload.md): Finalize the multipart upload after all parts are uploaded. Provide the ETag returned by S3 for each part. After completion, proceed to the domain-specific create endpoint. - [Get presigned URLs for upload parts](https://docs.cyberun.cloud/api-reference/upload/get-presigned-urls-for-upload-parts.md): Generate presigned PUT URLs for specific parts of a multipart upload. Each URL has a 1-hour expiry. Call again to refresh expired URLs. - [Initiate a multipart upload](https://docs.cyberun.cloud/api-reference/upload/initiate-a-multipart-upload.md): Start a multipart upload for a large file. Obtain a `storage_key` from a domain-specific presign endpoint first, then pass it here. Returns the `upload_id` and recommended part size/count. - [Change current user password](https://docs.cyberun.cloud/api-reference/user/change-current-user-password.md): Changes the password for the authenticated user. Requires the current password for verification. All existing sessions (access and refresh tokens) are invalidated after a successful password change — the client must re-authenticate. - [Get current user profile](https://docs.cyberun.cloud/api-reference/user/get-current-user-profile.md): Returns the authenticated user's profile including all teams they belong to. - [Update current user profile](https://docs.cyberun.cloud/api-reference/user/update-current-user-profile.md): Updates the authenticated user's first name, last name, and display name. All fields are required. - [Create a webhook for a team](https://docs.cyberun.cloud/api-reference/webhook/create-a-webhook-for-a-team.md): Registers a new webhook endpoint that will receive HTTP POST notifications for subscribed events. Returns the webhook ID and a signing secret. - [Delete a webhook](https://docs.cyberun.cloud/api-reference/webhook/delete-a-webhook.md): Permanently removes a webhook and stops all future deliveries. Pending deliveries may still be attempted. - [Get webhook details](https://docs.cyberun.cloud/api-reference/webhook/get-webhook-details.md): Returns full details of a specific webhook including the signing secret. - [List webhooks for a team](https://docs.cyberun.cloud/api-reference/webhook/list-webhooks-for-a-team.md): Returns a paginated list of all webhooks configured for the team. - [Rotate webhook signing secret](https://docs.cyberun.cloud/api-reference/webhook/rotate-webhook-signing-secret.md): Generates a new HMAC-SHA256 signing secret for the webhook, immediately invalidating the previous one. Update your receiver's verification logic before calling this endpoint to avoid delivery failures. - [Update a webhook](https://docs.cyberun.cloud/api-reference/webhook/update-a-webhook.md): Updates webhook properties. Only provided fields are changed; omitted fields retain their current values. - [Create a workflow for a team](https://docs.cyberun.cloud/api-reference/workflow/create-a-workflow-for-a-team.md): Creates a ComfyUI workflow template with configurable parameters. The workflow_json must be in ComfyUI API format (exported via "Save API Format"). Parameter definitions map user-facing keys to specific node inputs in the workflow. See ParameterDef schema for the mapping mechanism. - [Delete a workflow](https://docs.cyberun.cloud/api-reference/workflow/delete-a-workflow.md): Soft-deletes the workflow template. Existing tasks referencing this workflow are not affected, but no new tasks can be submitted for it. - [Export a workflow](https://docs.cyberun.cloud/api-reference/workflow/export-a-workflow.md): Returns the full workflow configuration in an importable format. The response body is identical to CreateWorkflowRequest so it can be directly POSTed to the import endpoint on another team or environment. - [Get workflow details](https://docs.cyberun.cloud/api-reference/workflow/get-workflow-details.md): Returns the full workflow template including workflow_json, parameter definitions, labels, and timeout/retry configuration. - [Get workflow details by slug or slug@version (runtime)](https://docs.cyberun.cloud/api-reference/workflow/get-workflow-details-by-slug-or-slug@version-runtime.md): Returns the full workflow template using its human-readable slug instead of UUID. Identical to GET by ID but allows lookup by the globally unique slug. Pass `slug@version` (for example, `text-to-image@2`) to inspect the workflow JSON and parameter definitions saved for a previous version snapshot. U… - [Get workflow details (runtime)](https://docs.cyberun.cloud/api-reference/workflow/get-workflow-details-runtime.md): Returns the full workflow template including workflow_json, parameter definitions, labels, and timeout/retry configuration. Identical to the management endpoint but also accepts API Key authentication. Use the `parameters` array to discover configurable inputs for RunWorkflow. Accepts JWT Bearer, `s… - [Get workflow snapshot detail](https://docs.cyberun.cloud/api-reference/workflow/get-workflow-snapshot-detail.md): Returns the full content of a snapshot including the workflow JSON and parameter definitions. Used for previewing a snapshot before restoring. - [Import a workflow](https://docs.cyberun.cloud/api-reference/workflow/import-a-workflow.md): Imports a workflow from previously exported data. If a workflow with the same slug already exists in the team, it is overwritten (all fields are updated and the version is incremented). Otherwise a new workflow is created. - [List workflow snapshots](https://docs.cyberun.cloud/api-reference/workflow/list-workflow-snapshots.md): Returns a paginated list of snapshots for a workflow. Snapshots are automatically created when a workflow is updated. - [List workflows for a team](https://docs.cyberun.cloud/api-reference/workflow/list-workflows-for-a-team.md): Returns a paginated list of workflow templates. Workflow JSON and parameter definitions are excluded from list views — use GET by ID for full details. - [List workflows (runtime)](https://docs.cyberun.cloud/api-reference/workflow/list-workflows-runtime.md): Returns a paginated list of workflow templates for the team. Identical to the management endpoint but also accepts API Key authentication. Workflow JSON and full parameter definitions are excluded — use GET by ID for details. Accepts JWT Bearer, `sk-` integration credential, or `dk-` device credenti… - [Restore workflow from snapshot](https://docs.cyberun.cloud/api-reference/workflow/restore-workflow-from-snapshot.md): Restores a workflow to the state captured in the specified snapshot. The current workflow state is saved as a new snapshot before restoring, so the operation is reversible. - [Update a workflow](https://docs.cyberun.cloud/api-reference/workflow/update-a-workflow.md): Updates workflow properties. Only provided fields are changed. If workflow_json is updated, parameter node_id references are re-validated. The version number auto-increments on each update. Updating slug will fail if the new slug conflicts with an existing workflow. - [Agents](https://docs.cyberun.cloud/cloud/concepts/agents.md): Agents that connect out to the Cyberun gateway and execute tasks for your team. - [Container services](https://docs.cyberun.cloud/cloud/concepts/containers.md): Long-running services deployed to your team's agents. - [Credentials](https://docs.cyberun.cloud/cloud/concepts/credentials.md): Three kinds of API key cover programmatic access, agent connections, and device pairing. - [Models](https://docs.cyberun.cloud/cloud/concepts/models.md): Custom checkpoints, LoRAs, and other model files distributed to your team's agents. - [Custom nodes](https://docs.cyberun.cloud/cloud/concepts/nodes.md): Custom node packages distributed to your team's agents. - [Notifications](https://docs.cyberun.cloud/cloud/concepts/notifications.md): In-app messages about your tasks finishing. - [Tasks](https://docs.cyberun.cloud/cloud/concepts/tasks.md): One execution of a workflow. Where you find your outputs and how to follow progress. - [Teams](https://docs.cyberun.cloud/cloud/concepts/teams.md): The unit of scoping in Cyberun. - [Workflows](https://docs.cyberun.cloud/cloud/concepts/workflows.md): Reusable execution templates that define what runs on an agent. - [Features](https://docs.cyberun.cloud/cloud/features.md): What this product ships today. - [Run your first task](https://docs.cyberun.cloud/cloud/getting-started/first-task.md): Pick a workflow, supply parameters, watch it execute. - [Create your first team](https://docs.cyberun.cloud/cloud/getting-started/first-team.md): Teams are the unit of scoping in Cyberun. Everything you create lives inside one. - [Sign up](https://docs.cyberun.cloud/cloud/getting-started/sign-up.md): Create a Cyberun account and verify your email. - [Generate an API key](https://docs.cyberun.cloud/cloud/guides/api-key.md): Create an integration credential and call Cyberun from your own scripts. - [Cyberun CLI](https://docs.cyberun.cloud/cloud/guides/cli.md): Run your team workflows from the terminal with the cyberun command-line tool. - [Connect an agent](https://docs.cyberun.cloud/cloud/guides/connect-agent.md): Install the Cyberun agent on a GPU machine so the team can dispatch tasks to it. - [Connect a Comfy Cloud fallback](https://docs.cyberun.cloud/cloud/guides/connect-comfy-cloud.md): Configure an external Comfy Cloud credential to absorb overflow when local agents are busy. - [Connect a tool via MCP](https://docs.cyberun.cloud/cloud/guides/connect-mcp.md): Let Claude Code, Cursor, Windsurf, or any MCP client drive your team’s Cyberun workflows. - [Deploy a container service](https://docs.cyberun.cloud/cloud/guides/deploy-container.md): Run a long-lived container on your team's agents. - [Install custom nodes](https://docs.cyberun.cloud/cloud/guides/install-custom-nodes.md): Add a custom node package to your team's agents. - [Manage members](https://docs.cyberun.cloud/cloud/guides/manage-members.md): Invite people, change roles, remove members, transfer ownership, delete teams. - [Run a Nerfstudio workflow](https://docs.cyberun.cloud/cloud/guides/nerfstudio.md): Build a Gaussian splatting workflow with the wizard, then run it on an agent. - [Read your notifications](https://docs.cyberun.cloud/cloud/guides/notifications.md): Find, read, and clear in-app notifications about your tasks. - [Upload a model](https://docs.cyberun.cloud/cloud/guides/upload-model.md): Add a checkpoint, LoRA, embedding, or ControlNet to your team. - [Webhooks](https://docs.cyberun.cloud/cloud/guides/webhooks.md): Get HTTP callbacks when tasks change state. - [Workflow snapshots](https://docs.cyberun.cloud/cloud/guides/workflow-snapshots.md): Preview and restore previous versions of a workflow. - [Cyberun Cloud](https://docs.cyberun.cloud/cloud/overview.md): The web dashboard for running AI workflows on GPU agents you control. - [Feature availability](https://docs.cyberun.cloud/cloud/reference/feature-flags.md): If a feature is missing from your dashboard, this page tells you what to look for and who to ask. - [Features](https://docs.cyberun.cloud/features.md): Every feature Cyberun ships today, grouped by product. - [Cyberun documentation](https://docs.cyberun.cloud/index.md): Run AI workflows — image, video, 3D — on GPU machines you control. Browser, agent, AI client, your call. - [Download and install](https://docs.cyberun.cloud/install.md): Get the standalone agent and the Cyberun CLI for your operating system. - [Cloud MCP](https://docs.cyberun.cloud/mcp/cloud.md): Connect any MCP client to Cyberun Cloud and drive the team’s workflows, tasks, agents, and container services. - [Features](https://docs.cyberun.cloud/mcp/features.md): What this product ships today. - [MCP](https://docs.cyberun.cloud/mcp/overview.md): The Cloud MCP server lets any AI client drive Cyberun end-to-end. - [Agents](https://docs.cyberun.cloud/platform/agents.md): Install and operate Cyberun agents on Linux, macOS, and Windows hosts. - [Architecture](https://docs.cyberun.cloud/platform/architecture.md): The Cyberun platform from the outside in — the surfaces clients and agents reach, and how they fit together. - [Deployment patterns](https://docs.cyberun.cloud/platform/deployment-patterns.md): The shapes a Cyberun deployment takes — sovereign on-prem, hyperscaler, mixed control-plane, single-site managed — with the criteria to pick between them. - [Feature catalog](https://docs.cyberun.cloud/platform/feature-catalog.md): Every deployment-toggleable feature in the Cyberun platform — what it controls, the user-visible symptom when it is off, and the recommended default per deployment mode. - [Features](https://docs.cyberun.cloud/platform/features.md): What this product ships today. - [Gateway and tunnels](https://docs.cyberun.cloud/platform/gateway-and-tunnels.md): How Cyberun agents connect, how tasks reach them, and how proxied services work. - [Identity](https://docs.cyberun.cloud/platform/identity.md): How users, integrations, and devices authenticate to the Cyberun platform — the credential families, the built-in OIDC issuer, and external IdP integration. - [License administration](https://docs.cyberun.cloud/platform/license.md): What a Cyberun license governs, how it interacts with feature gating and quotas, and how operators keep it current. - [Observability](https://docs.cyberun.cloud/platform/observability.md): How the Cyberun platform exposes logs, traces, and (in development) metrics for operators. - [Cyberun Platform](https://docs.cyberun.cloud/platform/overview.md): The deployment and engineering surface that underpins Cyberun Cloud. Architecture, dependencies, identity, license, agents, operations. - [Requirements and dependencies](https://docs.cyberun.cloud/platform/requirements.md): What you need to provide to run a Cyberun deployment — external dependencies, supported OS / runtime versions, expected scale ranges. - [Self-host](https://docs.cyberun.cloud/platform/self-host.md): Where to start when a Cyberun deployment lives in your environment — what is public today, what is partner-led, and what to bring to the first conversation. - [Upgrades](https://docs.cyberun.cloud/platform/upgrades.md): How Cyberun versions ship and how operators apply them — release cadence, the patch / minor / major boundary, and what major releases mean for licenses. - [Product map](https://docs.cyberun.cloud/product-map.md): Which Cyberun surface solves which problem — one-page chooser. - [Cyberun skill](https://docs.cyberun.cloud/skill.md): Drive Cyberun Cloud workflows (run tasks, fetch results, manage agents) via the Cloud MCP server at https://core.cyberun.cloud/api/v1/mcp. TRIGGER when the user asks to run, submit, watch, or cancel a Cyberun workflow or task, list Cyberun agents or workflows, or set up MCP access for Cyberun. Authe… - [Features](https://docs.cyberun.cloud/studio/features.md): What this product ships today. - [How it works](https://docs.cyberun.cloud/studio/how-it-works.md): A one-page walkthrough of a project from script to exported cut, through the five sections of Cyberun Studio. - [Cyberun Studio](https://docs.cyberun.cloud/studio/overview.md): A creator workspace for asset-first filmmaking. Plan the story, lock the characters and world, direct the shots, layer the sound, package the cut for handoff. - [Request access](https://docs.cyberun.cloud/studio/request-access.md): How to apply for the Cyberun Studio private alpha, what to prepare, and what happens next. ## OpenAPI Specs - [core-openapi](https://docs.cyberun.cloud/api-reference/core-openapi.yaml) ## Optional - [Cloud dashboard](https://app.cyberun.cloud)