Skip to main content

Forward a Work Item

POST 

https://sailpoint.api.identitynow.com/v2024/work-items/:id/forward

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 API forwards a work item to a new owner. Either an admin, or the owning/current user must make this request.

Request

Path Parameters

    id stringrequired

    The ID of the work item

    Example: ef38f94347e94562b5bb8424a56397d8

Header Parameters

    X-SailPoint-Experimental stringrequired

    Use this header to enable this experimental API.

    Default value: true
    Example: true

Bodyrequired

    targetOwnerIdstringrequired

    The ID of the identity to forward this work item to.

    Example: 2c9180835d2e5168015d32f890ca1581
    commentstringrequired

    Comments to send to the target owner

    Example: I'm going on vacation.
    sendNotificationsboolean

    If true, send a notification to the target owner.

    Default value: true
    Example: true

Responses

Success, but no data is returned.

Authorization: oauth2

type: Personal Access Token
scopes: sp:scopes:all
package main

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

func main() {

url := "https://sailpoint.api.identitynow.com/v2024/work-items/:id/forward"
method := "POST"

payload := strings.NewReader(`{
"targetOwnerId": "2c9180835d2e5168015d32f890ca1581",
"comment": "I'm going on vacation.",
"sendNotifications": 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("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/v2024
Auth
Parameters
— pathrequired
— headerrequired
Body required
{
  "targetOwnerId": "2c9180835d2e5168015d32f890ca1581",
  "comment": "I'm going on vacation.",
  "sendNotifications": true
}
ResponseClear

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