GRgranola

Add legal hold custodians

Changed on

Names users on a hold, by email or by Granola user id. Idempotent: the response carries the request's full resolved set, whether each entry was newly added or already present.

post/v1/legal-holds/{hold_id}/custodians

Request

  • Base URL
    https://public-api.granola.ai
  • Auth
    HTTP bearer

Path parameters

hold_idstring required

The legal hold id. Case-insensitive.

Example:lgh_Abc123XyZ456De

Request body

Example request

{
  "custodians": [
    {
      "email": "person@example.com",
      "id": "usr_9Kd2mPq7Rt4Xyz"
    }
  ]
}

Response

The custodians named in the request

Example response

{
  "custodians": [
    {
      "id": "lhc_7Yt3nBv8Wq2Lms",
      "object": "legal_hold_custodian",
      "user": {
        "object": "user",
        "id": "usr_9Kd2mPq7Rt4Xyz",
        "email": "person@example.com"
      },
      "added_at": "2026-09-21T10:00:00Z"
    }
  ]
}

Changes

  • 480617fbc624Revision changes
    • warning

      changed the pattern of the path request parameter hold_id from ^lgh_[a-zA-Z0-9]{14}$ to ^[Ll][Gg][Hh]_[a-zA-Z0-9]{14}$

    • warning

      changed the pattern of the request property // from ^usr_[a-zA-Z0-9]{14}$ to ^[Uu][Ss][Rr]_[a-zA-Z0-9]{14}$

  • 58997a2621d6Revision changes
    • info

      endpoint added