Skip to main content

Import Identity Profiles

POST 

https://sailpoint.api.identitynow.com/v3/identity-profiles/import

This imports previously exported identity profiles.

Request

Body arrayrequired

Previously exported Identity Profiles.

  • Array [
  • versionint32

    Version or object from the target service.

    Example: 1
    self object

    Self block for exported object.

    typestring

    Exported object's DTO type.

    Possible values: [ACCESS_PROFILE, ACCESS_REQUEST_CONFIG, ATTR_SYNC_SOURCE_CONFIG, AUTH_ORG, CAMPAIGN_FILTER, FORM_DEFINITION, GOVERNANCE_GROUP, IDENTITY_OBJECT_CONFIG, IDENTITY_PROFILE, LIFECYCLE_STATE, NOTIFICATION_TEMPLATE, PASSWORD_POLICY, PASSWORD_SYNC_GROUP, PUBLIC_IDENTITIES_CONFIG, ROLE, RULE, SEGMENT, SERVICE_DESK_INTEGRATION, SOD_POLICY, SOURCE, TAG, TRANSFORM, TRIGGER_SUBSCRIPTION, WORKFLOW]

    Example: SOURCE
    idstring

    Exported object's ID.

    Example: 2c9180835d191a86015d28455b4b232a
    namestring

    Exported object's display name.

    Example: HR Active Directory
    object object
    namestringnullablerequired

    Name of the Object

    Example: aName
    descriptionstringnullable

    Identity profile's description.

    Example: My custom flat file profile
    owner objectnullable

    Identity profile's owner.

    typestring

    Owner's object type.

    Possible values: [IDENTITY]

    Example: IDENTITY
    idstring

    Owner's ID.

    Example: 2c9180835d191a86015d28455b4b232a
    namestring

    Owner's name.

    Example: William Wilson
    priorityint64

    Identity profile's priority.

    Example: 10
    authoritativeSource objectrequired
    typestring

    Authoritative source's object type.

    Possible values: [SOURCE]

    Example: SOURCE
    idstring

    Authoritative source's ID.

    Example: 2c9180835d191a86015d28455b4b232a
    namestring

    Authoritative source's name.

    Example: HR Active Directory
    identityRefreshRequiredboolean

    Set this value to 'True' if an identity refresh is necessary. You would typically want to trigger an identity refresh when a change has been made on the source.

    Default value: false
    Example: true
    identityCountint32

    Number of identities belonging to the identity profile.

    Example: 8
    identityAttributeConfig object

    Defines all the identity attribute mapping configurations. This defines how to generate or collect data for each identity attributes in identity refresh process.

    enabledboolean

    Backend will only promote values if the profile/mapping is enabled.

    Default value: false
    Example: true
    attributeTransforms object[]
  • Array [
  • identityAttributeNamestring

    Identity attribute's name.

    Example: email
    transformDefinition object
    typestring

    Transform definition type.

    Example: accountAttribute
    attributes object

    Arbitrary key-value pairs to store any metadata for the object

    property name*any

    Arbitrary key-value pairs to store any metadata for the object

    Example: {"attributeName":"e-mail","sourceName":"MySource","sourceId":"2c9180877a826e68017a8c0b03da1a53"}
  • ]
  • identityExceptionReportReference objectnullable
    taskResultIduuid

    Task result ID.

    Example: 2b838de9-db9b-abcf-e646-d4f274ad4238
    reportNamestring

    Report name.

    Example: My annual report
    hasTimeBasedAttrboolean

    Indicates the value of requiresPeriodicRefresh attribute for the identity profile.

    Default value: false
    Example: true
  • ]

Responses

The result of importing Identity Profiles.

Schema
    infos object[]required

    Informational messages returned from the target service on import.

  • Array [
  • keystringrequired

    Message key.

    Example: UNKNOWN_REFERENCE_RESOLVER
    textstringrequired

    Message text.

    Example: Unable to resolve reference for object [type: IDENTITY, id: 2c91808c746e9c9601747d6507332ecz, name: random identity]
    details objectrequired

    Message details if any, in key:value pairs.

    property name*any

    Message details if any, in key:value pairs.

    Example: {"details":"message details"}
  • ]
  • warnings object[]required

    Warning messages returned from the target service on import.

  • Array [
  • keystringrequired

    Message key.

    Example: UNKNOWN_REFERENCE_RESOLVER
    textstringrequired

    Message text.

    Example: Unable to resolve reference for object [type: IDENTITY, id: 2c91808c746e9c9601747d6507332ecz, name: random identity]
    details objectrequired

    Message details if any, in key:value pairs.

    property name*any

    Message details if any, in key:value pairs.

    Example: {"details":"message details"}
  • ]
  • errors object[]required

    Error messages returned from the target service on import.

  • Array [
  • keystringrequired

    Message key.

    Example: UNKNOWN_REFERENCE_RESOLVER
    textstringrequired

    Message text.

    Example: Unable to resolve reference for object [type: IDENTITY, id: 2c91808c746e9c9601747d6507332ecz, name: random identity]
    details objectrequired

    Message details if any, in key:value pairs.

    property name*any

    Message details if any, in key:value pairs.

    Example: {"details":"message details"}
  • ]
  • importedObjects object[]required

    References to objects that were created or updated by the import.

  • Array [
  • typestring

    DTO type of object created or updated by import.

    Possible values: [CONNECTOR_RULE, IDENTITY_OBJECT_CONFIG, IDENTITY_PROFILE, RULE, SOURCE, TRANSFORM, TRIGGER_SUBSCRIPTION]

    Example: SOURCE
    idstring

    ID of object created or updated by import.

    Example: 2c9180835d191a86015d28455b4b232a
    namestring

    Display name of object created or updated by import.

    Example: HR Active Directory
  • ]

Authorization: oauth2

type: Personal Access Token
scopes: idn:identity-profile:manage
package main

import (
"fmt"
"strings"
"net/http"
"io"
)

func main() {

url := "https://sailpoint.api.identitynow.com/v3/identity-profiles/import"
method := "POST"

payload := strings.NewReader(`[
{
"version": 1,
"self": {
"type": "SOURCE",
"id": "2c9180835d191a86015d28455b4b232a",
"name": "HR Active Directory"
},
"object": {
"name": "aName",
"description": "My custom flat file profile",
"owner": {
"type": "IDENTITY",
"id": "2c9180835d191a86015d28455b4b232a",
"name": "William Wilson"
},
"priority": 10,
"authoritativeSource": {
"type": "SOURCE",
"id": "2c9180835d191a86015d28455b4b232a",
"name": "HR Active Directory"
},
"identityRefreshRequired": true,
"identityCount": 8,
"identityAttributeConfig": {
"enabled": true,
"attributeTransforms": [
{
"identityAttributeName": "email",
"transformDefinition": {
"type": "accountAttribute",
"attributes": {
"attributeName": "e-mail",
"sourceName": "MySource",
"sourceId": "2c9180877a826e68017a8c0b03da1a53"
}
}
}
]
},
"identityExceptionReportReference": {
"taskResultId": "2b838de9-db9b-abcf-e646-d4f274ad4238",
"reportName": "My annual report"
},
"hasTimeBasedAttr": true
}
}
]`)

client := &http.Client {
}
req, err := http.NewRequest(method, url, payload)

if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "application/json")
req.Header.Add("Accept", "application/json")
req.Header.Add("Authorization", "Bearer <TOKEN>")

res, err := client.Do(req)
if err != nil {
fmt.Println(err)
return
}
defer res.Body.Close()

body, err := io.ReadAll(res.Body)
if err != nil {
fmt.Println(err)
return
}
fmt.Println(string(body))
}
Request Collapse all
Base URL
https://sailpoint.api.identitynow.com/v3
Auth
Body required
[
  {
    "version": 1,
    "self": {
      "type": "SOURCE",
      "id": "2c9180835d191a86015d28455b4b232a",
      "name": "HR Active Directory"
    },
    "object": {
      "name": "aName",
      "description": "My custom flat file profile",
      "owner": {
        "type": "IDENTITY",
        "id": "2c9180835d191a86015d28455b4b232a",
        "name": "William Wilson"
      },
      "priority": 10,
      "authoritativeSource": {
        "type": "SOURCE",
        "id": "2c9180835d191a86015d28455b4b232a",
        "name": "HR Active Directory"
      },
      "identityRefreshRequired": true,
      "identityCount": 8,
      "identityAttributeConfig": {
        "enabled": true,
        "attributeTransforms": [
          {
            "identityAttributeName": "email",
            "transformDefinition": {
              "type": "accountAttribute",
              "attributes": {
                "attributeName": "e-mail",
                "sourceName": "MySource",
                "sourceId": "2c9180877a826e68017a8c0b03da1a53"
              }
            }
          }
        ]
      },
      "identityExceptionReportReference": {
        "taskResultId": "2b838de9-db9b-abcf-e646-d4f274ad4238",
        "reportName": "My annual report"
      },
      "hasTimeBasedAttr": true
    }
  }
]
ResponseClear

Click the Send API Request button above and see the response here!