---
title: "DELETE | Liberar custódia de credencial"
slug: "api-del-release-credential-custody"
updated: 2026-09-04T13:27:54Z
published: 2026-09-04T13:27:54Z
canonical: "docs.senhasegura.io/api-del-release-credential-custody"
stale: true
---

> ## 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 | Liberar custódia de credencial

Libere a custódia de uma credencial no **PAM Core**.

---

Quando um usuário realiza uma chamada ` GET` `/api/pam/credential[id]` para visualizar uma credencial, isso é chamado de concessão temporária de custódia dessa credencial ao usuário, também conhecido como *account check-out*.

Quando o acesso a essa credencial é revogado, isso é descrito como a liberação da custódia da credencial, também conhecido como *account check-in*.

Saiba mais sobre o conceito de custódia de credencias em [Sobre a custódia de credenciais](/v4-2/docs/pt/pam-credential-about-credential-custody).

---

## Pré-requisitos

- Autorização com permissão de **acesso** 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).
- Custódia de uma credencial solicitada via API através do endpoint ` GET` `/api/pam/credential[id]`. Saiba mais em [GET | Listar uma credencial](/v4-2/docs/pt/api-get-list-a-credential).

## Requisição

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

## Parâmetros de requisição

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

- <summary data-tomark-pass=""><code data-tomark-pass="">id</code> - <b data-tomark-pass="">int</b> - <span style="color:red" data-tomark-pass=""> obrigat&#xf3;rio</span> - C&#xf3;digo &#xfa;nico de identifica&#xe7;&#xe3;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/custody/94`

## Resposta

```
HTTP/1.1 200 OK
```

```
{
    "code": 200,
    "response": {
        "status": 200,
        "message": "Credential custody 94 released",
        "error": false,
        "error_code": 0,
        "detail": "",
        "mensagem": "Credential custody 94 released",
        "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 o valor do `id` e envie a requisição novamente.

---

  

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

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

**Solução**: ative a credencial através do endpoint ` PUT` `/api/pam/credential/[id]` e envie a requisição novamente.

---

**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: "1018: The credential is not in the user custody"**

**Possível causa**: usuário não possui a custódia da credencial.

**Solução**: consulte a credencial através do endpoint ` GET` `/iso/pam/credential[id]` e após o sucesso dessa chamada, 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®.