KeySets

Upsert a KeySet

Create or Update KeySet using ID or name.

put/{workspace}/key-sets/{KeySetIdOrName}

Path parameters

workspacestring required

Example:team-payments

The name of the workspace

Request body

created_atinteger nullable

Unix epoch when the resource was created.

idstring nullable

A string representing a UUID (universally unique identifier).

namestring nullable

The name to associate with the given key-set.

tagsstring[] nullable

A set of strings representing tags.

updated_atinteger nullable

Unix epoch when the resource was last updated.

Example request

{
  "id": "b58c7d9d-e54f-444c-b24d-cdfc4159f61e",
  "name": "example-key-set",
  "tags": [
    "idp-keys"
  ]
}

Response

Successfully upserted KeySet

created_atinteger nullable

Unix epoch when the resource was created.

idstring nullable

A string representing a UUID (universally unique identifier).

namestring nullable

The name to associate with the given key-set.

tagsstring[] nullable

A set of strings representing tags.

updated_atinteger nullable

Unix epoch when the resource was last updated.

Example response

{
  "id": "b58c7d9d-e54f-444c-b24d-cdfc4159f61e",
  "name": "example-key-set",
  "tags": [
    "idp-keys"
  ]
}

Changes

Changed in 1 of the 11 revisions of this API.1

Oct 9, 2025740b73588ef41See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 11 revisions, 1 has no diff computed.