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

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

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

Acknowledge a batch of Cloud Events. The response will include the set of successfully acknowledged lock tokens, along with other failed lock tokens with their corresponding error information. Successfully acknowledged events will no longer be available to be received by any consumer.

## 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.

- AcknowledgeResult — The result of the Acknowledge 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 acknowledged cloud events.

## Other responses

- `default` — An unexpected error response.

---

[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)