Skip to main content

Reassign Certifications

POST 

https://sailpoint.api.identitynow.com/v2025/campaigns/:id/reassign

This API reassigns the specified certifications from one identity to another.

Request

Path Parameters

    id stringrequired

    The certification campaign ID

    Example: ef38f94347e94562b5bb8424a56397d8

Bodyrequired

    certificationIdsstring[]

    List of certification IDs to reassign

    Possible values: >= 1, <= 250

    Example: ["af3859464779471211bb8424a563abc1","af3859464779471211bb8424a563abc2","af3859464779471211bb8424a563abc3"]
    reassignTo object
    idstring

    The identity ID to which the review is being assigned.

    Example: ef38f94347e94562b5bb8424a56397d8
    typestring

    The type of the ID provided.

    Possible values: [IDENTITY]

    Example: IDENTITY
    reasonstring

    Comment to explain why the certification was reassigned

    Example: reassigned for some reason

Responses

The reassign task that has been submitted.

Schema
    idstring

    The ID of the certification task.

    Example: 2c918086719eec070171a7e3355a360a
    typestring

    The type of the certification task. More values may be added in the future.

    Possible values: [REASSIGN, ADMIN_REASSIGN, COMPLETE_CERTIFICATION, FINISH_CERTIFICATION, COMPLETE_CAMPAIGN, ACTIVATE_CAMPAIGN, CAMPAIGN_CREATE, CAMPAIGN_DELETE]

    Example: ADMIN_REASSIGN
    targetTypestring

    The type of item that is being operated on by this task whose ID is stored in the targetId field.

    Possible values: [CERTIFICATION, CAMPAIGN]

    Example: CAMPAIGN
    targetIdstring

    The ID of the item being operated on by this task.

    Example: 2c918086719eec070171a7e3355a834c
    statusstring

    The status of the task.

    Possible values: [QUEUED, IN_PROGRESS, SUCCESS, ERROR]

    Example: QUEUED
    errors object[]

    List of error messages

  • Array [
  • localestringnullable

    The locale for the message text, a BCP 47 language tag.

    Example: en-US
    localeOriginstringnullable

    An indicator of how the locale was selected. DEFAULT means the locale is the system default. REQUEST means the locale was selected from the request context (i.e., best match based on the Accept-Language header). Additional values may be added in the future without notice.

    Possible values: [DEFAULT, REQUEST, null]

    Example: DEFAULT
    textstring

    Actual text of the error message in the indicated locale.

    Example: The request was syntactically correct but its content is semantically invalid.
  • ]
  • reassignmentTrailDTOs object[]

    Reassignment trails that lead to self certification identity

  • Array [
  • previousOwnerstring

    The ID of previous owner identity.

    Example: ef38f94347e94562b5bb8424a56397d8
    newOwnerstring

    The ID of new owner identity.

    Example: ef38f94347e94562b5bb8424a56397a3
    reassignmentTypestring

    The type of reassignment.

    Example: AUTOMATIC_REASSIGNMENT
  • ]
  • createddate-time

    The date and time on which this task was created.

    Example: 2020-09-24T18:10:47.693Z

Authorization: oauth2

type: Personal Access Token
scopes: idn:campaign:manage
user levels: ORG_ADMIN, CERT_ADMIN
package main

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

func main() {

url := "https://sailpoint.api.identitynow.com/v2025/campaigns/:id/reassign"
method := "POST"

payload := strings.NewReader(`{
"certificationIds": [
"af3859464779471211bb8424a563abc1",
"af3859464779471211bb8424a563abc2",
"af3859464779471211bb8424a563abc3"
],
"reassignTo": {
"id": "ef38f94347e94562b5bb8424a56397d8",
"type": "IDENTITY"
},
"reason": "reassigned for some reason"
}`)

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
Parameters
— pathrequired
Body required
{
  "certificationIds": [
    "af3859464779471211bb8424a563abc1",
    "af3859464779471211bb8424a563abc2",
    "af3859464779471211bb8424a563abc3"
  ],
  "reassignTo": {
    "id": "ef38f94347e94562b5bb8424a56397d8",
    "type": "IDENTITY"
  },
  "reason": "reassigned for some reason"
}
ResponseClear

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