---
title: "DELETE | Desativar credencial"
slug: "api-del-disable-credential"
updated: 2026-03-16T13:51:06Z
published: 2026-03-16T13:51:06Z
canonical: "docs.senhasegura.io/api-del-disable-credential"
---

> ## 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 | Desativar credencial

Inative uma credencial no **PAM Core**.

## Requisitos

- Autorização com permissão de **acesso** e de **leitura e escrita** ao **PAM Core** concedidas pelo administrador no **A2A**.  

Saiba mais em [Como gerenciar autorizações no A2A](/v4-2/docs/pt/how-to-manage-authorizations-in-a2a).
- Uma credencial ativa no **PAM Core**.  

Saiba mais em [POST | Criar credencial](/v4-2/docs/pt/api-post-create-credential) e [PUT | Ativar credencial](/v4-2/docs/pt/api-put-enable-credential).

## Desativar credencial por `id` - Requisição

` DELETE` `/api/pam/credential/[id]`

### Parâmetros de requisição

Envie o parâmetro abaixo no **path** da URL.

- <summary><code>id</code> - <b>int</b> - <span style="color:red"> obrigatório</span> - Código único de identificação da credencial.</summary>

**Nota**: esse valor é automaticamente atribuído pelo Segura em [POST | Criar credencial](/v4-2/docs/pt/api-post-create-credential) e é obtido na resposta da requisição [GET | Listar todas as credenciais](/v4-2/docs/pt/api-get-list-all-credentials).

### Exemplo de requisição

` DELETE` `{{url}}/api/pam/credential/5`

## Resposta

```
HTTP/1.1 200 OK
```

```
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "Credential successfully deactivated",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "Credential successfully deactivated",
        "erro": false,
        "cod_erro": 0
    }
}
```

## Desativar credencial por `username@hostname` - Requisição

` DELETE` `/api/pam/credential/[username@hostname]`

### Parâmetros da requisição

Envie o parâmetro abaixo no **path** da URL.

- <summary><code>username@hostname</code> - <b>string</b> - <span style="color:red"> obrigatório</span> - Nome de usuário (<code>username</code>) e nome do host do dispositivo (<code>hostname</code>) associados à credencial separados por um sinal de @.</summary> 

**Nota**: esses valores são informados pelo usuário em [POST | Criar credencial](/v4-2/docs/pt/api-post-create-credential) e são obtidos na resposta da requisição [GET | Listar todas as credenciais](/v4-2/docs/pt/api-get-list-all-credentials).

**Exemplo**: `credential_5@destktop-91.com`

  

Atenção

Caso o `username` fornecido possua um @, como em `johndoe@Segura`, o endpoint não funcionará como esperado devido ao conflito gerado pela presença de dois símbolos @ no endpoint.

### Exemplo de requisição

` DELETE` `{{url}}/api/pam/credential/credential_5@destktop-91.com`

## Resposta

```
HTTP/1.1 200 OK
```

```
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "Credential successfully deactivated",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "Credential successfully deactivated",
        "erro": false,
        "cod_erro": 0
    }
}
```

## Erros

****400 - Bad Request****

---

 **Mensagem: "1007: Credential not found"**

 

**Possível causa**: a credencial não foi encontrada. **Solução**: verifique se os valores dos parâmetros usados para buscar pela credencial estão corretos e envie a requisição novamente.

---

**Mensagem: "1008: Credential inactive"**

**Possível causa**: a credencial já está inativa.

---

**Mensagem: "1009: No access to credential"**

  
**Possível causa**: sua autorização não possui acesso à credencial. 

   **Solução**: solicite ao administrador que revise sua permissão de acesso à credencial desejada.

---

**Mensagem: "1010: The item is not a credential"**

  
**Possível causa**: o valor do parâmetro `id` não corresponde a uma credencial. 

**Solução**: verifique o `id` e envie a requisição novamente.

---

**Mensagem: "1039: Without PAM Configuration Access permission"**

**Possível causa**: sua autorização não possui permissão de alteração da credencial. 

**Solução**: solicite ao administrador que revise sua permissão de **leitura e escrita** aos recursos do **PAM Core** no **A2A**. 

---

****404 - Not Found****

---

 **Mensagem: "Resource sub not found"**

 

**Possível causa**: a URL ou o recurso solicitado não está correto. **Solução**: verifique a URL e envie a requisição novamente.

---

****500 - Internal Server Error****

---

**Mensagem: "Unexpected error."**  

**Possível causa**: o erro está no servidor Segura. **Solução**: contate o time de suporte para mais informações.

---

**Mensagem: "You are not authorized to access this resource"**

**Possível causa**: você não possui autorização para acessar esse recurso.  

**Solução**: solicite ao administrador que revise sua permissão de acesso aos recursos do **PAM Core** no **A2A**.

---

****Client authentication failed****

---

**Mensagem: "Client authentication failed"**

**Possível causa**: falha na autenticação da sua aplicação com o servidor Segura. **Solução**: verifique os parâmetros de autenticação como `Access Token`, `Client ID` e `Client secret` e solicite um novo token de acesso.

---

****No route matched with those values****

 

---

**Mensagem: "No route matched with those values"**

**Possível causa**: ausência do header de autorização na requisição de API. **Solução**: solicite um novo token de acesso.

---

****Request timed out****

---

**Mensagem: "Request timed out"**

**Possível causa**: o tempo da requisição se esgotou. **Solução**: verifique a conectividade entre a origem da requisição e o servidor Segura.