Skip to main content
PUT
Replace an existing environment variable

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

scope
enum<string>
default:organisation

user addresses the caller's personal manifest; anything else — including an unrecognised value — resolves to organisation. A user request from a token that carries no user identity is a 400, never widened to the organisation. Forwarded as x-param-query-scope.

Available options:
organisation,
user

Body

application/json

Note what is absent: secret, updated_at and updated_by. All three are server-derived; the fields are omitted from the request type rather than accepted-and-ignored so the omission is visible at the boundary.

key
string
required
Maximum string length: 64
Pattern: ^[A-Z_][A-Z0-9_]*$
value
string
description
string
server
string
consumers
enum<string>[]
Available options:
mcp,
skill

Response

The stored entry

key
string
Maximum string length: 64
Pattern: ^[A-Z_][A-Z0-9_]*$
value
string

Either a literal or a SECRET::<name>:: reference. Returned verbatim — never resolved, never redacted.

secret
boolean
read-only

Derived on write from whether value parses as a well-formed reference. Never taken from the client.

description
string

Model-visible for every entry, secret or not

server
string

Catalog server id this variable belongs to, verbatim. Optional — plenty of config belongs to no server.

consumers
enum<string>[]

Narrows which surfaces receive this variable. Empty means all.

Available options:
mcp,
skill
updated_at
string<date-time>
read-only
updated_by
string
read-only

Accounts user id