Release a claimed event

Hands a leased event back so it can be claimed again immediately. Use when your handler fails. Not checked against the original claimer: cooperative, not access control. Releasing an already-done event changes nothing.

post/v1/{account_id}/events/{event_id}/release

Request

Base URL: https://api.curviate.com
URL: https://api.curviate.com/v1/{account_id}/events/{event_id}/release
Auth: HTTP bearer

Path parameters

account_idstring required

The connected LinkedIn account whose received events to read.

event_idstring required

The event's id, as returned by the events read or by a claim.

Response

The event's state after the release. A released event is claimable again immediately, by you or by anyone else. Releasing an event that is already done changes nothing and comes back with state done, because done is final. Release is the right move when your handler fails: hand the work back rather than sit on it for the rest of the lease.

object'event_lease' required

Response type discriminator.

idstring required

The event's id.

state'unread' | 'claimed' | 'done' required

unread: claimable now. claimed: leased to someone until lease_until. done: handled, and it will never be handed out again. There is no failed state.

claimed_bystring nullable required

The consumer name recorded by the last claim, or null. Free text, never verified, so treat it as a label rather than an identity.

lease_untilstring date-time nullable required

When the current lease expires, or null when the event is not leased.

done_atstring date-time nullable required

When the event was marked done, or null. Set once and never moved.

Example response

{
  "safety_warning": {
    "row": "profile_views",
    "reset_at": "2026-09-05T00:00:00.000Z",
    "hint": {
      "parameter": "profile_views.ceiling",
      "message": "This account is at its ceiling for profile_views. This action went through because profile_views.posture is warn, and it counted: 101 of 100 this window. Raise profile_views.ceiling, or wait for the window to reset at 2026-09-05T00:00:00.000Z."
    },
    "reason": "ceiling",
    "blocked": false
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.