Skip to main content
POST
Set Env Var

Authorizations

Authorization
string
header
required

A floo_ API key.

Headers

X-Floo-Org-Id
string<uuid>

Organization to act in; defaults to the one joined most recently.

Path Parameters

app_id
string<uuid>
required

Query Parameters

env
string
default:dev
preview
string | null

Body

application/json

Request body for setting an environment variable, alone or in an import.

value being required is load-bearing for the write-only contract (#1018): there is no metadata-only mutation, so is_secret can never be flipped without supplying a brand-new value — the old secret value stays unreachable by construction. Pinned by tests/test_env_var_wire_boundary.py.

key
string
required
Maximum string length: 255
Pattern: ^[A-Za-z_][A-Za-z0-9_]*$
value
string
required
Maximum string length: 10000
service_id
string<uuid> | null
is_secret
boolean | null

Response

Successful Response

Response for a single environment variable.

id
string<uuid>
required
app_id
string<uuid>
required
env_id
string<uuid>
required
service_id
string<uuid> | null
required
key
string
required
masked_value
string
required
is_secret
boolean
required
created_at
string<date-time>
required
updated_at
string<date-time>
required