Coolify icon

Coolify

Interact with Coolify API

Overview

The node interacts with the Coolify API to manage various resources such as applications, databases, deployments, environment variables, private keys, projects, and servers. Specifically, for the Application - Update operation, it updates an existing application’s details on Coolify by specifying its unique identifier (UUID) and providing new values for one or more fields like name, repository URL, or branch.

This node is beneficial in automation workflows where you need to programmatically update application configurations without manual intervention. For example, you could automate updating the deployment branch of an application after a successful code merge or rename an application based on external triggers.

Properties

Name Meaning
Application ID UUID of the application to update. This uniquely identifies which application to modify.
Update Fields Collection of fields to update:
• Name: New name for the application
• Repository: New repository URL
• Branch: New branch to deploy

Output

The node outputs an array of JSON objects representing the updated application(s). Each object contains the updated data returned from the Coolify API after the update operation. The exact structure depends on the API response but typically includes application details such as ID, name, repository, branch, and other metadata.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to the Coolify API.
  • Needs an API authentication token configured in n8n credentials to authorize requests.
  • The node uses internal helper functions to make HTTP requests to Coolify endpoints.

Troubleshooting

  • Common issues:
    • Invalid or missing Application ID (UUID) will cause the update to fail.
    • Providing no fields in "Update Fields" collection may result in no changes being applied.
    • Network or authentication errors if the API key credential is invalid or expired.
  • Error messages:
    • "The resource "application" is not implemented!" — indicates a misconfiguration or unsupported resource selection.
    • "The operation "update" is not implemented!" — indicates the operation is not available for the selected resource.
    • API errors returned from Coolify (e.g., 404 Not Found if UUID does not exist, 401 Unauthorized if credentials are invalid).
  • Resolutions:
    • Verify the Application ID is correct and exists in Coolify.
    • Ensure at least one field is provided to update.
    • Check that the API key credential is valid and has necessary permissions.
    • Confirm network connectivity to the Coolify API endpoint.

Links and References

Discussion