Skip to main content

Delete Tracking Link (v1)

Method & Path​

DELETE /api/v1/workspace/:workspaceId/tracking-links/:linkId

Description​

Permanently delete a tracking link from a workspace.

Authentication​

Required: Workspace authentication. User must be authenticated as Workspace Owner or Staff with workspace.settings.manage permission.

Headers​

Authorization: Bearer <workspace_token>
Content-Type: application/json

Path Parameters​

ParameterTypeRequiredDescription
workspaceIdstringYesWorkspace identifier
linkIdstringYesTracking link identifier

Response 204 No Content​

No response body.

Common Errors​

401 Unauthorized: Missing or invalid authentication token

403 Forbidden: User does not have workspace.settings.manage permission

404 Not Found: Workspace or tracking link not found

500 Internal Server Error: Server error occurred while processing the request

Notes​

  • This operation is permanent and cannot be undone
  • Deleting a tracking link does not affect historical visit tracking data
  • Workspace subscription status is checked before processing the request