Skip to content

feat(app): add list, get, create, and update preview commands - #101

Merged
andrasbacsai merged 1 commit into
mainfrom
preview-deployments-api
Oct 6, 2026
Merged

andrasbacsai merged 1 commit into
mainfrom
preview-deployments-api

Conversation

@andrasbacsai

Copy link
Copy Markdown
Member

Summary

  • Adds coolify app previews list <app_uuid>, which lists an application's preview deployments with the newest pull request first.
  • Adds coolify app previews get <app_uuid> <pr_id>, which shows one preview deployment by pull request ID.
  • Adds coolify app previews create <app_uuid> <pr_id>, with the aliases open and deploy. It opens a preview and queues its deployment, or redeploys the preview if it already exists. Flags:
    • --git-type (github, gitlab, gitea, bitbucket). Required unless the app uses a GitHub App or GitLab App source.
    • --commit. Required for Bitbucket.
    • --docker-tag. Required for a new preview of a Docker Image app.
    • --url, --force and --no-deploy.
  • Adds coolify app previews update <app_uuid> <pr_id>, which replaces a preview's domains:
    • --domains and the repeatable --compose-domain <service>=<url> can't be used together.
    • --force-domain-override saves the domains even when another resource uses them.
    • The new domains apply after the preview is redeployed.
  • <pr_id> must be a positive integer for get, create and update.
  • Minimum Coolify version checks: list, get and create need Coolify 4.4.0 or later. update needs 4.3.15 or later.
  • Adds the matching service methods and models, with unit tests that run against a mock HTTP server.
  • Updates README.md and llms-full.txt with the new commands, flags and aliases.

Add `coolify app previews list|get|create|update` subcommands backed by
new ApplicationService methods and preview models.

- create opens a preview for a pull request and queues a deployment
  (redeploys an existing preview); supports --git-type, --commit,
  --docker-tag, --url, --force, and --no-deploy
- update replaces preview domains via --domains or repeatable
  --compose-domain, with optional --force-domain-override
- validate pr_id as a positive integer and require Coolify 4.4.0+
- document the new commands in README and llms-full.txt and add
  service tests
@andrasbacsai
andrasbacsai merged commit 26debcf into main Oct 6, 2026
5 checks passed
@andrasbacsai
andrasbacsai deleted the preview-deployments-api branch October 6, 2026 17:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant