Skip to main content
DELETE
Bulk delete links
Permanently delete up to 100 links from the API key’s workspace. This endpoint uses public biq_lnk_... IDs and requires Links: Write (links.delete).

Request

Send the IDs as one comma-separated link_ids query parameter:
The list must contain 1 to 100 distinct, correctly formatted public IDs. Internal numeric IDs and workspace IDs are not accepted.
Deletion is permanent. Short URLs stop resolving, attached QR files are removed, and related data is scheduled for cleanup. Use List or Retrieve to confirm targets before deleting them.

Idempotent behavior

Valid IDs that are already deleted, missing, inaccessible to the key owner, or belong to another workspace are ignored. This makes retrying the same request safe and avoids revealing whether a link exists elsewhere. Unlike the single-link Delete endpoint, bulk delete returns 200 OK with a summary body:
deleted_count is the number deleted by this request. It can be 0. The response does not echo identifiers, so retain your own submitted list if you need to reconcile it.

Errors

Validation responses include field errors under error.details.errors. Every error includes a request_id for support and request tracing.

Shared API behavior

Authentication is workspace-scoped; see Authentication. Errors use the standard envelope and request IDs described in Errors, and requests are subject to Rate limits.

Authorizations

Authorization
string
header
required

A workspace API key beginning with biqli_.

Query Parameters

Comma-separated public link IDs.

Required array length: 1 - 100 elements
Pattern: ^biq_lnk_[0-9A-HJKMNP-TV-Z]{26}$

Response

Deletion request completed.

deleted_count
integer
required
Required range: 0 <= x <= 100
status
string
required
Allowed value: "success"