GRgranola

Create legal hold

Changed on

Places a named legal hold on custodians in your workspace. Granola preserves a custodian's notes, transcripts and attachments while any hold covering them is active. Custodians see no change in the product.

post/v1/legal-holds

Request

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

Request body

namestring required

A name for the matter this hold preserves

descriptionstring nullable

Free text describing the matter

covers_entire_workspaceboolean required

Whether the hold covers every member of your workspace, current and future. Required: scope is never something a caller falls into.

Example request

{
  "name": "X v. Y",
  "description": "Preservation notice 2026-08-12",
  "custodians": [
    {
      "email": "person@example.com",
      "id": "usr_9Kd2mPq7Rt4Xyz"
    }
  ]
}

Response

The legal hold that was created

idstring required

The unique identifier for the legal hold

object'legal_hold' required

The type of object

namestring required

The name of the hold, as your admins see it

descriptionstring nullable required

Free text describing the matter, or null

covers_entire_workspaceboolean required

True when the hold covers every member of your workspace, current and future. Additive with custodian_count — a hold may do both.

custodian_countinteger required

How many users this hold names individually. Workspace-wide coverage is covers_entire_workspace, not a custodian.

created_atstring date-time required

When the hold was placed

released_atstring date-time nullable required

When the hold was released, or null while it is active. A released hold is never deleted.

Example response

{
  "id": "lgh_Abc123XyZ456De",
  "object": "legal_hold",
  "name": "X v. Y",
  "description": "Preservation notice 2026-08-12",
  "custodian_count": 3,
  "created_at": "2026-09-21T10:00:00Z"
}

Changes