credentials

Set a credential.

Changed on

Creates or replaces a stored credential that machines can use without seeing its value. Requires the machine:create scope.

put/v1/credentials/{name}

Request

Path parameters

namestring required

Credential name

Request body

envVarstring required

The environment variable a machine that binds this credential sees — holding a placeholder, never the value.

hostsstring[] required

The only hosts the value is ever sent to (HTTPS requests only).

valuestring required

Response

Stored; machines bound to it use the new value from their next boot

createdAtstring required
envVarstring required
hostsstring[] required
namestring required
updatedAtstring required

Changes