Create secret
POST
Create secret

Authorizations

Authorization
string
header
required

Voiceflow bearer token

Query Parameters

projectID
string
required

The ID of the project to operate on.

Body

name
string
required

The name of the secret. Must be unique within the project.

defaultValue
string

The project-level value. Omit to create the secret as a placeholder with no value — a teammate can fill it in later through the Voiceflow UI or CLI.

visibility
object
default:"masked"

Whether the value can be revealed in the Voiceflow UI. restricted secrets can never be read back by anyone.

Response

201 - application/json

Returns the new secret with its generated ID, the value to reference from a tool input default so the credential is injected at runtime, plus its name, visibility and whether a value is stored.

secret
object
required

Use the up and down arrow keys to select a result, Enter to open it, and Escape to close the search.