Skip to main content
PATCH
/
org
/
{org}
/
secret
/
{name}
Perform a Patch on a secret by name
curl --request PATCH \
  --url https://api.cpln.io/org/{org}/secret/{name} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "$drop": [
    "description"
  ],
  "name": "<string>",
  "description": "<string>",
  "tags": {},
  "$replace/tags": {},
  "type": "opaque",
  "$replace/data": {
    "payload": "<string>",
    "encoding": "plain"
  },
  "data": {
    "$drop": [
      "payload"
    ],
    "payload": "<string>",
    "encoding": "plain"
  }
}
'
{
  "id": "<string>",
  "name": "<string>",
  "kind": "<string>",
  "version": 123,
  "description": "<string>",
  "tags": {},
  "created": "2023-11-07T05:31:56Z",
  "lastModified": "2023-11-07T05:31:56Z",
  "links": [
    {
      "rel": "<string>",
      "href": "<string>"
    }
  ],
  "type": "opaque",
  "data": {
    "payload": "<string>",
    "encoding": "plain"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.controlplane.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

Service account key can be used as API keys

Path Parameters

org
string
required
name
string
required

Body

application/json
$drop
enum<string>[]
Available options:
description,
tags,
type,
data
name
string
Maximum string length: 64
description
string
Maximum string length: 250
tags
object
$replace/tags
object
type
enum<string>
Available options:
opaque,
tls,
gcp,
aws,
ecr,
userpass,
keypair,
azure-sdk,
azure-connector,
docker,
dictionary,
nats-account
$replace/data
data
object

Response

Success

id
string
read-only
name
string
Maximum string length: 64
kind
string
read-only
version
integer
read-only
description
string
Maximum string length: 250
tags
object
created
string<date-time>
read-only
lastModified
string<date-time>
read-only
type
enum<string>
Available options:
opaque,
tls,
gcp,
aws,
ecr,
userpass,
keypair,
azure-sdk,
azure-connector,
docker,
dictionary,
nats-account
data