Storage & Variables
client.storage, client.variables, and client.secretVariables — files and configuration secrets.
On this page4
client.storage
Vault file storage (/api/files).
| Method | Description |
|---|---|
list(folder?, options?) | AsyncGenerator<File> |
listPage(folder?, options?) | PaginatedResponse<File> |
get(fileId, options?) | Metadata |
getDownloadUrl(fileId, options?) | Signed download URL |
upload(filename, content, mimeType?, options?) | Multipart upload (up to 1GB) |
delete(fileId, options?) | Delete |
mkdir(path, options?) | Create folder |
for await (const file of client.storage.list('reports/2026')) {
console.log(file.name, file.pretty_size)
}
await client.storage.upload(
'scan.txt',
'results…',
'text/plain',
)
const url = await client.storage.getDownloadUrl(fileId)Types: File, Folder
client.variables
Regular (non-secret) variables.
| Method | Description |
|---|---|
list(spaceId?, options?) | Generator |
listPage(spaceId?, options?) | One page |
get(id, options?) | By id |
set(data, options?) | CreateVariable — { name, value, … } |
delete(id, options?) | Delete |
There is no is_secret flag on this service — secrets use secretVariables.
client.secretVariables
Separate API; values are always masked on read.
| Method | Description |
|---|---|
list({ scopeType, space? }, options?) | List secrets |
create(data, options?) | CreateSecretVariable |
update(id, value, options?) | Rotate value |
delete(id, options?) | Delete |
await client.secretVariables.create({
name: 'API_KEY',
value: process.env.API_KEY!,
scope_type: 'space',
space: spaceId,
})Types: Variable, CreateVariable, SecretVariable, CreateSecretVariable