---
title: "DELETE | Desativar usuário relacionado"
slug: "api-del-disable-related-user"
updated: 2026-03-04T12:05:18Z
published: 2026-03-04T14:50:13Z
canonical: "docs.senhasegura.io/api-del-disable-related-user"
---

> ## 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 usuário relacionado

Inative um usuário relacionado no **Segura®**.

## Pré-requisitos

- Autorização com permissão de **acesso** ao recurso **Usuários** concedida pelo administrador no **A2A**.  

Saiba mais em [Como gerenciar autorizações no A2A](/v4-2/docs/pt/how-to-manage-authorizations-in-a2a).
- Usuário relacionado ativo.

## Requisição

` DELETE` `/api/user/related/[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ório</span> - Código único de identificação do usuário relacionado.</summary>
**Nota**: Esse valor é automaticamente atribuído pelo Segura® em [POST | Criar usuário relacionado](/v4-2/docs/pt/api-post-create-related-user) e é obtido na resposta da requisição [GET | Listar todos os usuários relacionados](/v4-2/docs/pt/api-get-list-all-related-users).

### Exemplo de requisição

` DELETE` `{{url}}/api/user/related/4`

## Resposta

```
HTTP/1.1 200 OK
```

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

          Info

          

Caso o usuário relacionado já tenha sido inativado previamente, a chamada retornará uma resposta de código `200` com a mensagem `Related user has already been deactivated`.

## Erros

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

---

**Mensagem: "1005: User does not exist"**

**Possível causa**: o `id` informado não encontrou um usuário cadastrado no Segura®.

**Solução**: informe um `id` válido e envie a requisição novamente.

---

****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 garanta que todos os parâmetros estão corretos.

---

****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 **Usuários** 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 URL`, `Client ID` e `Client secret` e solicite um novo token de acesso.

****Invalid signature**.**

---

**Mensagem: "Invalid signature"**

**Possível causa**: falha no reconhecimento da URL da aplicação cliente.

**Solução**: verifique a URL da aplicação cliente e envie a requisição novamente.

---

****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®.