GitMetadata

August 10, 2026 ยท View on GitHub

Populates initial git metadata for different git providers.

Example Usage

import { GitMetadata } from "@vercel/sdk/models/createdeploymentmissingdeploymentstype.js";

let value: GitMetadata = {
  remoteUrl: "https://github.com/vercel/next.js",
  commitAuthorName: "kyliau",
  commitAuthorEmail: "kyliau@example.com",
  commitMessage:
    "add method to measure Interaction to Next Paint (INP) (#36490)",
  commitRef: "main",
  commitSha: "dc36199b2234c6586ebe05ec94078a895c707e29",
  dirty: true,
  ci: true,
  ciType: "github-actions",
  ciGitProviderUsername: "rauchg",
  ciGitRepoVisibility: "private",
  rootDirectory: "apps/web",
};

Fields

FieldTypeRequiredDescriptionExample
remoteUrlstring:heavy_minus_sign:The git repository's remote origin urlhttps://github.com/vercel/next.js
commitAuthorNamestring:heavy_minus_sign:The name of the author of the commitkyliau
commitAuthorEmailstring:heavy_minus_sign:The email of the author of the commitkyliau@example.com
commitMessagestring:heavy_minus_sign:The commit messageadd method to measure Interaction to Next Paint (INP) (#36490)
commitRefstring:heavy_minus_sign:The branch on which the commit was mademain
commitShastring:heavy_minus_sign:The hash of the commitdc36199b2234c6586ebe05ec94078a895c707e29
dirtyboolean:heavy_minus_sign:Whether or not there have been modifications to the working tree since the latest committrue
ciboolean:heavy_minus_sign:True if process.env.CI was set when deployingtrue
ciTypestring:heavy_minus_sign:The type of CI system usedgithub-actions
ciGitProviderUsernamestring:heavy_minus_sign:The username used for the Git Provider (e.g. GitHub) if their CI (e.g. GitHub Actions) was used, if availablerauchg
ciGitRepoVisibilitystring:heavy_minus_sign:The visibility of the Git repository if their CI (e.g. GitHub Actions) was used, if availableprivate
rootDirectorystring:heavy_minus_sign:Path of the deployed directory relative to the detected git repository root. Empty string when deploying from the repository root.apps/web