Skip to content

list_deploys

List all active deployments for the authenticated user.

Annotations

AnnotationValue
readOnlyHinttrue
destructiveHintfalse
openWorldHinttrue

Parameters

None.

Return Format

Active deployments (3):

- **my-portfolio** — https://my-portfolio.based.page
  ID: dep_abc123 | My Portfolio | Updated: 2026-03-01T10:30:00Z

- **acme-launch** — https://acme-launch.based.page
  ID: dep_def456 | Acme Launch Page | Updated: 2026-02-28T14:00:00Z

- **blog-v2** — https://blog-v2.based.page
  ID: dep_ghi789 | (untitled) | Updated: 2026-02-25T09:15:00Z

When there are no active deployments:

No active deployments.

Example

User prompt:

"Show me all my active deployments"

What Claude does:

  1. Calls list_deploys (no parameters).
  2. Returns a summary of each deployment with slug, URL, ID, title, and last update time.

User prompt:

"Which of my deploys was updated most recently?"

What Claude does:

  1. Calls list_deploys.
  2. Reads the updated_at timestamps.
  3. Reports the most recently updated deployment.

Notes

  • Requires authentication. If not logged in, this tool will fail. Use login first.
  • Returns only active (non-deleted) deployments.
  • Use the ID values from this list with get_status, update, or teardown.
  • The free plan allows up to 5 active deployments. Use this tool to see how many slots you have remaining.

Deploy apps from conversation.