Skip to main content
POST
Create secrets for an environment

Authorizations

x-brimble-key
string
header
required

API key created in the dashboard under Settings → API keys. Each key carries permission scopes; every endpoint lists the scope it needs.

Path Parameters

projectId
string
required

ID of the project.

Pattern: ^[a-fA-F0-9]{24}$
environment
enum<string>
required

PREVIEW for secrets used by preview deployments; any other value means production. Use the path without this segment for production.

Available options:
PRODUCTION,
PREVIEW

Query Parameters

editor
enum<string>

Replace all secrets with the ones in the request.

Available options:
true,
false

Body

application/json
environments
object[]
required

Secrets to add. With ?editor=true, the full list that replaces the existing secrets.

Response

Envs created successfully

message
string
required

Human-readable result of the request.

Example:

"Envs created successfully"

data
object[]
required

The result of the request.

Last modified on October 11, 2026