ACLs3

Add-Ons4

API4

API Documentation4

API Implementation3

API Product Documentation4

API Product Version Specification4

API Product Versions4

API Products4

API Publication3

API Specification4

API Version4

API-keys3

App Auth Strategies4

Application Registrations4

Applications4

Assets4

Audit Logs7

Auth Server4

Auth Server Claims4

Auth Server Clients8

Auth Server Scopes4

Auth Settings9

Basic-auth credentials3

CA Certificates4

Catalog Services4

Centrally Managed Consumers4

Centrally Managed Keys3

Certificates4

Cloned Plugins4

CMEK3

Config Store Secrets4

Config Stores4

Consumer Groups6

Consumers4

Control Plane Groups2

Control Planes6

Custom Domains3

Custom Plugin Schemas4

CustomPlugins4

Data-Plane Group Configurations2

DCR Providers4

DP Certificates4

Event Gateway Backend Clusters4

Event Gateway DataPlane Certificates4

Event Gateway Listener Policies8

Event Gateway Listeners4

Event Gateway Schema Registries4

Event Gateway Static Keys3

Event Gateway TLS Trust Bundles4

Event Gateway Virtual Cluster Consume Policies20

Event Gateway Virtual Cluster Policies4

Event Gateway Virtual Cluster Produce Policies16

Event Gateway Virtual Clusters4

Event Gateways4

GraphQL Cost Decorations1

HMAC-auth credentials3

Integration Instance Auth Config3

Integration Instance Auth Credentials3

Integration Instances4

JWTs3

Keys4

KeySets4

Mesh5

MTLS-auth credentials3

Networks5

Pages4

Partials4

Personal Access Tokens2

Platform IPs1

Plugins449

Portal Appearance2

Portal Audit Logs3

Portal Auth Settings9

Portal Custom Domains4

Portal Customization2

Portal Developers4

Portal Product Versions3

Portal Team Roles2

Portal Teams4

Portals10

Portals IP Allow List4

Private DNS3

Provider Accounts1

Realms4

Roles6

Routes8

Serverless Cloud Gateways3

Services4

Snippets4

SNIs4

System Accounts5

System Accounts - Access Tokens4

System Accounts - Roles3

System Accounts - Team Membership2

Targets3

Team Membership2

Teams5

Transit Gateways4

Upstreams4

Vaults4

patchReset Auth Settings

KeySets

Upsert a KeySet

Create or Update KeySet using ID or name.

put/v2/control-planes/{controlPlaneId}/core-entities/key-sets/{KeySetId}

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 5 of the 52 revisions of this API.713

Jul 22, 20252c77aeaee5fb11See the full diff
- ▲
  the response property tags became nullable for the status 200
  response-property-became-nullable
- ○
  the request property tags became nullable
  request-property-became-nullable
Jun 27, 20259f695af251021See the full diff
- ○
  request body became optional
  request-body-became-optional
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 15, 2025fc6abbc537f326See the full diff
- ▲
  the response property created_at became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property updated_at became nullable for the status 200
  response-property-became-nullable
- ○
  the request optional property created_at became not read-only
  request-optional-property-became-not-read-only
- ○
  the request optional property updated_at became not read-only
  request-optional-property-became-not-read-only
- ○
  the request property created_at became nullable
  request-property-became-nullable
- ○
  the request property updated_at became nullable
  request-property-became-nullable
- ○
  the response optional property created_at became not read-only for the status 200
  response-optional-property-became-not-read-only
- ○
  the response optional property updated_at became not read-only for the status 200
  response-optional-property-became-not-read-only
This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Dec 6, 20244266633316551See the full diff
- ▲
  the request property tags became not nullable
  request-property-became-not-nullable
Nov 11, 202408ead66e9ebb35See the full diff
- ▲
  the response property id became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property name became nullable for the status 200
  response-property-became-nullable
- ▲
  the response property tags became nullable for the status 200
  response-property-became-nullable
- ○
  the request optional property id became not read-only
  request-optional-property-became-not-read-only
- ○
  the request property id became nullable
  request-property-became-nullable
- ○
  the request property name became nullable
  request-property-became-nullable
- ○
  the request property tags became nullable
  request-property-became-nullable
- ○
  the response optional property id became not read-only for the status 200
  response-optional-property-became-not-read-only
This revision also has 88 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog