Vercel

Create Environment Variables

Creates new environment variables for a given project. This endpoint will fail if any of the specified environment variable keys already exist, unless upsert is set to true.

POST/v1/projects/{projectId}/env-vars

Usage

TypeScript Example
import { v0 } from 'v0-sdk'// Create new environment variables (will fail if keys already exist)const result = await v0.projects.createEnvVars({projectId: 'project_abc123',environmentVariables: [{key: 'DATABASE_URL',value: 'postgresql://user:pass@host:5432/db',},{key: 'API_SECRET_KEY',value: 'sk_1234567890abcdef',},],})console.log(result)// Upsert environment variables (will overwrite existing values)const upsertResult = await v0.projects.createEnvVars({projectId: 'project_abc123',upsert: true,environmentVariables: [{key: 'DATABASE_URL',value: 'postgresql://newuser:newpass@newhost:5432/newdb',},],})console.log(upsertResult)

API Signature

Request

Path Parameters

projectId: string

The unique identifier of the project where environment variables should be created.

Query Parameters

decrypted?: 'true' | 'false'

Whether to return decrypted values. Defaults to false (encrypted).

Body

environmentVariables: object[]

An array of environment variables to create with key and value fields.

key: string

The name of the environment variable.

value: string

The value of the environment variable.

upsert?: boolean

Whether to overwrite existing environment variables with the same keys. Defaults to false.

Response

object: 'list'
data: object[]
id?: string

A unique identifier for the environment variable.

object?: 'environment_variable'

The object type.

key?: string

The name of the environment variable.

value?: string

The value of the environment variable.

decrypted?: boolean

Whether the value is decrypted or encrypted.

createdAt?: number

The timestamp when the environment variable was created.

updatedAt?: number

The timestamp when the environment variable was last updated.

On this page