Skip to content

secrets_put

PUT
/secrets/{id}
curl --request PUT \
--url https://api.canopyhq.dev/secrets/example \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "value": "example" }'
id
required

A secret’s identifier within its owning tenant, never its value.

string

The name the tenant gives the secret; options and connections name it by this.

Media typeapplication/json

The value on its way in. It appears in no response and no log.

object
value
required
string
Examplegenerated
{
"value": "example"
}

The secret is sealed again and the outcome is replaced; no secret value is returned.

Media typeapplication/json

The result of writing a named resource, without returning its value.

object
outcome
required

The result of applying a resource write at the door.

string
Allowed values: created replaced unchanged
Example
{
"outcome": "created"
}

The secret now exists under this tenant.

Media typeapplication/json

The result of writing a named resource, without returning its value.

object
outcome
required

The result of applying a resource write at the door.

string
Allowed values: created replaced unchanged
Example
{
"outcome": "created"
}

An invalid body or empty value; the response names the value field without exposing its contents.

No console token, or one that did not verify.

Only an owner of the tenant may configure it.