Early bird discounts live! Claim your offerMemberPass is now live! To celebrate we have introduced amazing early bird discounts for a limited time! Claim your offer now!

ban_member

Ban a project member. Flips status to banned and emits member.banned. Noop when the member is already banned.

Purpose

Ban a project member. Delegates to an Action so cache invalidation runs and a member.banned event emits with the optional reason. Telegram-side eviction runs on the existing bot pipeline. Noop when the member is already banned.

Required ability

project-user:update

Input schema

{
  "type": "object",
  "required": ["member_id"],
  "properties": {
    "member_id": {
      "type": "string",
      "description": "UUID of the project member to ban."
    },
    "reason": {
      "type": "string",
      "description": "Optional human-readable reason that lands in the member.banned event payload."
    }
  }
}

Output shape

{
  "data": {
    "id": "usr_01HX...",
    "status": "banned"
  }
}

Example prompts

"Ban member usr_01HX... for repeated spam."

"Block this user from the project."

Failure modes

RESOURCE_NOT_FOUND — unknown member_id, or the member belongs to a team outside the token's scope.
TOKEN_MISSING_ABILITY — token lacks project-user:update.

How is this guide?

cancel_subscription

Queue a subscription cancellation. Provider-side cancellation and local state mutation run asynchronously on the webhooks queue.

unban_member

Lift a ban on a project member. Status rolls to churned; next successful payment promotes them back to customer.