Skip to content

Rename a connector or change its client label (dashboard session only)

PATCH
/connectors/{id}
curl --request PATCH \
--url https://api.krakenkey.io/connectors/example \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "name": "example", "clientLabel": {}, "scopes": [ "certs:read" ], "allowedCertIds": [ 1 ], "allowedDomainIds": [ "example" ] }'
id
required
string
Media typeapplication/json
object
name
string
>= 1 characters <= 64 characters
clientLabel

Null clears it

object
scopes

Replaces the scopes. Must include certs:read. Changing it revokes live keys.

Array<string>
Allowed values: certs:read certs:renew
allowedCertIds

Replaces the certificate restriction; [] or null clears it. At least one restriction must remain. Changing it revokes live keys.

Array<number>
nullable
allowedDomainIds

Replaces the domain restriction; [] or null clears it. At least one restriction must remain. Changing it revokes live keys.

Array<string>
nullable