Skip to main content

Tag Multiple Objects

POST 

https://sailpoint.api.identitynow.com/v2025/tagged-objects/bulk-add

This API adds tags to multiple objects.

Request

Bodyrequired

Supported object types are ACCESS_PROFILE, APPLICATION, CAMPAIGN, ENTITLEMENT, IDENTITY, ROLE, SOD_POLICY, SOURCE.

    objectRefs object[]
  • Array [
  • typestring

    DTO type

    Possible values: [ACCESS_PROFILE, APPLICATION, CAMPAIGN, ENTITLEMENT, IDENTITY, ROLE, SOD_POLICY, SOURCE]

    Example: IDENTITY
    idstring

    ID of the object this reference applies to

    Example: 2c91808568c529c60168cca6f90c1313
    namestringnullable

    Human-readable display name of the object this reference applies to

    Example: William Wilson
  • ]
  • tagsstring[]

    Label to be applied to an Object

    Example: ["BU_FINANCE","PCI"]
    operationstring

    If APPEND, tags are appended to the list of tags for the object. A 400 error is returned if this would add duplicate tags to the object.

    If MERGE, tags are merged with the existing tags. Duplicate tags are silently ignored.

    Possible values: [APPEND, MERGE]

    Default value: APPEND
    Example: MERGE

Responses

Request succeeded.

Schema
  • Array [
  • objectRefs object[]
  • Array [
  • typestring

    DTO type

    Possible values: [ACCESS_PROFILE, APPLICATION, CAMPAIGN, ENTITLEMENT, IDENTITY, ROLE, SOD_POLICY, SOURCE]

    Example: IDENTITY
    idstring

    ID of the object this reference applies to

    Example: 2c91808568c529c60168cca6f90c1313
    namestringnullable

    Human-readable display name of the object this reference applies to

    Example: William Wilson
  • ]
  • tagsstring[]

    Label to be applied to an Object

    Example: ["BU_FINANCE","PCI"]
  • ]

Authorization: oauth2

type: Personal Access Token
scopes: idn:tag:manage
user levels: ORG_ADMIN, CERT_ADMIN, REPORT_ADMIN, ROLE_ADMIN, ROLE_SUBADMIN, SOURCE_ADMIN, SOURCE_SUBADMIN

type: Client Credentials
scopes: idn:tag:manage
package main

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

func main() {

url := "https://sailpoint.api.identitynow.com/v2025/tagged-objects/bulk-add"
method := "POST"

payload := strings.NewReader(`{
"objectRefs": [
{
"type": "IDENTITY",
"id": "2c91808568c529c60168cca6f90c1313",
"name": "William Wilson"
}
],
"tags": [
"BU_FINANCE",
"PCI"
],
"operation": "MERGE"
}`)

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/v2025
Auth
Body required
{
  "objectRefs": [
    {
      "type": "IDENTITY",
      "id": "2c91808568c529c60168cca6f90c1313",
      "name": "William Wilson"
    }
  ],
  "tags": [
    "BU_FINANCE",
    "PCI"
  ],
  "operation": "MERGE"
}
ResponseClear

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