Update Secret

PUT

/secrets/{secret_name}

curl --request PUT \
  --url https://api.mengi.cloud/secrets/example \
  --header 'Content-Type: application/json' \
  --data '{ "value": "example" }'

Update a secret’s value in OpenBao.

Use deployment_id query param if the secret is deployment-scoped.

Parameters

Path Parameters

secret_name

required

Secret Name

string

Query Parameters

deployment_id

Any of:

string

string format: uuid

null

null

database_id

Any of:

string

string

null

null

organization_id

Any of:

string

string format: uuid

null

null

Request Body^required

Media typeapplication/json

SecretUpdate

object

value

required

Value

string

Example^generated

{
  "value": "example"
}

Responses

200

Successful Response

Media typeapplication/json

SecretResponse

object

name

required

Name

string

key

required

Key

string

deployment_id

Any of:

string

string

null

null

database_id

Any of:

string

string

null

null

organization_id

Any of:

string

string

null

null

Example^generated

{
  "name": "example",
  "key": "example",
  "deployment_id": "example",
  "database_id": "example",
  "organization_id": "example"
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

Example^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}