Skip to main content

Update Scheduled Action

PATCH 

https://sailpoint.api.identitynow.com/v2025/configuration-hub/scheduled-actions/:id

This API updates an existing scheduled action using JSON Patch format.

Request

Path Parameters

    scheduledActionId stringrequired

    The ID of the scheduled action.

    Example: 0f11f2a4-7c94-4bf3-a2bd-742580fe3bde

Bodyrequired

The JSON Patch document containing the changes to apply to the scheduled action.

    operations object[]

    Operations to be applied

  • Array [
  • opstringrequired

    The operation to be performed

    Possible values: [add, remove, replace, move, copy, test]

    Example: replace
    pathstringrequired

    A string JSON Pointer representing the target path to an element to be affected by the operation

    Example: /description
    value object

    The value to be used for the operation, required for "add" and "replace" operations

    oneOf
    string
    Example: New description
  • ]

Responses

The updated scheduled action.

Schema
    idstring

    Unique identifier for this scheduled action.

    Example: 3469b87d-48ca-439a-868f-2160001da8c1
    createddate-time

    The time when this scheduled action was created.

    Example: 2021-05-11T22:23:16.000Z
    jobTypestring

    Type of the scheduled job.

    Possible values: [BACKUP, CREATE_DRAFT, CONFIG_DEPLOY_DRAFT]

    Example: BACKUP
    content object

    Content details for the scheduled action.

    namestring

    Name of the scheduled action (maximum 50 characters).

    Possible values: <= 50 characters

    Example: Daily Backup
    backupOptions object

    Options for BACKUP type jobs. Optional, applicable for BACKUP jobs only.

    includeTypesstring[]

    Object types that are to be included in the backup.

    Example: ["ROLE","IDENTITY_PROFILE"]
    objectOptions object

    Map of objectType string to the options to be passed to the target service for that objectType.

    property name* object
    includedNamesstring[]

    Set of names to be included.

    Example: ["Admin Role","User Role"]
    sourceBackupIdstring

    ID of the source backup. Required for CREATE_DRAFT jobs only.

    Example: 5678b87d-48ca-439a-868f-2160001da8c2
    sourceTenantstring

    Source tenant identifier. Required for CREATE_DRAFT jobs only.

    Example: tenant-name
    draftIdstring

    ID of the draft to be deployed. Required for CONFIG_DEPLOY_DRAFT jobs only.

    Example: 9012b87d-48ca-439a-868f-2160001da8c3
    startTimedate-time

    The time when this scheduled action should start.

    Example: 2021-05-12T10:00:00.000Z
    cronStringstring

    Cron expression defining the schedule for this action.

    Example: 0 0 12 * * ?
    timeZoneIdstring

    Time zone ID for interpreting the cron expression.

    Example: America/Chicago

Authorization: oauth2

type: Personal Access Token
scopes: sp:config-scheduled-action:manage
user levels: ORG_ADMIN
package main

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

func main() {

url := "https://sailpoint.api.identitynow.com/v2025/configuration-hub/scheduled-actions/:id"
method := "PATCH"

payload := strings.NewReader(`{
"operations": [
{
"op": "replace",
"path": "/description",
"value": "New description"
}
]
}`)

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

if err != nil {
fmt.Println(err)
return
}
req.Header.Add("Content-Type", "application/json-patch+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
{
  "operations": [
    {
      "op": "replace",
      "path": "/description",
      "value": "New description"
    }
  ]
}
ResponseClear

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