Import SAML provider metadata.

POST

/api/admin/saml-providers/{id}/import-metadata

Code sample: Shell / cURL

curl --request POST \
  --url https://auth.example.com/api/admin/saml-providers/example/import-metadata \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "metadataUrl": "https://idp.example.com/metadata.xml" }'

Imports single-entity SAML metadata into an existing provider, preserving custom settings while updating metadata-derived configuration and refresh status.

Authorizations

• adminBearer
• adminSessionCookie

Parameters

Path Parameters

id

required

string

SAML provider id.

Request Body ^required

Media type application/json

object

metadataXml

string

metadataUrl

string format: uri

samlProfile

string

attributePresetId

string

Example

{
  "metadataUrl": "https://idp.example.com/metadata.xml"
}

Responses

200

Successful JSON response.

Media type application/json

object

success

required

boolean

config

required

object

entityId

string

ssoUrl

string format: uri

acsUrl

string format: uri

certificate

string

metadataUrl

string format: uri

metadataXml

string

nameIdFormat

string

metadataNameIdFormats

Array<string>

key

additional properties

enabled

required

boolean

metadataRefreshStatus

required

object

key

additional properties

Example

{
  "success": true,
  "config": {
    "entityId": "https://idp.example.com/metadata"
  },
  "enabled": true,
  "metadataRefreshStatus": {
    "diff": {
      "changed": true
    }
  }
}