list_deploys
List all active deployments for the authenticated user.
Annotations
| Annotation | Value |
|---|---|
readOnlyHint | true |
destructiveHint | false |
openWorldHint | true |
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:00ZWhen there are no active deployments:
No active deployments.Example
User prompt:
"Show me all my active deployments"
What Claude does:
- Calls
list_deploys(no parameters). - 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:
- Calls
list_deploys. - Reads the
updated_attimestamps. - Reports the most recently updated deployment.
Notes
- Requires authentication. If not logged in, this tool will fail. Use
loginfirst. - Returns only active (non-deleted) deployments.
- Use the
IDvalues from this list withget_status,update, orteardown. - The free plan allows up to 5 active deployments. Use this tool to see how many slots you have remaining.