Skip to main content
Issuer configuration

Update issuer configuration

PATCH/v4/config/ows/issuer/configuration

Changes the issuer configuration of the organisation with a JSON Merge Patch (RFC 7396) of configuration. The settings apply at once to each request of each credential definition. An organisation has one issuer configuration, so the path has no id.

Send only the members to change, without the configuration wrapper: a member that you leave out keeps its value, null puts the default back (of each field, for an object), and an array replaces the stored array. The content type is application/json or application/merge-patch+json. A patch with dpop.required: true and no dpop.enabled also turns DPoP on; dpop.enabled: false also turns dpop.required off. Signed metadata needs a signing key of the organisation, and the format x509 needs a key with a certificate chain. Set the default images with the logo and cover image calls of the issuer configuration.

Authorizations

  • Authorizationstringheaderrequired

    Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.

    Scope:wallet:update

Body

application/json

The members to change, as a JSON Merge Patch of configuration.

  • credentialIssuerobject | null
  • authorisationServerobject | null
  • definitionDefaultsobject | null

    The defaults of a new credential definition. The issuer applies only validitySeconds; a client (for example the dashboard) puts display and cryptographicBindingMethods in a new credential definition.

Response

application/json

The issuer configuration after the change, in the shape of the read call.

  • signingKeyWarningsstring[]

    The warnings of the signing key, for a key whose certificate preset this use does not accept (also a key with no certificate preset): one text for each rule of this use that its certificate does not fit. Always present; an empty list when there is no warning. The save is not refused.

  • configurationobject

    The issuer configuration of the organisation, in three groups. Each field is in the group of the protocol part that shows it or uses it. credentialIssuer: the Credential Issuer Metadata and the credential, deferred credential, nonce and notification endpoints. authorisationServer: the Authorization Server Metadata and the authorize, PAR, IAR and token endpoints of the two authorisation servers of the organisation. definitionDefaults: the defaults of a new credential definition. A field shows the value that applies: the stored value, else its default.

  • limitsobject

    The rule of each numeric field, keyed by the path of the field in configuration, for example authorisationServer.accessToken.lifetimeSeconds.