Skip to content

POST · Bearer

POST /api/v1/event-consumers/:id/commit

Summary

Advance the committed cursor. cursor is the evc1 commit_cursor from the poll. An older cursor is a no-op and the response keeps the current cursor. One conditional update compares created_at and id, so two workers cannot move it backwards. HTTP 400 invalid_cursor. HTTP 404 consumer_not_found. Requires message_read. Delivery is at-least-once until this commit, so dedupe by event id when a side effect can run twice.

Request

{
  "cursor": "evc1.…"
}

Response

HTTP 200. Sample values illustrate the schema.

{
  "object": "event_consumer",
  "id": "inb_example",
  "client_id": "inb_example",
  "cursor": "string",
  "created_at": "2026-10-18T12:00:00.000Z",
  "updated_at": "2026-10-18T12:00:00.000Z"
}

Errors

  • HTTP 400 invalid_cursor
  • HTTP 404 consumer_not_found

Idempotency

This route does not document Idempotency-Key or client_id.