---
title: list_promote_aliases
product: vercel
url: /docs/agent-resources/vercel-mcp/tools/rolling-releases/list_promote_aliases
canonical_url: "https://vercel.com/docs/agent-resources/vercel-mcp/tools/rolling-releases/list_promote_aliases"
last_updated: 2018-10-20
type: reference
prerequisites:
  - /docs/agent-resources/vercel-mcp/tools/rolling-releases
  - /docs/agent-resources/vercel-mcp/tools
related:
  []
summary: Use list_promote_aliases with Vercel MCP.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

# list_promote_aliases

Gets a list of aliases with status for the current promote.

## Parameters

| Parameter    | Type    | Required | Description                                                                   |
| ------------ | ------- | -------- | ----------------------------------------------------------------------------- |
| `projectId`  | string  | Yes      | The project ID.                                                               |
| `limit`      | number  | No       | Maximum number of aliases to list from a request (max 100).                   |
| `since`      | number  | No       | Get aliases created after this epoch timestamp.                               |
| `until`      | number  | No       | Get aliases created before this epoch timestamp.                              |
| `failedOnly` | boolean | No       | Filter results down to aliases that failed to map to the requested deployment |
| `teamId`     | string  | No       | Team ID.                                                                      |
| `slug`       | string  | No       | Team slug.                                                                    |


---

[View full sitemap](/docs/sitemap)