Skip to content

GET · Bearer

GET /api/v1/event-consumers/:id

Summary

Read one durable event consumer. :id is the evcon_ id or the client_id. Requires message_read. Another account, or a consumer outside an inbox-scoped key, is HTTP 404 consumer_not_found. DELETE removes it and returns {id, client_id, deleted:true}.

Request

This call has no JSON body.

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 404 consumer_not_found

Idempotency

client_id makes this write idempotent. Sending the same client_id again returns the original object instead of creating a duplicate.