---
title: "DELETE | Excluir política de acesso por [id]"
slug: "api-v2-delete-access-policy"
updated: 2026-11-03T14:47:51Z
published: 2026-11-03T14:47:51Z
canonical: "docs.senhasegura.io/api-v2-delete-access-policy"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senhasegura.io/llms.txt
> Use this file to discover all available pages before exploring further.

# DELETE | Excluir política de acesso por [id]

## Descrição

Exclua uma política de acesso no PAM Core. A operação é uma exclusão lógica (*soft delete*).

Uma política ainda vinculada a um ou mais grupos de usuários não pode ser excluída, a requisição é rejeitada com `409`. Remova a política de todos os grupos de usuários que a referenciam antes de chamar este endpoint.

Atenção

Excluir uma política remove o acesso que ela concede. Antes de excluir, confirme que nenhum usuário ainda depende da política para acesso privilegiado. Para suspender a política temporariamente, utilize [POST | Desativar política de acesso](/v4-2/docs/pt/api-v2-post-deactivate-access-policy).

---

## Pré-requisitos

- Uma aplicação com a autorização **Access Policy (V2)** concedida pelo administrador no A2A, com a **Permissão do recurso PAM** definida como **Leitura e escrita**. Para mais informações, acesse [Como gerenciar autorizações no A2A](/v4-2/docs/pt/how-to-manage-authorizations-in-a2a).
- Um token de acesso OAuth 2.0 válido. Para mais informações, acesse [Como autenticar uma aplicação A2A](/v4-2/docs/pt/how-to-authenticate-an-application-in-a2a).
- O valor atual do `ETag` da política de acesso, retornado por [GET | Listar uma política de acesso por [id]](/v4-2/docs/pt/api-v2-get-list-an-access-policy) e por todas as operações de escrita na política.
- Nenhum grupo de usuários pode ainda referenciar a política de acesso.

Info

Um token de acesso carrega apenas as autorizações que existiam no momento em que foi gerado. Depois que o administrador habilitar a autorização **Access Policy (V2)**, gere um novo token para a aplicação um token existente não passa a ter a nova autorização.

---

## Requisição

`DELETE` `/api/v2/pam/access-policies/{id}`

### Parâmetros de caminho

| Campo | Tipo | Obrigatório | Descrição |
| --- | --- | --- | --- |
| `id` | integer | Sim | Código de identificação único da política de acesso. **Nota:** este valor é atribuído pelo Segura™ em [POST \| Criar política de acesso](/v4-2/docs/pt/api-v2-post-create-access-policy). |

---

### Exemplo de requisição

`DELETE` `{{url}}/api/v2/pam/access-policies/3001`

#### Cabeçalhos

```
If-Match: "v3"
```

---

## Resposta

```
HTTP/1.1 204 No Content
```

A resposta não tem corpo.

---

## Erros

| Código HTTP | Mensagem | Causa possível | Solução |
| --- | --- | --- | --- |
| `401` | `api.auth.token.invalid` | O token de acesso está ausente ou expirou. | Solicite um novo token de acesso. |
| `403` | `api.permission.denied` | A autorização não tem permissão para excluir políticas de acesso. | Peça ao administrador para verificar a autorização **Access Policy (V2)** e a **Permissão do recurso PAM** no A2A e gere um novo token. |
| `404` | `api.resource.not_found` | A política de acesso não existe ou está fora do escopo da autorização. | Verifique o código de identificação enviado no caminho. |
| `409` | `api.resource.in_use` | A política de acesso ainda está vinculada a um ou mais grupos de usuários. | Remova a política de todos os grupos de usuários que a referenciam e reenvie a requisição. |
| `412` | `api.precondition.failed` | O valor de `If-Match` não corresponde à versão atual da política, o que significa que a política foi alterada depois de ser lida. | Obtenha a política novamente com [GET \| Listar uma política de acesso por [id]](/v4-2/docs/pt/api-v2-get-list-an-access-policy), revise as alterações e reenvie a requisição com o novo `ETag`. |
| `429` | `rate_limit_exceeded` | O limite de requisições foi excedido. | Reduza a frequência de requisições e tente novamente. |
| `500` | `api.internal.error` | Erro interno do servidor. | Entre em contato com a equipe de suporte da Segura™. |

### Exemplo de resposta de erro

`409` a política ainda está vinculada a grupos de usuários:

```
{
    "error": {
        "code": "api.resource.in_use",
        "message": "Access policy is linked to user groups and cannot be deleted."
    }
}
```

Para mensagens de erros de autenticação e a política de `403` versus `404`, acesse [API v2 - Convenções e comportamentos compartilhados](/v4-2/docs/pt/api-v2-conventions-and-shared-behaviors).