Sign in
instance

Refresh and explicitly confirm a SAML provider's metadata diff.

Changed on

Performs one URL fetch for URL-backed providers. Any new endpoint, assertion-signing certificate or metadata-signing fingerprint remains refused until named in confirmed_fingerprints and committed through this action. File-backed providers supply the replacement document.

post/api/v1/instance/saml-providers/{slug}/refresh-metadata

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/instance/saml-providers/{slug}/refresh-metadata
  • Auth: HTTP bearer

Request body

metadata_documentstring nullable

Replacement XML for a file-backed provider; absent for URL-backed providers.

confirmed_fingerprintsstring[]
confirmed_endpointsstring[]

Response

Applied provider or metadata diff requiring explicit confirmation.

appliedboolean required
required_fingerprintsstring[] required
required_endpointsstring[] required

Changes

  • f24ca8785e72Revision changes
    • info

      added the required property / to the response with the status

    • info

      added the required property / to the response with the status

  • 54b2780eec85Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status