Skip to main content
POST
Create a set

Authorizations

Authorization
string
header
required

An opaque access token from /login or /refresh. Tokens are checked against the database on every request, so revocation is immediate.

Body

application/json
name
string
required

1-63 characters, lowercase letters, numbers and hyphens, starting and ending with a letter or number. Unique across the install.

Pattern: ^[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?$
public
boolean
default:false

false (default) makes a deployable set: bindable to hosts, never revealable. true makes a team-shared set: revealable, never bindable.

entries
object[]

Response

Set created

id
string<uuid>
name
string
public
boolean
keys
string[]

Environment variable names. Values are never returned here.

created_at
string<date-time>
updated_at
string<date-time>
permissions
string[]
backup_jobs
object[]

Backup jobs pinning this set, limited to those the reader can see.