curl -X DELETE \
"https://app.runtm.com/api/cloud/sessions/ses_abc123/preview-shares/9c1f0b7e-4b1a-4c2e-8f3d-2a5b6c7d8e9f" \
-H "Authorization: Bearer runtm_xxx"
runtm-api session share revoke ses_abc123 9c1f0b7e-4b1a-4c2e-8f3d-2a5b6c7d8e9f
import requests
requests.delete(
"https://app.runtm.com/api/cloud/sessions/ses_abc123"
"/preview-shares/9c1f0b7e-4b1a-4c2e-8f3d-2a5b6c7d8e9f",
headers={"Authorization": "Bearer runtm_xxx"},
)
{
"revoked": true
}
Sharing
Revoke a Preview Share
Withdraw someone’s access to a shared preview
DELETE
/
api
/
sessions
/
{session_id}
/
preview-shares
/
{share_id}
curl -X DELETE \
"https://app.runtm.com/api/cloud/sessions/ses_abc123/preview-shares/9c1f0b7e-4b1a-4c2e-8f3d-2a5b6c7d8e9f" \
-H "Authorization: Bearer runtm_xxx"
runtm-api session share revoke ses_abc123 9c1f0b7e-4b1a-4c2e-8f3d-2a5b6c7d8e9f
import requests
requests.delete(
"https://app.runtm.com/api/cloud/sessions/ses_abc123"
"/preview-shares/9c1f0b7e-4b1a-4c2e-8f3d-2a5b6c7d8e9f",
headers={"Authorization": "Bearer runtm_xxx"},
)
{
"revoked": true
}
Deletes a preview share.
Revocation takes effect once the holder’s current preview cookie expires — a few minutes — rather than instantly. To cut access off immediately, pause or destroy the session as well.
Get
share_id from List Preview Shares.
Required scope: sessions:write
From the CLI:
runtm-api session share revoke <session_id> <share_id>Path Parameters
string
required
The session ID (e.g.
ses_abc123).string
required
The share ID. Scoped by session, so an id alone is not enough to revoke.
Headers
string
required
Bearer token. Example:
Bearer runtm_xxxstring
Scope to an organization.
Response
boolean
true when the share was deleted. Returns 404 when no such share exists on this session.curl -X DELETE \
"https://app.runtm.com/api/cloud/sessions/ses_abc123/preview-shares/9c1f0b7e-4b1a-4c2e-8f3d-2a5b6c7d8e9f" \
-H "Authorization: Bearer runtm_xxx"
runtm-api session share revoke ses_abc123 9c1f0b7e-4b1a-4c2e-8f3d-2a5b6c7d8e9f
import requests
requests.delete(
"https://app.runtm.com/api/cloud/sessions/ses_abc123"
"/preview-shares/9c1f0b7e-4b1a-4c2e-8f3d-2a5b6c7d8e9f",
headers={"Authorization": "Bearer runtm_xxx"},
)
{
"revoked": true
}