Coolify API
The Coolify REST API lets integrations inspect and manage teams, projects, applications, databases, services, servers, deployments, and other Coolify resources.
Base URLs
| Deployment | Base URL |
|---|---|
| Coolify Cloud | https://app.coolify.io/api/v1 |
| Self-hosted Coolify | https://<your-coolify-domain>/api/v1 |
For example, a self-hosted instance at https://coolify.shadowarcanist.com uses:
https://coolify.shadowarcanist.com/api/v1The public health check is available at /api/health and /api/v1/health. It does not require a Bearer token.
Before sending a protected request
- Create an API token for the team and permissions the integration needs.
- Follow Authorization to send the token as a Bearer credential.
- Follow Making Requests to build the URL, headers, parameters, and request body.
- Choose an operation from Endpoints in the API sidebar.
On a self-hosted instance, an administrator must also enable API access. Use IP Allowlist to enable the API and optionally restrict requests by source address.
API reference sections
- Making Requests explains URLs, methods, headers, parameters, bodies, and responses.
- Authorization explains Bearer tokens and access checks.
- Permissions covers token abilities, team scope, roles, and sensitive data.
- IP Allowlist covers self-hosted API access and source-IP restrictions.
- Rate Limits documents request limits, response headers, and retries.
- Errors explains status codes and common failure responses.
- Endpoints contains the generated request and response schema for each API operation.