# POST /api/v1/event-consumers/:id/reset

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/event-consumer-reset

## Summary

Move the committed cursor. start is "now", "oldest", or an ISO-8601 timestamp, including a time in the past. HTTP 400 invalid_start. HTTP 404 consumer_not_found. Requires message_read.

## Request

```json
{
  "start": "oldest"
}
```

## Response

HTTP 200. Sample values illustrate the schema.

```json
{
  "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_start
- HTTP 404 consumer_not_found

The live `message` is the sentence for that code. Branch on `code`.

```json
{
  "error": {
    "type": "invalid_request",
    "code": "invalid_start",
    "docs_url": "https://cooperemail.com/docs#invalid_start"
  }
}
```

## Idempotency

This route does not document Idempotency-Key or client_id.