v51

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0172165343.2 KB
Msgs

Stream Seek

Repositions a consumer group's read cursor on a topic.

Provide exactly one of offset, position, or timestamp. When using offset, the topic must include a partition suffix (e.g. ns:my-topic~0). The position field accepts "earliest" or "latest" and may be used with or without a partition suffix. The timestamp field accepts a Unix timestamp in milliseconds and seeks to the first message at or after that time.

post/api/v1.msgs.stream.seek

Request body

namespacestring nullable
topicstring required
consumer_groupstring required
offsetinteger nullable
position'earliest' | 'latest'
timestampinteger nullable

Example request

{
  "namespace": "some_namespace",
  "topic": "some_topic_name",
  "consumer_group": "some_consumer_group"
}

Response

MsgStreamSeekOut required