Environment variables

Project environment variables, scoped per environment. Values are stored encrypted.

env.list

List one environment’s variables with decrypted values (production by default).

GET /v1/orgs/{orgId}/projects/{projectId}/env

Auth: Organization API key (Authorization: Bearer korve_...) or dashboard session.
Minimum role: admin
Risk: read

Query parameters

Name	Type	Required	Description
`environment`	string	No	Pattern: `^[a-z][a-z0-9-]{0,38}$`.

Example

curl "https://api.korve.dev/v1/orgs/$ORG_ID/projects/$PROJECT_ID/env?environment=example" \
  -H "Authorization: Bearer korve_..."

Responses

Status	Description
`200`	Decrypted environment variables.
`404`	No such project or environment in this organization.

Response body (200)

An array of objects with these fields:

Field	Type	Description
`key`	string	Pattern: `^[A-Z][A-Z0-9_]{0,63}$`.
`value`	string	—

env.set

Set environment variables in a batch — existing keys in the addressed environment (production by default) are overwritten.

PUT /v1/orgs/{orgId}/projects/{projectId}/env

Auth: Organization API key (Authorization: Bearer korve_...) or dashboard session.
Minimum role: admin
Billing: requires active organization billing — returns 402 otherwise.
Risk: write · sensitive (elevated blast radius)

Query parameters

Name	Type	Required	Description
`environment`	string	No	Pattern: `^[a-z][a-z0-9-]{0,38}$`.

Request body

Field	Type	Required	Description
`vars`	object[]	Yes	—
`vars[].key`	string	Yes	Pattern: `^[A-Z][A-Z0-9_]{0,63}$`.
`vars[].value`	string	Yes	—

Example

curl -X PUT "https://api.korve.dev/v1/orgs/$ORG_ID/projects/$PROJECT_ID/env?environment=example" \
  -H "Authorization: Bearer korve_..." \
  -H "Content-Type: application/json" \
  -d '{
  "vars": [
    {
      "key": "API_BASE_URL",
      "value": "https://api.example.com"
    }
  ]
}'

Responses

Status	Description
`200`	Variables stored.
`402`	Organization billing is not active.
`404`	No such project or environment in this organization.
`422`	Invalid variable key or value.

Response body (200)

Field	Type	Description
`count`	integer	—

env.delete

Delete one environment variable from the addressed environment (production by default).

DELETE /v1/orgs/{orgId}/projects/{projectId}/env/{key}

Auth: Organization API key (Authorization: Bearer korve_...) or dashboard session.
Minimum role: admin
Risk: destructive

Query parameters

Name	Type	Required	Description
`environment`	string	No	Pattern: `^[a-z][a-z0-9-]{0,38}$`.

Example

curl -X DELETE "https://api.korve.dev/v1/orgs/$ORG_ID/projects/$PROJECT_ID/env/uploads%2Freport.pdf?environment=example" \
  -H "Authorization: Bearer korve_..."

Responses

Status	Description
`200`	Variable deleted.
`404`	No such variable in this environment.

Getting started

Agents

Primitives

API reference

CLI reference

Environment variables

env.list

Query parameters

Example

Responses

Response body (200)

env.set

Query parameters

Request body

Example

Responses

Response body (200)

env.delete

Query parameters

Example

Responses

​env.list

​Query parameters

​Example

​Responses

​Response body (200)

​env.set

​Query parameters

​Request body

​Example

​Responses

​Response body (200)

​env.delete

​Query parameters

​Example

​Responses

env.list

Query parameters

Example

Responses

Response body (200)

env.set

Query parameters

Request body

Example

Responses

Response body (200)

env.delete

Query parameters

Example

Responses