---
title: "List Locks by Path"
method: GET
path: "/locks/{path}"
tags: ["locks", "Locks"]
---

# List Locks by Path

`GET /locks/{path}`

List Locks by Path

## Path parameters

- `path` string, required

## Query parameters

- `cursor` string
- `per_page` integer
- `include_children` boolean

## Response `200`

A list of Locks objects.

- LockEntity[]
  - `path` string — Path
  - `timeout` integer — Lock timeout in seconds
  - `depth` string
  - `recursive` boolean — Does lock apply to subfolders?
  - `owner` string — Owner of the lock. This can be any arbitrary string.
  - `scope` string
  - `exclusive` boolean — Is lock exclusive?
  - `token` string — Lock token. Use to release lock.
  - `type` string
  - `allow_access_by_any_user` boolean — Can lock be modified by users other than its creator?
  - `user_id` integer — Lock creator user ID
  - `username` string — Lock creator username

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `405` — Method Not Allowed
- `409` — Conflict
- `412` — Precondition Failed
- `422` — Unprocessable Entity
- `423` — Locked
- `429` — Too Many Requests

---

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