Skip to main content

Create Custom Password Instructions

POST 

/custom-password-instructions

experimental

This API is currently in an experimental state. The API is subject to change based on feedback and further testing. You must include the X-SailPoint-Experimental header and set it to true to use this endpoint.

This API creates the custom password instructions for the specified page ID.

Request

Header Parameters

    X-SailPoint-Experimental stringrequired

    Default value: true

    Use this header to enable this experimental API.

    Example: true

Body

required

    pageId string

    Possible values: [change-password:enter-password, change-password:finish, flow-selection:select, forget-username:user-email, mfa:enter-code, mfa:enter-kba, mfa:select, reset-password:enter-password, reset-password:enter-username, reset-password:finish, unlock-account:enter-username, unlock-account:finish]

    The page ID that represents the page for forget user name, reset password and unlock account flow.

    pageContent string

    The custom instructions for the specified page. Allow basic HTML format and maximum length is 1000 characters. The custom instructions will be sanitized to avoid attacks. If the customization text includes a link, like <A HREF="URL">... clicking on this will open the link on the current browser page. If you want your link to be redirected to a different page, please redirect it to "_blank" like this: <a href="URL" target="_blank" >link. This will open a new tab when the link is clicked. Notice we're only supporting _blank as the redirection target.

    locale string

    The locale for the custom instructions, a BCP47 language tag. The default value is "default".

Responses

Reference to the custom password instructions.

Schema

    pageId string

    Possible values: [change-password:enter-password, change-password:finish, flow-selection:select, forget-username:user-email, mfa:enter-code, mfa:enter-kba, mfa:select, reset-password:enter-password, reset-password:enter-username, reset-password:finish, unlock-account:enter-username, unlock-account:finish]

    The page ID that represents the page for forget user name, reset password and unlock account flow.

    pageContent string

    The custom instructions for the specified page. Allow basic HTML format and maximum length is 1000 characters. The custom instructions will be sanitized to avoid attacks. If the customization text includes a link, like <A HREF="URL">... clicking on this will open the link on the current browser page. If you want your link to be redirected to a different page, please redirect it to "_blank" like this: <a href="URL" target="_blank" >link. This will open a new tab when the link is clicked. Notice we're only supporting _blank as the redirection target.

    locale string

    The locale for the custom instructions, a BCP47 language tag. The default value is "default".

Loading...