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

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

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

Release a batch of Cloud Events. The response will include the set of successfully released lock tokens, along with other failed lock tokens with their corresponding error information. Successfully released events can be received by consumers.

## Path parameters

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

## Query parameters

- `api-version` string, required
- `releaseDelayInSeconds` '0' | '10' | '60' | '600' | '3600'

## Request body

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

## Response `200`

The request has succeeded.

- ReleaseResult — The result of the Release 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 released cloud events.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2023-11-01) `fa0c2b9f87c0` — 1 info
  - added the new optional `query` request parameter `releaseDelayInSeconds`

[Change history](https://skmtc.dev/azure/apis/eventgrid-eventgridnamespace/changes/topics/:topicName/eventsubscriptions/:eventSubscriptionName:release/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)