Claims require a configured claim store. Otherwise endpoints return 503 with "claims not enabled".
X-Actor is mandatory for claim and release.
Base path: http://localhost:3333/api/kiwi.
Claim a path
POST /claim
Content-Type: application/json
{
"path": "runbooks/deploy.md",
"lease_duration": "45m"
}
lease_duration is optional (Go duration syntax). The server enforces 1m ≤ lease ≤ 24h (default 30m).- Returns
409 JSON { "error": "already claimed", "active_claim": { ... } } when another actor holds the lease.
Release
DELETE /claim
Content-Type: application/json
{ "path": "runbooks/deploy.md" }
403 if the caller is not the current holder.
List active claims
{ "claims": [/* active claim objects */] }
MCP parity
kiwi_claim, kiwi_release, kiwi_claims_list — see MCP. Last modified on May 22, 2026
