VEverdun
post-action captures (ingestor)

Claim Capture

Atomically claim a pending capture (180 s lease). 409 when someone else holds it or it is finished/expired; a repeat by the current holder is an idempotent 200.

post/ingestor/post-action-captures/{capture_id}/claim

Request

  • Base URL
    https://api.verdun.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.verdun.ai/ingestor/post-action-captures/{capture_id}/claim
  • Auth
    API key in header X-API-Key

Path parameters

capture_idstring required

Request body

claimed_bystring required

Stable ingestor instance id (task/host id, plus /shard-{i}-{n} in sharded modes).

Example request

{
  "claimed_by": "task-1a2b3c/shard-0-4"
}

Response

Successful Response

capture_idstring uuid required

Capture id.

claimed_bystring required

The holder.

claimed_atstring date-time required

When the claim was taken.

claim_expires_atstring date-time required

Lease end (180 s); no renewal route in v1.

window_startstring date-time required

Authoritative start of the recording.

window_endstring date-time required

End of the recording window.

s3_keystring required

Upload exactly here. Reclaims use a distinct -attempt-N key; the claim key overrides the feed hint.

Changes

No recorded changes to this operation across all 2 revisions of this API.