Overview

ComfyDeploy V2 APIs bring significant improvements in performance and features. This guide will walk you through the two main steps required to upgrade from V1 to V2.

1

Ensure ComfyDeploy node is up-to-date

Reccomend to use v2.1.0 aka 62f8e388bb5217bb0472cb14bd7bf2d417225017 or any recent version

2

Update API integration

V2 API uses new endpoints. You’ll need to update your API integration as follows:

API VersionBase URL
V1 (Old)https://www.comfydeploy.com/api/
V2 (New)https://api.comfydeploy.com/api/

If you are using SDK, ensure you update to the latest SDK

bun install comfydeploy@latest

We are not actively maintaining the python and ruby SDKs since less usage as we are seeing, please get into contact with us if you need help.

API Endpoint Changes

EndpointV1 (Legacy)V2 (Current)
Create RunPOST /runPOST /run/deployment/queue
Get Run StatusGET /run?run_id={run_id}GET /run/{run_id}

Remember to update your base URL from https://www.comfydeploy.com/api to https://api.comfydeploy.com/api

3

Test Your API Integration

If you are using ComfyDeploy Machine, you are all set.

We will soon migrate all RunPod V1 users to V2, and using old comfydeploy custom nodes will break after April 15th.

This test will help ensure your integration is working correctly with the V2 API.

Make sure you’re using the new base URL: https://api.comfydeploy.com/api

What’s New in V2?

  • Improved performance and stability
  • Default sessions editing for all v4 machines
  • v2 python API, more resource access for enterprise users
  • Private outputs buckets for enterprise users

Need Help?

If you encounter any issues during the upgrade process:

  • Check the machine logs for any errors
  • Join our Discord community for support
  • Contact us via email for enterprise support

Make sure to test your workflows after upgrading to ensure everything works as expected.