Store a secret bundle

PUT/secrets/{name}

Stores or replaces an encrypted secret bundle (a set of key→value pairs). merge=true updates the given keys of an existing bundle; false replaces it. Values are sealed at rest and NEVER returned by any endpoint. Gated by the default-deny `secret` op. 501 when no master key is configured.

path parameters

object

namestringrequired

Secret bundle name (a DNS label).

Request bodyapplication/json

PutSecretReq

dataobject | null

additional properties

string

mergeboolean

Responses

204 No contentNo Content

400 Bad requestBad Request

ErrorResponse

codestring

errorstring

501 Not Implemented

ErrorResponse

codestring

errorstring

Authentication

bearerAuthHTTP bearer. Daemon API key. Omit on a keyless loopback daemon.

Request

▍PUT/secrets/{name}

cURL

curl '/secrets/{name}' \
  -X PUT \
  -H 'Content-Type: application/json' \
  -d '{}'

JavaScript

const response = await fetch("/secrets/{name}", {
  method: "PUT",
  headers: {
    "Content-Type": "application/json",
  },
  body: "{}",
});
const data = await response.json();

Python

import requests

response = requests.put(
    "/secrets/{name}",
    headers={
    "Content-Type": "application/json",
},
    data="{}",
)
data = response.json()

Response

204 No content

No response body.