---
title: "Named locks/leases shared across your bots: acquire (ttl_s, wait_s), renew, release, status, list. Auto-release on expiry; fencing token."
method: POST
path: "/api/v1/lock"
tags: ["coordination"]
---

# Named locks/leases shared across your bots: acquire (ttl_s, wait_s), renew, release, status, list. Auto-release on expiry; fencing token.

`POST /api/v1/lock`

## Request

- Base URL: `https://cloudforbots.com`
- URL: `https://cloudforbots.com/api/v1/lock`
- Auth: HTTP bearer

## Request body

- object
  - `action` 'acquire' | 'renew' | 'release' | 'status' | 'list', required
  - `name` string
  - `holder` string
  - `ttl_s` integer
  - `wait_s` integer
  - `token` string

## Response `200`

ok

---

[API](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api.md) · [All operations](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudforbots/apis/cloud-for-bots-api/revisions/1afdb5648693?raw)