Revoke Share Link

Beta
Revoke a share link. Idempotent — revoking an already-revoked link succeeds and leaves the original timestamp intact. Revocation stops new calls immediately. It does not hang up a call already in progress: that call is already bounded by its own duration limit and has already drawn its time from the link's budget, so ending it mid-sentence would surprise the person talking without saving the owner anything.

Authentication

AuthorizationBearer

Enter your API key with the Bearer prefix, e.g. ‘Bearer sk_…’.

Path parameters

agent_idstringRequired

Agent id (prefixed external id, agent_...).

Headers

Speechify-VersionstringOptional

Response

The link was revoked.

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error