Coolify

# API Patterns

## Authentication

All API requests require a Bearer token created in the Coolify dashboard under Settings > API Tokens.

```bash
curl -s \
  -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  https://coolify.example.com/api/v1/version
```

The `Accept: application/json` header is required — without it, some endpoints return "Unauthenticated" even with a valid token.

## Permission Scopes

| Scope            | Read | Write | Deploy | Sensitive Data |
| ---------------- | ---- | ----- | ------ | -------------- |
| `read-only`      | Yes  | No    | No     | Redacted       |
| `read:sensitive` | Yes  | No    | No     | Visible        |
| `view:sensitive` | Yes  | Yes   | Yes    | Visible        |
| `deploy`         | No   | No    | Yes    | No             |
| `*`              | Yes  | Yes   | Yes    | Visible        |

Fields like `is_auto_deploy_enabled`, API keys, and passwords are redacted unless the token has `view:sensitive` or `*` scope.

## Environment Variables

Set the Coolify instance URL and token as environment variables:

```bash
export COOLIFY_URL="https://coolify.example.com"
export COOLIFY_TOKEN="1|your-token-here"
```

## Common Endpoints

### Applications

```bash
# List all applications
curl -s -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  "$COOLIFY_URL/api/v1/applications" | jq .

# Get application details
curl -s -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  "$COOLIFY_URL/api/v1/applications/<uuid>"

# Create a public Git application
curl -s -X POST \
  -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "project_uuid": "<project-uuid>",
    "server_uuid": "<server-uuid>",
    "environment_name": "production",
    "git_repository": "https://github.com/org/repo",
    "git_branch": "main",
    "build_pack": "nixpacks",
    "ports_exposes": "3000"
  }' \
  "$COOLIFY_URL/api/v1/applications/public"

# Update application settings
curl -s -X PATCH \
  -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "is_auto_deploy_enabled": true,
    "health_check_path": "/health",
    "health_check_interval": 30
  }' \
  "$COOLIFY_URL/api/v1/applications/<uuid>"

# Delete application
curl -s -X DELETE \
  -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  "$COOLIFY_URL/api/v1/applications/<uuid>"
```

### Deployments

```bash
# Trigger deployment (by UUID)
curl -s -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  "$COOLIFY_URL/api/v1/deploy?uuid=<app-uuid>&force=true"

# Trigger deployment (by webhook URL)
curl -s -H "Authorization: Bearer $COOLIFY_TOKEN" \
  "$COOLIFY_URL/api/v1/applications/<uuid>/deploy"

# List deployments
curl -s -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  "$COOLIFY_URL/api/v1/deployments"

# Get deployment details
curl -s -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  "$COOLIFY_URL/api/v1/deployments/<deployment-uuid>"
```

### Databases

```bash
# List all databases
curl -s -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  "$COOLIFY_URL/api/v1/databases"

# Create a PostgreSQL database
curl -s -X POST \
  -H "Authorization: Bearer $COOLIFY_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "project_uuid": "<project-uuid>",
    "server_uuid": "<server-uuid>",
    "environment_name": "production",
    "type": "postgresql",
    "name": "my-database"
  }' \
  "$COOLIFY_URL/api/v1/databases"
```

###