> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oleander.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Environment Variables

> Manage organization environment variables available to Spark jobs and scripts.

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.

## `listEnvironmentVariables()`

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

```ts theme={null}
const all = await client.listEnvironmentVariables();
for (const variable of all) {
  console.log(variable.name, variable.value);
}
```

### Return type: `EnvironmentVariable[]`

| Field | Type | Description |
| - | - | - |
| `id` | `string` | Variable ID |
| `name` | `string` | Variable name (stored uppercase) |
| `value` | `string` | Decrypted value |
| `organization_id` | `string` | Owning organization |
| `created_by_user_id` | nullable string | User who created the variable |
| `created_at` | `string` | ISO timestamp when created |
| `updated_at` | `string` | ISO timestamp when last updated |

***

## `getEnvironmentVariable(name)`

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

```ts theme={null}
const token = await client.getEnvironmentVariable("MY_TOKEN");
if (token) {
  console.log(token.value);
}
```

***

## `setEnvironmentVariable(name, value)`

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

```ts theme={null}
const variable = await client.setEnvironmentVariable("MY_TOKEN", "secret-value");
console.log(variable.id, variable.name); // name is uppercased
```

***

## `deleteEnvironmentVariable(options)`

Delete an environment variable by `id` or `name`. Provide exactly one.

```ts theme={null}
await client.deleteEnvironmentVariable({ name: "MY_TOKEN" });
// or by id:
await client.deleteEnvironmentVariable({ id: "env-var-id" });
```

Throws an error if the named variable does not exist.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.