Probably
Start free
Docs

Revoke a share link

revoke_share, in Changes: A connection or key that may make changes. None spends credits; prepare_* and stage tools (research, brainstorm, write_script, review, generate_clip, voice, storyboard) prepare paid work for confirm_spend.

POST
/api/v1/tools/revoke_share

Revoke an active share link: it stops opening, and its video stops playing within minutes wherever it was pasted. A link already revoked reads as missing.

Authorization

apiKey
headerAuthorizationBearer <token>

An API key (prb_…) from Settings → Connections.

Request Body

application/json
  1. body
shareId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

The tool's answer.

application/json
  1. response
revoked*boolean
curl -X POST 'https://studio.probably.co/api/v1/tools/revoke_share' \  -H "Authorization: Bearer $PROBABLY_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "shareId": "6a9e781b-5ee2-4314-8665-1c09eed0443a"}'
{  "revoked": true}