Environment Variables

Organization environment variables are available to Spark jobs and scripts at runtime. Names must start with a letter or underscore, contain only letters, numbers, and underscores, and are normalized to uppercase server-side.

`list_environment_variables()`

List all organization environment variables. Values are decrypted server-side.

all_vars = await client.list_environment_variables()
for variable in all_vars:
    print(variable.name, variable.value)

Return type: `list[EnvironmentVariable]`

Field	Type	Description
`id`	`str`	Variable ID
`name`	`str`	Variable name (stored uppercase)
`value`	`str`	Decrypted value
`organization_id`	`str`	Owning organization
`created_by_user_id`	`Optional[str]`	User who created the variable
`created_at`	`str`	ISO timestamp when created
`updated_at`	`str`	ISO timestamp when last updated

`get_environment_variable(name)`

Get a single environment variable by name. Lookup is case-insensitive since names are stored uppercase. Returns None when not set.

token = await client.get_environment_variable("MY_TOKEN")
if token is not None:
    print(token.value)

`set_environment_variable(name, value)`

Create or update an environment variable. Setting an existing name overwrites its value.

variable = await client.set_environment_variable("MY_TOKEN", "secret-value")
print(variable.id, variable.name)  # name is uppercased

`delete_environment_variable(*, id=None, name=None)`

Delete an environment variable by id or name. Provide exactly one, as a keyword argument.

await client.delete_environment_variable(name="MY_TOKEN")
# or by id:
await client.delete_environment_variable(id="env-var-id")

Raises ValueError if the named variable does not exist.

TypeScript

Python

Environment Variables

`list_environment_variables()`

Return type: `list[EnvironmentVariable]`

`get_environment_variable(name)`

`set_environment_variable(name, value)`

`delete_environment_variable(*, id=None, name=None)`

​list_environment_variables()

​Return type: list[EnvironmentVariable]

​get_environment_variable(name)

​set_environment_variable(name, value)

​delete_environment_variable(*, id=None, name=None)

`list_environment_variables()`

Return type: `list[EnvironmentVariable]`

`get_environment_variable(name)`

`set_environment_variable(name, value)`

`delete_environment_variable(*, id=None, name=None)`