Mark chat activity as read
POST/v2/spaces/:space_id/chats/:chat_id/read
up_to is inclusive; it and last_state_id come from one messages read: the newest order and the state's id. An empty value would silently mark nothing, so both are required. Later messages stay unread. The reactions scope takes neither field. The receipt carries the chat's state after the move when it could be read back.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
- 413
- 429
Watermark moved
Validation failure
Missing, unknown, revoked or expired key; shared authentication envelope
The shared key-scope gate uses the legacy envelope; an operation-specific refusal may use the v2 error envelope
Chat not found
Idempotency-Key conflict, or an operation-specific concurrency conflict
Request body exceeds this operation's documented cap
Shared write rate limit; legacy error envelope