Delete Location

Soft-deletes a Location by setting its status to DELETED and recording the deletion timestamp. A Location can only be deleted if its status is ACTIVE. If the Location is IN_USE (bound to a charge), it must be unbound first. Requires Idempotency-Key header.

Path Parameters

id
Type: string Format: uuid
required

Unique identifier of the location to delete

Responses

204

Location deleted successfully

Código interno	HTTP	Descrição	Erro normativo Bacen
`PIX-0001`	400	Headers x-branch and x-account-number are required	`PixConsultaInvalida`

application/json

403

Access denied — the credential does not carry the scope required by this operation, or the client certificate was rejected. Answered at the exposure gateway (Bacen: AcessoNegado).

Código interno	HTTP	Descrição	Erro normativo Bacen
`LOCATION-0001`	404	Location not found	`PayloadLocationNaoEncontrado`

application/json

application/json
503

Service temporarily unavailable (Bacen: ServicoIndisponivel).

Código interno	HTTP	Descrição	Erro normativo Bacen
`LOCATION-0002`	409	Location cannot be deleted while IN_USE. Unbind the dynamic QR Code first.	`PayloadLocationOperacaoInvalida`

Código interno	HTTP	Descrição	Erro normativo Bacen
`LOCATION-0003`	410	Location is already deleted.	`PermanentementeRemovido`

delete/api/loc/{id}

curl http://localhost:8080/api/loc/2a8cbd7d-0c7b-4a69-a1e1-4a19e8b7a2aa \
  --request DELETE \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

No Body

Location deleted successfully