---
title: "Advance an event checkpoint cursor"
method: PATCH
path: "/event/checkpoint/{name}"
tags: ["Event Checkpoints"]
---

# Advance an event checkpoint cursor

`PATCH /event/checkpoint/{name}`

Advance the checkpoint to a new cursor position.

Supply the `new_cursor` to move to. If you also provide the
`expected_checkpoint_version` from the last read, the request uses it as an optimistic
lock and returns 409 Conflict if the checkpoint has changed since you last read it.

## Path parameters

- `name` string, required

## Request body

- PatchCheckpointBody
  - `expected_checkpoint_version` string, nullable — Optional checkpointVersion value from your last read of this checkpoint. If supplied and it no longer matches the current version, the request returns 409 Conflict.
  - `new_cursor` string, required — New cursor token (ev1.*) to advance the checkpoint to

## Response `200`

Updated checkpoint state

- PatchCheckpointResponse
  - `checkpoint` CheckpointData, required
    - `checkpointVersion` string, required — Opaque version token (ec1.*) representing the current state of this checkpoint. Pass this as expected_checkpoint_version when advancing the cursor via PATCH — if the checkpoint has changed since you read it, the request will return 409 Conflict.
    - `cursor` string, required — Opaque cursor token (ev1.*) pointing to the current stream position
    - `name` string, required — Checkpoint name
    - `uid` string, required — Unique identifier for the checkpoint
    - `updatedAt` string, required — ISO 8601 timestamp of the last update

---

[API](https://skmtc.net/treasuryspring/apis/treasuryspring-public-api.md) · [All operations](https://skmtc.net/treasuryspring/apis/treasuryspring-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/treasuryspring/treasuryspring-public-api/versions/d587dda25444/schema)