> ## Documentation Index
> Fetch the complete documentation index at: https://docs.anivahealth.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remover painéis

> Remover painéis de análise ao sangue de uma marcação

Remove um ou mais painéis de análise ao sangue de uma marcação existente. Isto elimina os snapshots de análises planeadas associados aos painéis especificados.

A remoção é idempotente: os painéis que não estão associados são ignorados em vez de rejeitados. Consulta [Idempotência](https://docs.anivahealth.com/pt/concepts/idempotency.md).

Requer o âmbito `appointments_schedule` ou `appointments_manage`.

> [!WARNING]
>
> Os painéis não podem ser removidos depois de chamares [Confirmar colheita de
> sangue](https://docs.anivahealth.com/pt/api/appointments/confirm-blood-draw.md). Tentar remover painéis de uma marcação confirmada
> devolve `409 Conflict`.

Numa colheita capilar (`draw_method: capillary`), os biomarcadores individuais são colocados em
microtainers com os painéis. Se o conjunto restante violar a regra dos 150 µl de
[Adicionar biomarcadores individuais](https://docs.anivahealth.com/pt/api/appointments/add-individual-biomarkers.md), a chamada
devolve `400` com uma mensagem `error` e nenhum painel é removido.

## Pedido

### Parâmetros de caminho

**id** `string` *required*

Identificador único (UUID) da marcação da qual remover painéis.

### Parâmetros do corpo

**panel\_ids** `string[]` *required*

Array de UUIDs de painéis a remover da marcação. Deve conter pelo menos um elemento. Um painel que
não esteja associado é ignorado.

## Resposta

Em caso de sucesso, a API devolve `200 OK` a confirmar que os painéis foram removidos.

**success** `boolean`

`true` quando os painéis foram removidos da marcação com sucesso.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `400` | Erro de validação — por exemplo, `panel_ids` está vazio ou contém um UUID inválido — ou, numa colheita capilar, os biomarcadores individuais já não cabem nos seus microtainers. |
| `403` | Proibido — a tua chave de API não tem acesso a esta operação. |
| `404` | Marcação não encontrada. |
| `409` | Conflito — os painéis não podem ser removidos depois de a colheita de sangue ter sido confirmada. |
| `500` | Erro interno do servidor. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/panels \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_ids": [
      "d4e5f6a7-b8c9-4d1e-a2f3-b4c5d6e7f8a9"
    ]
  }'
```

```json 200 theme={null}
{
  "success": true
}
```

```json 409 theme={null}
{
  "error": "Panels cannot be removed after blood draw has been confirmed"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.