---
title: "Changes to POST /v1alpha1/settings/issuer"
method: POST
path: "/v1alpha1/settings/issuer"
---

# Changes to POST /v1alpha1/settings/issuer

`POST /v1alpha1/settings/issuer`

> Every recorded change to this operation, newest first.
> 18 revisions in range; 7 not diffed.

## Timeline

Changed in 5 of 18 revisions.

- **2026-07-17** `1dc8f8328648`: 1 warning, 3 info
- **2026-01-26** `25adba52b633`: 1 warning, 3 info
- **2025-10-28** `639bf179b6bd`: 2 info
- **2025-10-27** `5c4ad1cb6f0c`: 1 warning, 3 info
- **2025-07-28** `63464ebf3f61`: 4 breaking, 8 warning, 8 info

## Changes

- **2026-07-17** `1dc8f8328648`: 1 warning, 3 info
  - added the new `IDP_TYPE_ENTRA_ID` enum value to the `idpType` response property for the response status `200`
  - added the new optional request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/entraIdpSettings`
  - added the new `IDP_TYPE_ENTRA_ID` enum value to the request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/idpType`
  - added the optional property `entraIdpSettings` to the response with the `200` status
- **2026-01-26** `25adba52b633`: 1 warning, 3 info
  - added the new `IDP_TYPE_PING` enum value to the `idpType` response property for the response status `200`
  - added the new optional request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/pingIdpSettings`
  - added the new `IDP_TYPE_PING` enum value to the request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/idpType`
  - added the optional property `pingIdpSettings` to the response with the `200` status
- **2025-10-28** `639bf179b6bd`: 2 info
  - added the optional property `createdAt` to the response with the `200` status
  - added the optional property `updatedAt` to the response with the `200` status
- **2025-10-27** `5c4ad1cb6f0c`: 1 warning, 3 info
  - added the new `IDP_TYPE_KEYCLOAK` enum value to the `idpType` response property for the response status `200`
  - added the new optional request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/keycloakIdpSettings`
  - added the new `IDP_TYPE_KEYCLOAK` enum value to the request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/idpType`
  - added the optional property `keycloakIdpSettings` to the response with the `200` status
- **2025-07-28** `63464ebf3f61`: 4 breaking, 8 warning, 8 info
  - removed the enum value `IDP_TYPE_ENTRA_ID` of the request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/idpType`
  - removed the enum value `IDP_TYPE_KEYCLOAK` of the request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/idpType`
  - removed the enum value `IDP_TYPE_PING` of the request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/idpType`
  - the response property `idpType` became optional for the status `200`
  - removed the request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/entraIdpSettings`
  - removed the request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/keycloakIdpSettings`
  - removed the request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/pingIdpSettings`
  - removed the optional property `createdAt` from the response with the `200` status
  - removed the optional property `entraIdpSettings` from the response with the `200` status
  - removed the optional property `keycloakIdpSettings` from the response with the `200` status
  - removed the optional property `pingIdpSettings` from the response with the `200` status
  - removed the optional property `updatedAt` from the response with the `200` status
  - added the new optional request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/keyId`
  - the request optional property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/issuerId` became not read-only
  - the request property `issuerSettings/allOf[#/components/schemas/IssuerSettings]/idpType` became optional
  - added the optional property `keyId` to the response with the `200` status
  - the response optional property `issuerId` became not read-only for the status `200`
  - removed the `IDP_TYPE_ENTRA_ID` enum value from the `idpType` response property for the response status `200`
  - removed the `IDP_TYPE_KEYCLOAK` enum value from the `idpType` response property for the response status `200`
  - removed the `IDP_TYPE_PING` enum value from the `idpType` response property for the response status `200`

---

[Operation](https://skmtc.dev/agntcy/apis/agntcy-identity-service-api/docs/v1alpha1/settings/issuer/post.md) - [API](https://skmtc.dev/agntcy/apis/agntcy-identity-service-api.md) - [Page](https://skmtc.dev/agntcy/apis/agntcy-identity-service-api/changes/v1alpha1/settings/issuer/post)