---
title: "Revoke access to a secret incident"
method: POST
path: "/v1/incidents/secrets/{incident_id}/revoke_access"
tags: ["Internal Secret Incidents"]
deprecated: true
---

# Revoke access to a secret incident

`POST /v1/incidents/secrets/{incident_id}/revoke_access`

> **Deprecated.**

Revoke access of a user, an existing invitee or a team to a secret incident.

DEPRECATED: This endpoint has been replaced by [this one](#tag/Members/operation/revoke-member-resource-access) for members, [this one](#tag/Teams/operation/revoke-team-resource-access) for teams, and [this one](#tag/Invitations/operation/revoke-invitation-resource-access) for invitations.

## Path parameters

- `incident_id` integer, required

## Request body

- object
  - `email` string — Email address of a user or invitee. This parameter is mutually exclusive with `member_id`, `invitation_id` and `team_id`.
  - `member_id` number — Id of a member. This parameter is mutually exclusive with `email`, `invitation_id` and `team_id`.
  - `invitation_id` number — Id of an invitation. This parameter is mutually exclusive with `email`, `member_id` and `team_id`.
  - `team_id` number — Id of a team, except for the global team. This parameter is mutually exclusive with `email`, `member_id` and `invitation_id`.

## Response `204`

The access was revoked successfully.

## Other responses

- `400` — Invalid data
- `401` — Invalid API key
- `403` — Permission denied
- `409` — Data conflict
- `503` — API under maintenance

---

[API](https://skmtc.net/gitguardian/apis/gitguardian-api.md) · [All operations](https://skmtc.net/gitguardian/apis/gitguardian-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitguardian/gitguardian-api/revisions/511b067cdcb1/schema)