[Admin] Desabilitar nominal (soft)

DELETE

/api/admin/nominais/{{nominal_id}}

Autenticação

Requer papel ADMIN. Authorization: Bearer {{admin_api_key}}.

[Admin] Desabilitar nominal (soft delete)

Desabilita a nominal (isActive = false) — não apaga o registro nem o histórico. Ela some do catálogo do usuário, mas mantém integridade referencial.

Path

Param	Descrição
`{{nominal_id}}`	Id da nominal a desabilitar.

Resposta

200 OK com { nominal: { ... isActive: false } }.

Erros

HTTP	`code`	Quando
401 / 403	—	Sem credencial ADMIN.
404	—	Nominal não encontrada.
422	`NOMINAL_IS_DEFAULT`	É a nominal padrão. Defina outra como padrão antes de desabilitar.

Exemplo cURL

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Respostas

🟢200

application/json

Bodyapplication/json

🟠422

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff --request DELETE '/api/admin/nominais/{{nominal_id}}' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Desabilitada (200)

{
  "nominal": {
    "id": "{{nominal_id}}",
    "slug": "hub",
    "isActive": false
  }
}

Modificado em 2026-07-14 04:02:21

Página anterior

[Admin] Editar nominal

Próxima página

[Admin] Acesso e taxas por usuário

[Admin] Desabilitar nominal (soft)

Autenticação#

[Admin] Desabilitar nominal (soft delete)#

Path#

Resposta#

Erros#

Exemplo cURL#