---
title: "Create Legal Hold"
method: POST
path: "/v1/accounts/me/legalHolds"
tags: ["Legal Holds"]
---

# Create Legal Hold

`POST /v1/accounts/me/legalHolds`

Creates a new legal hold on an Enterprise Shield account with specified parameters including title, description, keywords, and start/end times.

## Request body

- object
  - `Title` string, required — Title that should be given to the newly created legal hold. Max length of title is 80 characters.
  - `StartTime` string, date-time, required — Time that the legal hold should start. Must not be in the past.
  - `EndTime` string, date-time, required — Time that the legal hold should end. End time must be greater than or equal to 24 hours after the start time.
  - `Description` string — Description that should be given to the newly created legal hold. Max length of description is 256 characters.
  - `Keywords` string — Keyword(s) to search against document content and titles. Note: When provided, only relevant results will be added to the legal hold. Empty strings will be treated the same as when no keywords are provided. Max length of keywords is 400 characters.

## Response `201`

With the newly created legal hold.

- LegalHold
  - `LegalHoldId` string, uuid, required — Unique ID of the legal hold.
  - `AccountId` number, required — Unique ID for the creating admin’s account.
  - `StartTime` string, date-time, required — Start time of the legal hold.
  - `EndTime` string, date-time, required — End time of the legal hold.
  - `Title` string, required — Title of the legal hold.
  - `Description` string — Description of the legal hold.
  - `Keywords` string — Keyword(s) of the legal hold.
  - `Created` string, date-time, required — Time that the legal hold was created.
  - `Modified` string, date-time, required — Time that the legal hold was last modified.

## Other responses

- `400` — Incorrect format or invalid parameters.
- `403` — Account does not have permission to access the API.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/revisions/6a32cb9e1aa7/schema)