Coolify icon

Coolify

Interact with Coolify API

Overview

This node integrates with the Coolify API to manage private keys within the Coolify platform. Specifically, the "Create" operation for the "Private Key" resource allows users to add a new SSH private key by specifying its name, value, and optional metadata such as description and labels.

Common scenarios where this node is beneficial include automating the management of SSH keys used for deployments or server access in Coolify-managed environments. For example, a DevOps engineer can use this node in an automation workflow to programmatically create and store private keys needed for application deployment pipelines.

Properties

Name Meaning
Name The name identifier for the private key being created.
Value The actual SSH private key content (input as a password field for security).
Additional Fields Optional extra information:
- Description A textual description of the private key.
- Labels One or more labels/tags to organize and categorize the private key within Coolify.

Output

The node outputs an array of JSON objects representing the created private key(s) as returned by the Coolify API. Each object typically includes details such as the private key's ID, name, description, labels, and other metadata assigned by the API.

No binary data output is involved in this operation.

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 API credentials will cause authentication failures.
    • Providing an improperly formatted SSH private key value may result in API validation errors.
    • Network connectivity problems can prevent communication with the Coolify API.
  • Error messages:

    • "The resource "privateKey" is not implemented!" indicates a misconfiguration or unsupported resource selection.
    • "The operation "create" is not implemented!" suggests the operation is not available for the selected resource.
    • API error responses related to invalid input should be checked for required fields and correct formatting.

To resolve these, verify API credentials, ensure all required properties are correctly set, and confirm network access to the Coolify API endpoint.

Links and References

Discussion