Delete Link

Delete a recording link

DELETE /public/workspace/{workspaceId}/links/{linkId}

Delete recording link

cURL

curl --request DELETE \
  --url https://api.userplane.io/api/v1/public/workspace/{workspaceId}/links/{linkId} \
  --header 'Authorization: Bearer <token>'

200

{
  "message": "<string>",
  "data": {
    "workspaceId": "<string>",
    "linkId": "<string>"
  }
}

Soft-deletes a recording link. Only the link creator or a workspace admin/owner can delete a link.

This is a soft delete. The link data is preserved but becomes inaccessible. Subsequent requests for this link return 410 Gone.

Errors

Error code	Status	Description
LINK_NOT_FOUND	404	Link does not exist
LINK_GONE	410	Link has already been deleted
LINK_DELETE_FORBIDDEN	403	You do not have permission to delete this link
LINK_DELETE_FAILED	500	Failed to delete the link

Also returns common authentication errors.

Related

List Links

View all active links in the workspace

Create Link

Create a new recording link

Get Link

Retrieve link details by ID

Error Handling

Understand 410 Gone and other error codes

Authorizations

Authorization · string · header · required

API key with uspl_ prefix. Create keys at dash.userplane.io/_/account?tab=developers

Path Parameters

workspaceId · string · required

Minimum string length: 1

linkId · string · required

Minimum string length: 1

Response

200

application/json

OK

message · string · required

data · object · required

Show child attributes