Bulk delete annotations by IDs

POST

http://localhost:8000/api/annotations/bulk-delete/

Delete multiple annotations by their IDs. At most 100 annotation IDs can be submitted in one request. The deletion is processed synchronously. Returns the count of deleted annotations in the response.

Authentication

AuthorizationToken

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example: <br><pre><code class="language-bash">curl https://label-studio-host/api/projects -H "Authorization: Token [your-token]"</code></pre>

Request

This endpoint expects an object.

idslist of integersRequired

List of annotation IDs to delete. Maximum 100 IDs per request.

projectintegerRequired

Response

Annotations deleted successfully

deleted_countintegerOptional

Number of annotations deleted

Errors

400

Bad Request Error

403

Forbidden Error

The token (or API key) must be passed as a request header. You can find your user token on the User Account page in Label Studio. Example:

curl https://label-studio-host/api/projects -H “Authorization: Token [your-token]”

$	curl -X POST http://localhost:8000/api/annotations/bulk-delete/ \
>	-H "Authorization: Token <api_key>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"ids": [
>	1
>	],
>	"project": 1
>	}'