---
title: "POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:renewLock"
method: POST
path: "/topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:renewLock"
---

# POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:renewLock

`POST /topics/{topicName}/eventsubscriptions/{eventSubscriptionName}:renewLock`

Renew locks for a batch of Cloud Events. The response will include the set of successfully renewed lock tokens, along with other failed lock tokens with their corresponding error information. Successfully renewed locks will ensure that the associated event is only available to the consumer that holds the renewed lock.

## Path parameters

- `topicName` string, required
- `eventSubscriptionName` string, required

## Query parameters

- `api-version` string, required

## Request body

- object
  - `lockTokens` string[], required — Array of lock tokens.

## Response `200`

The request has succeeded.

- RenewCloudEventLocksResult — The result of the RenewLock operation.
  - `failedLockTokens` FailedLockToken[], required — Array of FailedLockToken for failed cloud events. Each FailedLockToken includes the lock token along with the related error information (namely, the error code and description).
    - `lockToken` string, required — The lock token of an entry in the request.
    - `error` AzureCoreFoundationsError, required — The error object.
      - `code` string, required — One of a server-defined set of error codes.
      - `message` string, required — A human-readable representation of the error.
      - `target` string — The target of the error.
      - `details` AzureCoreFoundationsError[] — An array of details about specific errors that led to this reported error.
      - `innererror` AzureCoreFoundationsInnerError — An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.
        - `code` string — One of a server-defined set of error codes.
        - `innererror` AzureCoreFoundationsInnerError — recursive
  - `succeededLockTokens` string[], required — Array of lock tokens for the successfully renewed locks.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2023-11-01) `fa0c2b9f87c0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/azure/apis/eventgrid-eventgridnamespace/changes/topics/:topicName/eventsubscriptions/:eventSubscriptionName:renewLock/post.md)

---

[API](https://skmtc.dev/azure/apis/eventgrid-eventgridnamespace.md) · [All operations](https://skmtc.dev/azure/apis/eventgrid-eventgridnamespace/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/eventgrid-eventgridnamespace/revisions/fa0c2b9f87c0/schema)