GetDeploymentsRequest

June 9, 2026 ยท View on GitHub

Example Usage

import { GetDeploymentsRequest } from "@vercel/sdk/models/getdeploymentsop.js";

let value: GetDeploymentsRequest = {
  app: "docs",
  from: 1612948664566,
  limit: 10,
  projectId: "QmXGTs7mvAMMC7WW5ebrM33qKG32QK3h4vmQMjmY",
  projectIds: [
    "prj_123",
    "prj_456",
  ],
  target: "production",
  to: 1612948664566,
  users: "kr1PsOIzqEL5Xg6M4VZcZosf,K4amb7K9dAt5R2vBJWF32bmY",
  since: 1540095775941,
  until: 1540095775951,
  state: "BUILDING,READY",
  teamId: "team_1a2b3c4d5e6f7g8h9i0j1k2l",
  slug: "my-team-url-slug",
};

Fields

FieldTypeRequiredDescriptionExample
appstring:heavy_minus_sign:Name of the deployment.docs
fromnumber:heavy_minus_sign:Gets the deployment created after this Date timestamp. (default: current time)1612948664566
limitnumber:heavy_minus_sign:Maximum number of deployments to list from a request.10
projectIdstring:heavy_minus_sign:Filter deployments from the given ID or name.QmXGTs7mvAMMC7WW5ebrM33qKG32QK3h4vmQMjmY
projectIdsstring[]:heavy_minus_sign:Filter deployments from the given project IDs. Cannot be used when projectId is specified.[
"prj_123",
"prj_456"
]
targetstring:heavy_minus_sign:Filter deployments based on the environment.production
tonumber:heavy_minus_sign:Gets the deployment created before this Date timestamp. (default: current time)1612948664566
usersstring:heavy_minus_sign:Filter out deployments based on users who have created the deployment.kr1PsOIzqEL5Xg6M4VZcZosf,K4amb7K9dAt5R2vBJWF32bmY
sincenumber:heavy_minus_sign:Get Deployments created after this JavaScript timestamp.1540095775941
untilnumber:heavy_minus_sign:Get Deployments created before this JavaScript timestamp.1540095775951
statestring:heavy_minus_sign:Filter deployments based on their state (BUILDING, ERROR, INITIALIZING, QUEUED, READY, CANCELED, BLOCKED)BUILDING,READY
rollbackCandidateboolean:heavy_minus_sign:Filter deployments based on their rollback candidacy
branchstring:heavy_minus_sign:Filter deployments based on the branch name
shastring:heavy_minus_sign:Filter deployments based on the SHA
teamIdstring:heavy_minus_sign:The Team identifier to perform the request on behalf of.team_1a2b3c4d5e6f7g8h9i0j1k2l
slugstring:heavy_minus_sign:The Team slug to perform the request on behalf of.my-team-url-slug