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
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
Returns 403 if the caller is not the current holder.
List active claims
MCP parity
kiwi_claim, kiwi_release, kiwi_claims_list — see MCP. Last modified on May 14, 2026
