v1

latestOpenAPI 3.0.3MIT2026-07-1411163326.7 KB
Project

Create an environment variable

Creates a new environment variable.

post/project/{project-slug}/envvar

Path parameters

project-slugstring required

Project slug in the form vcs-slug/org-name/repo-name. The / characters may be URL-escaped. For projects that use GitLab or GitHub App, use circleci as the vcs-slug, replace org-name with the organization ID (found in Organization Settings), and replace repo-name with the project ID (found in Project Settings).

Request body

namestring required

The name of the environment variable.

valuestring required

The value of the environment variable.

Example request

{
  "name": "foo",
  "value": "xxxx1234"
}

Response

The environment variable.

namestring required

The name of the environment variable.

valuestring required

The value of the environment variable.

created-atstring

The creation timestamp of the environment variable.

Example response

{
  "name": "foo",
  "value": "xxxx1234",
  "created-at": "#joda/inst 2023-04-14T21:20:14+0000"
}