Coolify icon

Coolify

Interact with Coolify API
Join our community

Actions36

Overview

This node integrates with the Coolify API to manage environment variables for applications. Specifically, the "Update" operation under the "Environment Variable" resource allows users to modify environment variables of a specified application. This is useful in scenarios where you need to programmatically change configuration settings or secrets for an application without manually accessing the Coolify dashboard.

Practical examples include:

  • Updating API keys or tokens stored as environment variables.
  • Changing feature flags or configuration parameters dynamically.
  • Rotating secrets by updating sensitive environment variables marked as secret.

Properties

Name Meaning
Application ID The unique identifier of the application whose environment variables are being updated.
Environment Variables A collection of key-value pairs representing environment variables to set or update. Each variable includes: Key (name), Value, and a flag indicating if it is secret (sensitive). Multiple variables can be updated at once.
Additional Fields Optional settings including:
• Preview Only: If true, changes are previewed but not applied.
• Restart Application: Whether to restart the application after updating environment variables (default is true).

Output

The node outputs a JSON array containing the results of the update operation. Each item corresponds to the response from the Coolify API for the updated environment variables. The exact structure depends on the API response but generally includes confirmation of the updated variables.

No binary data output is produced by this node.

Dependencies

  • Requires an active connection to the Coolify API via an API authentication token configured in n8n credentials.
  • The node uses internal helper functions to make HTTP requests to Coolify endpoints.
  • No additional external dependencies beyond the Coolify API and proper credential setup.

Troubleshooting

  • Common Issues:

    • Invalid or missing Application ID will cause the update to fail.
    • Incorrect API credentials or expired tokens will result in authentication errors.
    • Attempting to update environment variables without required permissions may lead to authorization errors.
    • Setting invalid environment variable keys or values might cause API validation errors.

  • Error Messages:

    • "The resource "environmentVariable" is not implemented!" — indicates a misconfiguration or unsupported resource selection.
    • "The operation "update" is not implemented!" — suggests the operation name is incorrect or not supported.
    • Network or API errors typically indicate connectivity issues or invalid credentials.

  • Resolutions:

    • Verify that the Application ID is correct and exists in Coolify.
    • Ensure API credentials are valid and have necessary permissions.
    • Double-check environment variable keys and values for correctness.
    • Use the "Preview Only" option to test changes before applying them.

Links and References

Discussion