Skip to content

Revoke a share link

Revoke a music share link. After revocation, new resolves and saves fail — but recipients who already saved the track keep their copy. The operation is idempotent.

DELETEhttps://api.aitronos.com/v1/music/{organization_id}/share/{share_id}

Revoking a link you do not own returns 404. Revoking an already-revoked link is a no-op.

Path parameters

organization_id string required

The organization the share is scoped to. The caller must belong to it.

share_id string required

The share link id to revoke (mslink_-prefixed).

Returns

A confirmation object.

success boolean · true when the link was revoked.

id string · The revoked share link id.

detail string · Human-readable confirmation message.

cURL
curl -X DELETE "https://api.aitronos.com/v1/music/org_abc123/share/mslink_3a7f2c9e8b14" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

200 OK
{
  "success": true,
  "id": "mslink_3a7f2c9e8b14",
  "detail": "Share link revoked."
}