Rescans current Delivery authority and conditionally advances the personal cursor and barriers.

PUT

/v1/m/sessions/inbox/cursors/personal/{recipient}

curl --request PUT \
  --url https://example.com/v1/m/sessions/inbox/cursors/personal/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: 2489E9AD-2EE2-8E00-8EC9-32D5F69181C0' \
  --header 'If-Match: example' \
  --data '{ "cursor": "example", "delivery_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0" }'

• this engine

Rescans current Delivery authority and conditionally advances the personal cursor and barriers.

Authorizations

• bearerAuth
• browserSession

Parameters

Path Parameters

recipient

required

string

Path parameter recipient.

Header Parameters

X-Olivares-Tenant

string format: uuid

Target tenant id; required when the principal can act in more than one tenant.

If-Match

required

string

/^\"v[0-9]+\"$/

Strong ETag from cursor-target minting; virtual lineage uses “v0”.

Idempotency-Key

required

string format: uuid

Canonical UUID binding the exact durable cursor command.

Request Body ^required

Media type application/json

object

cursor

required

string

>= 1 characters <= 8192 characters

delivery_id

required

Exact target Delivery named by the opaque cursor token; used for stored-workspace route authorization.

string format: uuid

Example ^generated

{
  "cursor": "example",
  "delivery_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

Responses

200

Cursor command committed or replayed

Media type application/json

object

audit_seq

required

integer format: int64

command_id

required

string format: uuid

cursor_id

required

string format: uuid

etag

required

string

projection

required

object

barrier_delivery_id

string format: uuid

barrier_reason

string

barrier_since

Any of:

string

string format: date-time

null

null

last_seen_seq

integer format: int64

replayed

required

boolean

version

required

integer format: int64

Example ^generated

{
  "audit_seq": 1,
  "command_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "cursor_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "etag": "example",
  "projection": {
    "barrier_delivery_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
    "barrier_reason": "example",
    "barrier_since": "2026-04-15T12:00:00Z",
    "last_seen_seq": 1
  },
  "replayed": true,
  "version": 1
}

400

Bad request

Media type application/json

object

Example ^generated

{}

401

Unauthenticated

Media type application/json

object

Example ^generated

{}

403

Forbidden

Media type application/json

object

Example ^generated

{}

404

Not found

Media type application/json

object

Example ^generated

{}

409

Conflict

Media type application/json

object

Example ^generated

{}

412

Precondition failed

Media type application/json

object

Example ^generated

{}

428

Required precondition missing

Media type application/json

object

Example ^generated

{}

429

Rate limited

Media type application/json

object

Example ^generated

{}

503

Current authority, custody or store evidence is unavailable; or, with code commit_outcome_unknown, the write was issued and its outcome was never learned, so it may be durable and must not be retried automatically

Media type application/json

object

Example ^generated

{}