Initiates configuration objects import job

POST 
/sp-config/import

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 post will import objects from a JSON configuration file into
\ a tenant. By default, every import will first export all existing objects supported
\ by sp-config as a backup before the import is attempted. The backup is provided
\ so that the state of the configuration prior to the import is available for
\ inspection or restore if needed. The backup can be skipped by setting "excludeBackup"
\ to true in the import options. If a backup is performed, the id of the backup
\ will be provided in the ImportResult as the "exportJobId". This can be downloaded
\ using the /sp-config/export/{exportJobId}/download endpoint.\nYou cannot currently
\ import from the Non-Employee Lifecycle Management (NELM) source. You cannot
\ use this endpoint to back up or store NELM data. \nFor more information about
\ the object types that currently support import functionality, refer to SaaS
\ Configuration."

Request

Responses

202

Import job accepted and queued for processing.

400

Client Error - Returned if the request body is invalid.

401

Unauthorized - Returned if there is no authorization header, or if the JWT token is expired.

403

Forbidden - Returned if the user you are running as, doesn't have access to this end-point.

404

Not Found - returned if the request URL refers to a resource or object that does not exist

429

Too Many Requests - Returned in response to too many requests in a given period of time - rate limited. The Retry-After header in the response includes how long to wait before trying again.

500

Internal Server Error - Returned if there is an unexpected error.