---
title: "List deployments for team"
method: GET
path: "/teams/{team_id}/list_deployments"
tags: ["Deployments"]
---

# List deployments for team

`GET /teams/{team_id}/list_deployments`

Lists deployments for a team with pagination, sorting, and filtering.

## Path parameters

- `team_id` integer, required

## Query parameters

- `cursor` string
- `limit` integer
- `sortBy` string
- `sortOrder` string
- `deploymentType` string
- `q` string
- `projectId` integer
- `creator` integer
- `isDefault` boolean

## Response `200`

- PaginatedDeploymentsResponse
  - `items` PlatformDeploymentResponse[], required
    - union
      - object
        - `id` integer, required
        - `name` string, required — The readable identifier for this deployment, something like playful-otter-123.
        - `createTime` integer, required — Timestamp in milliseconds when this deployment was created.
        - `lastDeployTime` integer, nullable — Timestamp in milliseconds of the last deploy to this deployment, if any.
        - `deploymentType` 'dev' | 'prod' | 'preview' | 'custom', required
        - `projectId` integer, required
        - `creator` integer
        - `previewIdentifier` string
        - `region` 'aws-us-east-1' | 'aws-eu-west-1', required
        - `isDefault` boolean, required — Indicates whether the deployment is the default prod deployment for the project, or the default cloud dev deployment for the member in the project.
        - `reference` string, required — An identifier that uniquely identifies this deployment within the project.
        - `dashboardEditConfirmation` boolean, nullable — Controls whether the dashboard requires a confirmation before allowing edits during a browser session for this deployment. If not set, defaults to true for prod deployments and false for dev and preview deployments.
        - `deploymentUrl` string, required — The full backend URL for this deployment (e.g. "https://joyful-capybara-123.convex.cloud" or "https://calm-cow-456.eu-west-1.convex.cloud"). This is always a `.convex.cloud` URL, even when the deployment is using custom domains. To get the canonical URL, use [`/get_canonical_urls`](https://docs.convex.dev/deployment-api/get-canonical-urls).
        - `expiresAt` integer, nullable — Timestamp in milliseconds when this deployment will be deleted. Preview deployments have this set by default unless overridden.
        - `class` string, required — The deployment class for this deployment.
        - `sendLogsToClient` boolean, nullable — Whether to send function logs to the client. If `null`, the deployment-type default is used (true for dev/preview, false for prod).
        - `kind` 'cloud', required
      - object
        - `name` string, required — The readable identifier for this deployment.
        - `createTime` integer, required — Timestamp in milliseconds when this deployment was created.
        - `deploymentType` 'dev' | 'prod' | 'preview' | 'custom', required
        - `projectId` integer, required
        - `creator` integer, required
        - `previewIdentifier` string
        - `port` integer, required — The port where this local deployment is running.
        - `deviceName` string, required
        - `isActive` boolean, required — Whether this local deployment is currently active.
        - `kind` 'local', required
  - `pagination` PaginationMetadata, required
    - `hasMore` boolean, required
    - `nextCursor` string, nullable

---

[API](https://skmtc.dev/convex/apis/convex-management-api.md) · [All operations](https://skmtc.dev/convex/apis/convex-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/convex/convex-management-api/revisions/8107cc743e0b/schema)