---
title: "Creating a new Line Item Lock"
method: POST
path: "/line_item_locks"
tags: ["Line Item Locks"]
---

# Creating a new Line Item Lock

`POST /line_item_locks`

## Request

- Base URL: `https://api.mavenlink.com/api/v1`
- URL: `https://api.mavenlink.com/api/v1/line_item_locks`
- Auth: none declared

A line item lock will be created on your account at the specified lock date. On successful creation of a
line item lock, a representation of it will be returned to you.

If your account requires time to be approved, creation will fail unless all time entries before the
specified lock date have been approved. The Kantata OX UI has an auto approval tool for your convenience
if you find yourself in this scenario.


This endpoint returns structured Line Item Lock objects.
As with all Kantata OX API endpoints, the returned data will be referenced in sorted order in the `results` array
and will be indexed by ID in the `line_item_locks` top-level JSON key.
Please see our [Response Format](#section/Response-Format) section for more information.

## Query parameters

- `include` string

## Request body

- object
  - `line_item_lock` object
    - `locked_to` string, date, required: Specify the date before which no one on the account will be able to submit or edit time entries. (note: This must be a Saturday.) If any Line Item Locks previously existed on your account, this must be set to a later date than said preexisting lock. The date must be in [ISO 8601](https://www.w3.org/TR/NOTE-datetime) format.

## Response `200`

Line Item Lock has been created.

- object
  - `count` integer
  - `meta` object
    - `count` integer
    - `page_count` integer
    - `page_number` integer
    - `page_size` integer
  - `results` object[]
    - `key` string
    - `id` string
  - `line_item_locks` object
  - `users` object

## Other responses

- `400`: Bad Request
- `401`: Unauthorized request
- `403`: Forbidden request
- `404`: Page Not Found
- `422`: Unprocessable Entity
- `503`: Service is unavailable

---

[API](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation.md) - [All operations](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/kantata/apis/kantata-ox-api-documentation/revisions/9d4ebed2fa98?raw)