Update an issuer's configuration
GENERATED — DO NOT EDIT DIRECTLY. Produced from the canonical OpenAPI specification by
developer-docs/tools/generate-reference.mjs. Edits are overwritten on the next run.
PATCH
/management/issuers/{issuerId}Scope: issuers.manage. Only the fields you supply change. Quote the ETag from a previous read in If-Match to detect a concurrent update — a stale tag returns 412 rather than overwriting. Omitting If-Match is an unconditional update. On the /v1.0 and /v1 compatibility routes, supply rowVersion in the body instead, which returns 409. Authenticate with Authorization: ApiKey {key}. Every response carries x-ms-request-id, X-Correlation-Id and X-Request-Id; quote the request id in any support request.
| Operation ID | Issuers_Update |
| Plane | Management |
| Versioning | ?api-version=2026-08-30 |
| Authentication | Authorization: ApiKey {key} |
| Required scope | issuers.manage |
| Concurrency | If-Match supported; a stale tag returns 412 |
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
issuerId |
string |
Yes |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
api-version |
string |
Yes | Management API version. Supported: 2026-08-30. |
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
If-Match |
string |
No | Entity tag from a previous read of this resource. The update is rejected with 412 if the resource has changed since. Omitting it is an unconditional update. |
x-ms-client-request-id |
string |
No | Optional caller-supplied correlation value, echoed back on the response and recorded in diagnostics. It never influences authentication, tenant or environment selection, resource lookup or idempotency. |
Request body
Type: PublicIssuerConfigurationRequest
| Field | Type | Required | Description |
|---|---|---|---|
canonicalIssuerUri |
string, nullable |
No | |
displayName |
string, nullable |
No | |
metadataSourceType |
string, nullable |
No | |
publicMetadataUri |
string, nullable |
No | |
requireHolderBinding |
boolean, nullable |
No | |
rowVersion |
string, nullable |
No | |
statusMechanism |
string, nullable |
No | |
trustProfileVersion |
string, nullable |
No |
Responses
| Status | Body | Meaning |
|---|---|---|
200 |
ManagementResourceOfPublicIssuerResponse |
Success. |
400 |
ErrorEnvelope |
The request was not valid. See error model. |
401 |
ErrorEnvelope |
Authentication failed — the API key is missing, malformed, revoked or expired. |
403 |
ErrorEnvelope |
Authenticated, but the key does not carry the required scope. |
404 |
ErrorEnvelope |
Not visible to this caller. A resource in another tenant or environment reports as not found. |
409 |
ErrorEnvelope |
The request conflicts with the resource state, or an idempotency key was reused with a different payload. |
412 |
ErrorEnvelope |
The If-Match entity tag was stale. Re-read the resource and retry. |
429 |
ErrorEnvelope |
Throttled. See rate limits. |
Response headers: ETag, x-ms-request-id
Example
curl -X PATCH "https://api.example.diligence.id/management/issuers/YOUR_ISSUER_ID?api-version=2026-08-30" \
-H "Authorization: ApiKey YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ }'