NHI Identity Owners

Replace the owners of an identity

Changed on

Replace the owners of a non-human identity with the given list. Owners not in the list are removed, and missing owners are added. An empty list removes all the owners of the identity.

An identity can have at most 5 owners.

The API token must have the Manager access level or above, or be a service account token.

put/v1/nhi/identities/{identity_id}/owners/update

Request

  • Base URL
    https://api.gitguardian.com
  • URL
    https://api.gitguardian.com/v1/nhi/identities/{identity_id}/owners/update
  • Auth
    HTTP bearer

Path parameters

identity_idinteger required

The id of the non-human identity

Request body

Example request

{
  "owners": [
    {
      "email": "jane.doe@example.com"
    }
  ]
}

Response

Owners were replaced.

Example response

{
  "owners": [
    {
      "id": 42,
      "email": "jane.doe@example.com",
      "user_id": 7,
      "confidence": 1
    }
  ]
}

Changes