admin-referrals

Revoke Referral Grant

Revoke a grant and recompute both sides' referral bonuses.

Idempotent: revoking an already-revoked grant is a no-op that still returns the row, so an admin retry (or a double-click) is harmless.

Args: grant_id: The ledger row to revoke. payload: Revocation reason. user: Authenticated system admin. db: Database session.

Returns: The revoked grant.

Raises: HTTPException: 404 if no such grant exists.

post/api/v1/admin/referrals/{grant_id}/revoke

Request

  • Base URL: https://memory.kagura-ai.com (the document declares no server; this is the origin it was published from)
  • URL: https://memory.kagura-ai.com/api/v1/admin/referrals/{grant_id}/revoke
  • Auth: none declared

Path parameters

grant_idstring uuid required

Request body

reasonstring required

Response

Successful Response

idunknown required
referrer_user_idunknown required
referrer_workspace_idunknown required
referred_user_idunknown required
referred_workspace_idunknown required
referrer_bonus_memoriesunknown required
referred_bonus_memoriesunknown required
granted_atunknown required
revoked_atunknown required
revoked_reasonunknown required

Changes

No recorded changes to this operation across all 2 revisions of this API.