---
title: "Assign legal hold policy"
method: POST
path: "/legal_hold_policy_assignments"
tags: ["Legal hold policy assignments"]
---

# Assign legal hold policy

`POST /legal_hold_policy_assignments`

Assign a legal hold to an item type of: file, file version, folder, user, ownership, or interactions.

## Request body

- object
  - `policy_id` string, required — The ID of the policy to assign.
  - `assign_to` object, required — The item to assign the policy to.
    - `type` 'file' | 'file_version' | 'folder' | 'user' | 'ownership' | 'interactions', required — The type of item to assign the policy to.
    - `id` string, required — The ID of item to assign the policy to.

## Response `201`

Returns a new legal hold policy assignment.

- LegalHoldPolicyAssignment — Legal Hold Assignments are used to assign Legal Hold Policies to Users, Folders, Files, or File Versions. Creating a Legal Hold Assignment puts a hold on the File-Versions that belong to the Assignment's 'apply-to' entity.
  - `id` string — The unique identifier for this legal hold assignment.
  - `type` 'legal_hold_policy_assignment' — The value will always be `legal_hold_policy_assignment`.
  - `legal_hold_policy` object — The policy that the legal hold policy assignment is part of.
    - `id` string, required — The unique identifier for this legal hold policy.
    - `type` 'legal_hold_policy', required — The value will always be `legal_hold_policy`.
  - `assigned_to` object — The item that the legal hold policy is assigned to. Includes type and ID.
    - `type` 'file' | 'file_version' | 'folder' | 'user' | 'ownership' | 'interactions', required — The type of item the policy is assigned to.
    - `id` string, required — The ID of the item the policy is assigned to.
  - `assigned_by` object — The user who created the legal hold policy assignment.
    - `id` string, required — The unique identifier for this user.
    - `type` 'user', required — The value will always be `user`.
    - `name` string — The display name of this user.
    - `login` string, email — The primary email address of this user.
  - `assigned_at` string, date-time — When the legal hold policy assignment object was created.
  - `deleted_at` string, date-time — When the assignment release request was sent. (Because it can take time for an assignment to fully delete, this isn't quite the same time that the assignment is fully deleted). If null, Assignment was not deleted.

## Other responses

- `default` — An unexpected client error.

---

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