---
title: "DELETE | Disable credential"
slug: "api-del-disable-credential"
updated: 2026-11-03T14:48:27Z
published: 2026-11-03T14:48:27Z
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 | Disable credential

Disable a credential in **PAM Core**.

## Prerequisites

- Authorization with **access** and **read and write** permission to **PAM Core** granted by the administrator in **A2A**.  

More information in [How to manage authorizations in A2A](/v4-2/docs/how-to-manage-authorizations-in-a2a)
- An enabled credential in **PAM Core**.  

More information in [PUT | Enable credential](/v4-2/docs/api-put-enable-credential).

## Disable credential by `id` - Request

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

## Request parameters

Send the parameter below in the **path** of the URL.

- `id` - **int** - required - Unique identification code of the credential.  

**Note**: this value is automatically assigned by Segura™ in [POST | Create SSH key](/v4-2/docs/api-post-create-ssh-key) and is obtained in the response to the [` GET` `/api/pam/credential`](/v4-2/docs/api-get-list-all-credentials) which lists all credentials accessible to your authorization.

### Example request

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

## Response

```
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
    }
}
```

## Disable credential by `username@hostname` - Request

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

## Request parameters

Send the parameter below in the **path** of the URL.

- <summary data-tomark-pass=""><code data-tomark-pass="">username@hostname</code> - <b data-tomark-pass=""><b data-tomark-pass="">int</b></b> - <span style="color:red" data-tomark-pass=""> required</span> - <code data-tomark-pass="">username</code> and  <code data-tomark-pass="">hostname</code> associated with the credential separated by an @ symbol. </summary>**Note**: these values are provided by the user in [POST | Create credential](/v4-2/docs/api-post-create-credential)  and are obtained in the response to the  [GET | List all credentials](/v4-2/docs/api-get-list-all-credentials) request. 

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

### Example request

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

### Response

```
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
    }
}
```

## Errors

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

---

**Message: "1007: Credential not found"**

**Possible cause**: the credential wasn’t found.

**Solution**: check if the values for the parameters used to search for the credential were correct and resend the request.

---

 

**Message: "1008: Credential inactive"**

**Possible cause**: the credential is already inactive.

---

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

**Possible cause**: you’re not authorized to access the credential.

**Solution**: ask the administrator to check your permission to access the credential.

---

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

**Possible cause**: the value for the `id` parameter doesn’t belong to a credential.

**Solution**: check the `id` and resend the request.

---

**Message: "1039: Without PAM Configuration Access permission"** **Possible cause**: your authorization doesn’t have permission to disable a device.

**Solution**: ask the administrator to check your **read and write** permission to **PAM Core** resources in **A2A**.

---

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

---

**Message: "Resource sub not found"**

**Possible cause**: the URL or the requested resource isn’t correct.

**Solution**: check the URL and make sure the parameter is correct.

---

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

---

**Message: "Unexpected error."**

**Possible cause**: the error is in the Segura™ server.

**Solution**: contact the support team for more information.

---

**Message: "You are not authorized to access this resource."**

**Possible cause**: you don’t have the authorization to access this resource.

**Solution**: ask the administrator to check your permission to access the **PAM Core** resources in **A2A**.

---

    

****Client authentication failed****

---

**Message: "Client authentication failed."**

**Possible cause**: failure in your application authentication with the Segura™ server.

**Solution**: check the authentication parameters such as `Access Token URL`, `Client ID` e `Client secret` and request a new access token.

---

****Invalid signature****

---

**Message: "Invalid signature"**

**Possible cause**: failure in recognizing the URL of the client application.

**Solution**: check the URL of the client application and resent the request.

---

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

    

---

**Message: "No route matched with those values."**

   

**Possible cause**: the authorization header is missing in the API request.

**Solution**: request a new access token.

---

****Request timed out****

    

---

**Message: "Request timed out."**

**Possible cause**: the request time has expired.

**Solution**: check the connectivity between the source of the request and the Segura™ server.