Skip to main content

Entitlement Aggregation

POST 

https://sailpoint.api.identitynow.com/beta/sources/:sourceId/load-entitlements

Starts an entitlement aggregation on the specified source. If the target source is a delimited file source, then the CSV file needs to be included in the request body. You will also need to set the Content-Type header to multipart/form-data. A token with ORG_ADMIN, SOURCE_ADMIN, or SOURCE_SUBADMIN authority is required to call this API.

Request

Path Parameters

    sourceId stringrequired

    Source Id

    Example: ef38f94347e94562b5bb8424a56397d8

Body

    filebinary

    The CSV file containing the source entitlements to aggregate.

Responses

Aggregate Entitlements Task

Schema
    idstring

    System-generated unique ID of the task this taskStatus represents

    Example: ef38f94347e94562b5bb8424a56397d8
    typestring

    Type of task this task represents

    Example: QUARTZ
    uniqueNamestring

    The name of the task

    Example: Cloud Group Aggregation
    descriptionstring

    The description of the task

    Example: Aggregate from the specified application
    launcherstring

    The user who initiated the task

    Example: John Doe
    createddate-time

    The creation date of the task

    Example: 2020-07-11T21:23:15.000Z
    returns object[]

    Return values from the task

  • Array [
  • displayLabelstring

    The display label for the return value

    Example: TASK_OUT_ACCOUNT_GROUP_AGGREGATION_APPLICATIONS
    attributeNamestring

    The attribute name for the return value

    Example: applications
  • ]

Authorization: oauth2

type: Personal Access Token
scopes: idn:entitlements:manage
package main

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

func main() {

url := "https://sailpoint.api.identitynow.com/beta/sources/:sourceId/load-entitlements"
method := "POST"

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

if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "multipart/form-data")
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/beta
Auth
Parameters
— pathrequired
Body
The CSV file containing the source entitlements to aggregate.
ResponseClear

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