Show current account, user, and API token information. Useful to verify authentication is working.

List all apps in your Deployado account. Optionally filter by project ID.

Get detailed information about a specific app.

Create a new app in a project.

IMPORTANT: Apps with a repository_url are built using Docker. The repository MUST contain a Dockerfile (at dockerfile_path, default "Dockerfile" relative to build_context).

For static websites (HTML/CSS/JS), add a simple Dockerfile: FROM nginx:alpine COPY . /usr/share/nginx/html EXPOSE 80

Key parameters:

• repository_url: Git repo URL (HTTPS). Required for repo-based apps.

• dockerfile_path: Path to Dockerfile relative to build_context (default: "Dockerfile").

• build_context: Subdirectory where Docker build runs, relative to repo root (default: "."). Use this when your site is in a subfolder (e.g. "website").

• port: The port your app listens on inside the container. For nginx use 80, for Node.js typically 3000 or 8080.

• branch: Git branch to build from (default: "main").

Update an existing app's configuration.

Permanently delete an app and all its deployments, releases, and environment variables. Its running containers are stopped and removed on the app server (queued agent action). Fails with 409 deploy_in_progress while a deploy is executing; retry once it finishes. This action cannot be undone.

Trigger a new deployment for an app. Returns immediately with a release_id while the build runs in the background.

The deployment process: source code is cloned → Docker image is built → image is pushed → container is deployed.

After triggering:

• Use deployado_get_release with the returned release_id to check build status (queued → pending → building → ready or failed).

• If the build fails, use deployado_get_build_logs with the release_id to see the Docker build output.

• commit_sha is optional — if omitted, the latest commit from the configured branch is used.

• For runtime container logs after deployment, use deployado_get_logs.

Rollback an app to a previous release version.

List available releases for an app, showing version history and build status. Each release has a status: queued, pending, building, ready (success), or failed. Use deployado_get_build_logs with a release_id to see build output.

Fetch recent runtime logs from a running app's container. NOTE: These are runtime/application logs, NOT build logs. To see build output (e.g. why a deploy failed), use deployado_get_build_logs instead.

Get detailed information about a specific release, including build status, commit info, and error details. Use this to check if a build succeeded or failed after triggering a deploy.

Fetch build logs for a specific release. Use this to diagnose why a build failed.

Returns the Docker build output, including Dockerfile parsing errors, dependency installation logs, and compilation output. If the build is still in progress, returns partial logs collected so far.

IMPORTANT: This returns BUILD logs (from the Docker build process), not runtime container logs. For runtime logs of a running app, use deployado_get_logs instead.

List recent deployments for an app, showing status, version, and timing.

Get detailed information about a specific deployment, including phases and error details.

Get the currently active deployment for an app.

List all environment variables for an app. Values of secret variables may be masked.

Set or update environment variables for an app. Merges with existing variables. A redeploy may be triggered automatically.

Delete a single environment variable from an app.

List all servers with their status and resource metrics (CPU, memory, disk).

Get detailed information about a specific server, including agent version, OS, architecture, and Docker version.

List all projects in your Deployado account.

Get detailed information about a specific project.

Create a new project in your Deployado account.

Update a project's name, description, or other settings.

Delete a project and all its associated apps, stopping and removing each app's containers. Fails with 409 deploy_in_progress while one of its apps is being deployed. This action cannot be undone.

List all managed PostgreSQL databases. Optionally filter by project or status.

Get detailed information about a database, including connection URL and credentials.

Create a new managed PostgreSQL database. The database name will be auto-prefixed with your account slug.

Permanently delete a managed PostgreSQL database. This will drop the database and remove all data. This action cannot be undone.

Connect an app to a database. This injects the connection URL as an environment variable into the app.

Disconnect an app from a database, removing the injected environment variable.

Execute a command inside an app's running container. Timeout is 60 seconds. Returns exit code, stdout, and stderr.

Validate a Deployado blueprint YAML without deploying it. Returns validation results and a preview of what would be created.

Deploy an entire application stack from a blueprint. Can use inline YAML content or a GitHub repository URL.

List all custom domains for an app, including the auto-generated subdomain.

Add a custom domain to an app. You must configure DNS (CNAME or A record) separately.

Remove a custom domain from an app.

Set a domain as the primary domain for an app. The primary domain is used for redirects.

Verify DNS configuration for all domains of an app. Returns per-domain verification status.

List all cron jobs for an app.

Create a new cron job for an app.

Update an existing cron job.

Delete a cron job.

Manually trigger a cron job to run immediately.

Browse available service templates from the Deployado marketplace (databases, caches, monitoring tools, etc.).

List all installed services for your account.

Get detailed information about a specific installed service.

Install a new service from a marketplace template.

Start a stopped service.

Stop a running service.

Restart a service.

List all database backup targets configured for your account.

Create a new database backup target. Backups are stored in S3.

Get a backup target's details and its recent backup runs.

Trigger an immediate backup for a target.

Restore a database from a specific backup run. This will overwrite the target database.

Run a fixed diagnostic checklist against one app. Returns structured results plus a roll-up: deployment status, latest build, target server health, instance count, HTTP probe of the primary domain, env vars, placement. Use this as the first stop when triaging 'app X is acting weird'. Mirrors the deployado doctor CLI command.

Fetch the docker build transcript for a release. Works for both in-progress and finished builds. Returns the full logs plus status/timing metadata. Use this when investigating a build failure — the release ID comes from deployado deploy output or the releases field of an app's deployment.