Help Center/ Distributed Message Service for RocketMQ/ API Reference/ APIs V2 (Recommended)/ Consumer Group Management/ Resetting the Consumer Offset
Updated on 2026-04-30 GMT+08:00
View PDF

Resetting the Consumer Offset

Function

This API is used to reset the consumer offset.

URI

POST /v2/{engine}/{project_id}/instances/{instance_id}/groups/{group}/reset-message-offset

Table 1 Path Parameters

Parameter

Mandatory

Type

Description

engine

Yes

String

Definition

Engine.

Constraints

N/A

Range

  • rocketmq: RocketMQ message engine.

  • reliability: RocketMQ message engine alias.

Default Value

N/A

project_id

Yes

String

Definition

Project ID. For details about how to obtain it, see Obtaining a Project ID.

Constraints

N/A

Range

N/A

Default Value

N/A

instance_id

Yes

String

Definition

Instance ID. You can call the API for querying all instances to obtain the instance ID. The instance ID is in the response body.

Constraints

N/A

Range

N/A

Default Value

N/A

group

Yes

String

Definition

Consumer group name.

Constraints

N/A

Range

N/A

Default Value

N/A

Request Parameters

Table 2 Request body parameters

Parameter

Mandatory

Type

Description

topic

Yes

String

Definition

Topic to be reset.

Constraints

N/A

Range

N/A

Default Value

N/A

timestamp

Yes

String

Definition

Reset time.

Constraints

N/A

Range

N/A

Default Value

N/A

Response Parameters

Status code: 200

Table 3 Response body parameters

Parameter

Type

Description

queues

Array of queues objects

Definition

Queues to be reset.

Constraints

N/A

Range

N/A

Default Value

N/A
Table 4 queues

Parameter

Type

Description

broker_name

String

Definition

Broker where the queue is located.

Constraints

N/A

Range

N/A

Default Value

N/A

queue_id

Integer

Definition

Queue ID.

Constraints

N/A

Range

N/A

Default Value

N/A

timestamp_offset

Long

Definition

Resets consumer offset.

Constraints

N/A

Range

N/A

Default Value

N/A

Example Requests

Resetting consumer offset of topic_01 to the specified time

POST https://{endpoint}/v2/{engine}/{project_id}/instances/{instance_id}/groups/{group_id}/reset-message-offset

{
  "topic" : "topic_01",
  "timestamp" : 1662652800000
}

Example Responses

Status code: 200

Consumer offset reset.

{
  "queues" : [ {
    "broker_name" : "broker-1",
    "queue_id" : 0,
    "timestamp_offset" : 0
  } ]
}

Status Codes

Status Code

Description

200

Consumer offset reset.

Error Codes

See Error Codes.

Parent Topic: Consumer Group Management