environment

Create one or more shared environment variables

Changed on

Creates shared environment variable(s) for a team.

post/v1/env

Request

  • Base URL: https://api.vercel.com
  • URL: https://api.vercel.com/v1/env
  • Auth: HTTP bearer

Query parameters

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Request body

OR
OR

Example request

{
  "evs": [
    {
      "key": "API_URL",
      "value": "https://api.vercel.com",
      "comment": "database connection string for production"
    }
  ],
  "type": "encrypted",
  "target": [
    "production",
    "preview"
  ],
  "projectId": [
    "prj_2WjyKQmM8ZnGcJsPWMrHRHrE",
    "prj_2WjyKQmM8ZnGcJsPWMrHRCRV"
  ]
}

Response

Example response

{
  "created": [
    {
      "created": "2021-02-10T13:11:49.180Z",
      "createdAt": 1609492210000,
      "createdBy": "2qDDuGFTWXBLDNnqZfWPDp1A",
      "deletedAt": 1609492210000,
      "deletedBy": "2qDDuGFTWXBLDNnqZfWPDp1A",
      "id": "env_XCG7t7AIHuO2SBA8667zNUiM",
      "key": "my-api-key",
      "ownerId": "team_LLHUOMOoDlqOp8wPE4kFo9pE",
      "projectId": [
        "prj_2WjyKQmM8ZnGcJsPWMrHRHrE",
        "prj_2WjyKQmM8ZnGcJsPWMrasEFg"
      ],
      "target": [
        "production"
      ],
      "type": "encrypted",
      "updatedAt": 1609492210000,
      "updatedBy": "2qDDuGFTWXBLDNnqZfWPDp1A"
    }
  ]
}

Changes