---
title: "Revoke a team invitation"
method: POST
path: "/profile/team/invitations/{invitation_id}/revoke"
tags: ["Team"]
---

# Revoke a team invitation

`POST /profile/team/invitations/{invitation_id}/revoke`

## Request

- Base URL: `https://api.leakradar.io`
- URL: `https://api.leakradar.io/profile/team/invitations/{invitation_id}/revoke`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/leakradar/apis/leakradar-io-api/docs/profile/team/invitations/:invitation_id/revoke/post.ts> (a function with typed inputs; its response is checked against the schema)

Revoke a pending invitation. The invited user will no longer be able to accept it.

## Path parameters

- `invitation_id` integer, required: ID of the team invitation.

## Response `200`

Invitation revoked

- TeamInvitationResponse
  - `id` integer, required: Invitation ID.
  - `invited_email` string, email, required: Email address of the invited user.
  - `invited_name` string, nullable: Name of the invited user.
  - `role` string, required: Assigned role: 'member' or 'admin'.
  - `status` string, required: Invitation status: 'pending', 'accepted', 'revoked', or 'expired'.
  - `expires_at` string, date-time, required: Expiration date of the invitation.
  - `created_at` string, date-time, required: Creation date of the invitation.
  - `invited_by` TeamInvitationActor
    - `id` integer, required
    - `email` string, email, required
    - `first_name` string, nullable
    - `last_name` string, nullable
  - `accepted_user_id` integer, nullable: ID of the user who accepted the invitation.
  - `token` string, nullable: Invitation token (only returned on creation).

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Validation Error

## Changes

- **2026-09-01** `82a99c608e1a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/leakradar/apis/leakradar-io-api/changes/profile/team/invitations/:invitation_id/revoke/post.md)

---

[API](https://skmtc.dev/leakradar/apis/leakradar-io-api.md) - [All operations](https://skmtc.dev/leakradar/apis/leakradar-io-api/llms.txt) - [OpenAPI document](https://skmtc.dev/leakradar/apis/leakradar-io-api/revisions/8dcd4b54cc4a?raw)