Skip to main content

Update a Machine Identity

PATCH 

https://sailpoint.api.identitynow.com/v2025/machine-identities/:id

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.

Use this API to update machine identity details.

Request

Path Parameters

    id stringrequired

    Machine Identity ID.

    Example: ef38f94347e94562b5bb8424a56397d8

Header Parameters

    X-SailPoint-Experimental stringrequired

    Use this header to enable this experimental API.

    Default value: true
    Example: true

Body arrayrequired

A JSON of updated values JSON Patch standard.

  • Array [
  • object
  • ]

Responses

Updated Machine Identity object.

Schema
    idstring

    System-generated unique ID of the Object

    Example: id12345
    namestringnullablerequired

    Name of the Object

    Example: aName
    createddate-time

    Creation date of the Object

    Example: 2015-05-28T14:07:17Z
    modifieddate-time

    Last modification date of the Object

    Example: 2015-05-28T14:07:17Z
    businessApplicationstringrequired

    The business application that the identity represents

    Example: ADService
    descriptionstring

    Description of machine identity

    Example:
    manuallyEditedboolean

    Indicates if the machine identity has been manually edited

    Default value: false
    Example: true
    attributesobject

    A map of custom machine identity attributes

    Example: {"Region":"EU"}

Authorization: oauth2

type: Personal Access Token
scopes: idn:mis-identity:manage
user levels: ORG_ADMIN

Request Collapse all
Base URL
https://sailpoint.api.identitynow.com/v2025
Auth
Parameters
— pathrequired
— headerrequired
Body required
[
  {}
]
ResponseClear

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