Skip to main content
POST
Claim a duplicate-trigger fingerprint

Authorizations

Authorization
string
header
required

OrgX API key, sent as Authorization: Bearer oxk_...

Headers

Idempotency-Key
string

Accepted for forward compatibility. Replay safety for this operation comes from its own state checks, described on the operation.

Required string length: 1 - 200
Pattern: ^[A-Za-z0-9][A-Za-z0-9._:/-]{0,199}$

Body

application/json
source
string
required

The trigger family, for example a webhook or scheduler name.

Required string length: 1 - 120
event_key
string
required

The stable identity of the event within its source.

Required string length: 1 - 500
initiative_id
string<uuid>

Optional scope; claims default to organization scope without it.

ttl_seconds
integer

Claim lifetime; defaults to six hours.

Required range: 60 <= x <= 1209600
active_run_id
string<uuid>

The run asserting the claim; generated when omitted.

Response

Claim outcome — either you hold the fingerprint or another run already does

ok
boolean
required
deduped
boolean
required

True when another run already holds the fingerprint.

claimed
boolean
required

True when this request took or extended the claim.

fingerprint_hash
string
required

The derived fingerprint identity.

active_run_id
string<uuid> | null

The run holding the claim.

expires_at
string<date-time> | null
data
object