Environment

Set environment variable

Create or replace one encrypted project environment variable.

PUT/api/v1/projects/{projectID}/environment/{name}

Authentication: REST bearer token required.

Parameters

projectIDUUIDrequired

PathThe project UUID.

namestringrequired

PathThe case-sensitive environment variable name.

valuestringrequired

BodyThe plaintext value. It is encrypted and is never returned by the API.

Responses

200

The stored variable name and non-secret digest.

400

The request is invalid or contains an unsupported value.

401

The bearer token is missing, invalid, or expired.

404

The requested resource does not exist for this account.

cURL

curl --fail-with-body --request PUT \
  --url "https://api.sitedropper.com/api/v1/projects/${PROJECT_ID}/environment/API_BASE_URL" \
  --header "Authorization: Bearer $SITEDROPPER_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
  "value": "https://api.example.com"
}'

Response · 200

{
  "id": "cccd8a27-8c65-456c-90f3-aeaee7a32142",
  "name": "API_BASE_URL",
  "value_digest": "sha256:0b7f…2cc1",
  "created_at": "2026-08-20T22:34:00Z",
  "updated_at": "2026-08-20T22:34:00Z"
}