GRgranola

List legal hold custodians

Changed on

Lists the users a hold names, oldest first. Removed custodians are returned alongside active ones, each carrying removed_at.

get/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

Query parameters

cursorstring

The cursor to continue from

Example:eyJjcmVkZW50aWFsfQ==
page_sizeinteger

Maximum number of custodians to return per page

Example:10

Response

List of custodians

hasMoreboolean required

Whether there are more custodians to fetch. A page can hold fewer than page_size custodians and still not be the last one, so page on this and cursor.

cursorstring nullable required

The cursor to continue from

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