Claim a duplicate-trigger fingerprint
curl --request POST \
--url https://useorgx.com/api/v1/live/dedup/claim \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": "github-webhook",
"event_key": "pr-2638-merged"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({source: 'github-webhook', event_key: 'pr-2638-merged'})
};
fetch('https://useorgx.com/api/v1/live/dedup/claim', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://useorgx.com/api/v1/live/dedup/claim"
payload = {
"source": "github-webhook",
"event_key": "pr-2638-merged"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"ok": true,
"deduped": false,
"claimed": true,
"fingerprint_hash": "4f1c9a7e2b8d6c3a5e0f7b9d1c4a6e8f2b5d7c9a1e3f5b7d9c1a3e5f7b9d1c4a",
"active_run_id": "6e5d4c3b-2a1f-4e9d-8c7b-6a5f4e3d2c1b",
"expires_at": "2026-08-19T21:10:00.000Z",
"data": {
"auth_mode": "api_key"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}Deduplication
Claim a duplicate-trigger fingerprint
Claim a durable fingerprint for an event so local and cloud triggers reacting to the same
signal fire once. The fingerprint derives from source, event_key, and the optional
initiative_id; the first claimant wins until the claim expires or is released. The store
fails closed — when it is unavailable the endpoint returns 503 rather than letting both
triggers proceed.
POST
/
live
/
dedup
/
claim
Claim a duplicate-trigger fingerprint
curl --request POST \
--url https://useorgx.com/api/v1/live/dedup/claim \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"source": "github-webhook",
"event_key": "pr-2638-merged"
}
'const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({source: 'github-webhook', event_key: 'pr-2638-merged'})
};
fetch('https://useorgx.com/api/v1/live/dedup/claim', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://useorgx.com/api/v1/live/dedup/claim"
payload = {
"source": "github-webhook",
"event_key": "pr-2638-merged"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"ok": true,
"deduped": false,
"claimed": true,
"fingerprint_hash": "4f1c9a7e2b8d6c3a5e0f7b9d1c4a6e8f2b5d7c9a1e3f5b7d9c1a3e5f7b9d1c4a",
"active_run_id": "6e5d4c3b-2a1f-4e9d-8c7b-6a5f4e3d2c1b",
"expires_at": "2026-08-19T21:10:00.000Z",
"data": {
"auth_mode": "api_key"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}Headers
Body
application/json
Response
Claim outcome — either you hold the fingerprint or another run already does
