---
title: "Atomically claim one exact case revision"
method: POST
path: "/v1/cases/{case_id}/claims"
tags: ["Automation"]
---

# Atomically claim one exact case revision

`POST /v1/cases/{case_id}/claims`

## Request

- Base URL: `https://api.agentry.sh`
- URL: `https://api.agentry.sh/v1/cases/{case_id}/claims`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Consumes the exact unhandled-case receipt into one bounded lease. The lease token is returned only to the exact claimant and exact idempotent replay.

## Path parameters

- `case_id` string, required

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `automation_id` string, required
  - `trigger_receipt_id` string, required
  - `claimed_by` string, required
  - `lease_seconds` integer

## Response `200`

OK

- object
  - `id` string, required
  - `project_id` string, required
  - `case_id` string, required
  - `case_revision` integer, required
  - `automation_id` string, required
  - `trigger_receipt_id` string, required
  - `contract_revision` integer
  - `contract_etag` string
  - `attempt` integer, required
  - `claimed_by` string, required
  - `credential_id` string, nullable
  - `acquired_at` integer, required
  - `expires_at` integer, required
  - `run_id` string, nullable
  - `released_at` integer, nullable
  - `release_reason` string, nullable
  - `lease_token` string
  - `idempotent_replay` boolean
  - `next_action` string

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/agentry/apis/agentry-api.md) · [All operations](https://skmtc.dev/agentry/apis/agentry-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentry/apis/agentry-api/revisions/abdecddf009f?raw)