Skip to main content
POST
/
v1
/
secrets
/
{name}
JavaScript
import Runloop from '@runloop/api-client';

const client = new Runloop({
  bearerToken: process.env['RUNLOOP_API_KEY'], // This is the default and can be omitted
});

const secretView = await client.secrets.update('name', { value: 'value' });

console.log(secretView.id);
{
  "id": "<string>",
  "name": "<string>",
  "create_time_ms": 123,
  "update_time_ms": 123
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
name
string
required

The name of the Secret to update.

Body

application/json

Parameters required to update an existing Secret.

​
value
string
required

The new value for the Secret. This will replace the existing value and be encrypted at rest. Example: 'my-updated-secure-password'

Response

Secret updated successfully. Returns the Secret with its new value included.

A Secret represents a key-value pair that can be securely stored and used in Devboxes as environment variables.

​
id
string
required

The unique identifier of the Secret.

​
name
string
required

The globally unique name of the Secret. Used as the environment variable name in Devboxes.

​
create_time_ms
integer<int64>
required

Creation time of the Secret (Unix timestamp in milliseconds).

​
update_time_ms
integer<int64>
required

Last update time of the Secret (Unix timestamp in milliseconds).