v1

latestOpenAPI 3.0.02026-07-1410578280.2 KB

Secret

Create a secret

post/secrets/create

Request body

Datastring

Base64-url-safe-encoded (RFC 4648) data to store as secret.

This field is only used to create a secret, and is not returned by other endpoints.

Labelsobject

User-defined key/value metadata.

Namestring

User-defined name of the secret.

Example request

{
  "Data": "VEhJUyBJUyBOT1QgQSBSRUFMIENFUlRJRklDQVRFCg==",
  "Driver": {
    "Name": "secret-bucket",
    "Options": {
      "OptionA": "value for driver option A",
      "OptionB": "value for driver option B"
    }
  },
  "Labels": {
    "foo": "bar"
  },
  "Name": "app-key.crt"
}

Response

no error

IDstring

The ID of the created secret.

Example response

{
  "ID": "ktnbjxoalbkvbvedmg1urrz8h"
}