reissue_subscription_grants
Revoke the access grants a member holds on a subscription — every resource or one — and have fresh ones issued. The members page's "Refresh invite links", for agents.
Give a member a clean set of grants. The grants they hold on the subscription's resources are
revoked (on Telegram, their personal invite links die) and the dispatcher that grants at
purchase runs again, so fresh grants are issued and the bot sends the member the new links.
Use it when a member says a link is expired or was leaked, or after a channel's admins cleared
a ban; pass resource_id to touch one resource and leave the others as they are.
Every revoked grant raises member.resource_reissued,
and each fresh grant raises member.resource_added
moments later. Read the result back with list_subscription_grants.
This revokes live access and messages a real person
The old links stop working the moment this runs, and the member is sent the
new ones. Read the subscription back with
get_subscription first, and do not run it in
a loop.
Requires ability
The token behind the MCP session must hold it, or the call is refused with TOKEN_MISSING_ABILITY.
Runs the same action as
The REST endpoint and this tool share one action, so validation, permissions and events are identical.
Fires events
Delivered to every endpoint subscribed to it once the change is made.
Annotations
A client that honours annotations asks a person before running it.
Arguments
subscription_id*stringUUID of the subscription whose grants to reissue.
resource_idstringoptionalUUID of one resource of the plan to reissue alone; omit to reissue every resource the subscription grants.
What it returns
{ "data": { "subscription_id": "5b7e2d40-1a86-4c39-97f2-e83d0b16c5a4", "reissued": 2, "status": "reissue_queued" }}reissued counts the grants that were revoked; the fresh ones are issued by a queued job and
appear on the ledger seconds later.
How it fails
VALIDATION_FAILEDthe subscription is not active, so there is nothing to reissue.
RESOURCE_NOT_FOUNDunknown subscription_id, a subscription outside the token's scope, or a resource_id the plan does not grant.
AUTHENTICATION_REQUIREDno authenticated user on the request.
TOKEN_MISSING_ABILITYtoken lacks project-subscription:update.
How is this guide?
Last updated on