Sign in
Secret Keys

Update a Secret Key

Update an existing Secret Key by its ID

post/secret-keys/{id}

Path parameters

idstring required

Request body

notestring

A user-provided note to help identify this secret key

permissionsstring[]

Permissions granted to this secret key, controlling which API operations it can perform

activeboolean

Whether the secret key is active

Example request

{
  "note": "Production backend key",
  "permissions": [
    "payment:read",
    "payment:create"
  ],
  "active": true
}

Response

OK

createdAtstring date-time required

The date and time when the entity was created.

updatedAtstring date-time nullable required

The date and time when the entity was last updated.

metadataobject nullable

Metadata used by merchants to store additional information about the entity.

idstring required

Unique identifier of the secret key

activeboolean required

Whether the secret key is active and can be used for API authentication

maskedValuestring required

Masked representation of the secret key, showing only the last four characters

notestring nullable required

User-provided note for identifying this secret key

permissionsstring[] required

Permissions of the secret key

Example response

{
  "createdAt": "2024-02-18T12:00:00Z",
  "updatedAt": "2024-02-21T12:15:00Z",
  "metadata": {
    "key1": "value1",
    "key2": "value2"
  },
  "id": "skey_2R6lBd1IxNUPqtsQLcJU2PFtyAD",
  "active": true,
  "maskedValue": "sk_****...a1b2",
  "note": "Production backend key",
  "permissions": [
    "payment:read",
    "payment:create"
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.