application
Deploy, control, and configure Coolify apps: start, stop, restart, fetch logs, and sync environment variables.
Instructions
Application lifecycle, deploy, log, and environment-variable actions — list via resource tool. Actions: get(uuid, format?, projection?, reveal?) · start(uuid) · stop(uuid) · restart(uuid) · deploy(uuid, force?) · logs(uuid, lines?, follow?, timeout?, idle_timeout?, min_interval?, max_interval?) — follow runtime only; check system.version capabilities.application_logs_follow · create(source_type, server_uuid) · update(uuid) · delete(uuid, confirm) · delete_preview(uuid) · envs:list(uuid) · envs:get(uuid, key) · envs:create(uuid, key, value) · envs:update(uuid, key, value) · envs:delete(uuid, env_uuid, confirm) · envs:bulk-update(uuid, entries, confirm) · envs:sync(uuid, env_file?, env_content?, dry_run?, confirm?, conflict_policy?) · envs:promote(source_uuid, target_uuid, dry_run?, confirm?, conflict_policy?, reveal?) Safety: confirm for destructive ops · optional instance · reveal opt-in only
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | Environment variable key | |
| tag | No | Single tag batch expand | |
| fqdn | No | Application FQDN substring | |
| name | No | Application name substring | |
| page | No | Page number for pagination | |
| tags | No | Batch deploy tags | |
| type | No | Filter build-logs entries by type (default all — no filter). Applies only to the deployment_uuid (build-logs) path; ignored on runtime logs path. | |
| uuid | No | Application UUID | |
| wait | No | Poll until terminal or timeout | |
| force | No | Force rebuild without cache | |
| lines | No | Number of log lines to retrieve | |
| prune | No | Delete remote env keys absent from local | |
| uuids | No | Batch deploy UUIDs | |
| value | No | Environment variable value | |
| action | Yes | The action to run | |
| follow | No | Poll runtime logs until idle or timeout (runtime identity only) | |
| format | No | Output format (default pretty) | |
| is_spa | No | ||
| offset | No | Skip first K log lines | |
| reveal | No | Reveal sensitive/masked values in full projection (default false — secrets masked as ***) | |
| confirm | No | Explicit confirmation for destructive ops | |
| domains | No | Comma-separated domain list | |
| dry_run | No | Preview diff only | |
| entries | No | ||
| timeout | No | Wait-mode timeout in seconds (deploy wait min 10; follow logs min 1) | |
| env_file | No | Local filesystem path to a .env file | |
| env_uuid | No | Environment variable UUID | |
| instance | No | Coolify instance name from registry (optional — uses env credentials or registry default) | |
| per_page | No | Items per page | |
| redirect | No | ||
| is_static | No | ||
| max_chars | No | Max formatted output characters (default 16000) | |
| build_pack | No | Build pack | |
| dockerfile | No | Dockerfile content | |
| git_branch | No | Git branch | |
| is_literal | No | ||
| is_preview | No | ||
| projection | No | Detail projection depth | |
| description | No | Application description | |
| env_content | No | Inline .env file content | |
| server_uuid | No | Server UUID (required for create) | |
| source_type | No | Application source type for create | |
| source_uuid | No | Source application UUID for envs:promote | |
| target_uuid | No | Target application UUID for envs:promote | |
| watch_paths | No | ||
| idle_timeout | No | Follow idle stop in seconds (default 60 when follow:true) | |
| include_full | No | Alias for projection: full | |
| is_multiline | No | ||
| max_interval | No | Follow max poll interval in seconds (default 30 when follow:true) | |
| min_interval | No | Follow min poll interval in seconds (default 3 when follow:true) | |
| project_name | No | Project name for lookup | |
| project_uuid | No | Project UUID | |
| build_command | No | ||
| custom_labels | No | ||
| is_shown_once | No | ||
| ports_exposes | No | Ports to expose | |
| start_command | No | ||
| base_directory | No | ||
| delete_volumes | No | ||
| docker_cleanup | No | ||
| git_commit_sha | No | Git commit SHA | |
| git_repository | No | Git repository URL | |
| include_hidden | No | Include entries with hidden:true in build-logs output (default false — hidden entries are filtered out) | |
| instant_deploy | No | Queue deploy immediately after create | |
| ports_mappings | No | Port mappings | |
| conflict_policy | No | How to resolve value conflicts on apply | |
| deployment_uuid | No | Deployment UUID for build logs | |
| github_app_uuid | No | GitHub app UUID | |
| install_command | No | ||
| environment_name | No | Environment name | |
| environment_uuid | No | Environment UUID | |
| private_key_uuid | No | Private deploy key UUID | |
| use_build_server | No | ||
| health_check_host | No | ||
| health_check_path | No | ||
| health_check_port | No | ||
| publish_directory | No | ||
| health_check_method | No | ||
| health_check_scheme | No | ||
| health_check_enabled | No | ||
| health_check_retries | No | ||
| health_check_timeout | No | ||
| delete_configurations | No | ||
| force_domain_override | No | Override domain conflict | |
| health_check_interval | No | ||
| is_auto_deploy_enabled | No | ||
| is_force_https_enabled | No | ||
| health_check_return_code | No | ||
| http_basic_auth_password | No | ||
| http_basic_auth_username | No | ||
| connect_to_docker_network | No | ||
| custom_docker_run_options | No | ||
| delete_connected_networks | No | ||
| docker_registry_image_tag | No | Docker registry image tag | |
| health_check_start_period | No | ||
| docker_registry_image_name | No | Docker registry image name | |
| health_check_response_text | No | ||
| is_http_basic_auth_enabled | No | ||
| is_preserve_repository_enabled | No | ||
| is_container_label_escape_enabled | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| data | No | ||
| _meta | No | ||
| error | No | ||
| _size_warning | No | ||
| _formattedText | No |