> ## 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 biomarcadores individuais

> Remover biomarcadores individuais de uma marcação

Remove um ou mais biomarcadores individuais do conjunto à la carte de uma marcação.

O conjunto de biomarcadores após a remoção é validado segundo as regras de fecho de cada
laboratório: uma remoção pode deixar o conjunto incompleto (por exemplo, retirar o LDL mantendo o
rácio LDL/HDL). Quando isso acontece, o pedido devolve `400` com opções de recuperação estruturadas
e nada é removido. Consulta [Adicionar biomarcadores
individuais](https://docs.anivahealth.com/pt/api/appointments/add-individual-biomarkers.md) para veres a estrutura do payload
`validation`.

A remoção é idempotente: os biomarcadores 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`, mais `schedule_appointments_with_individual_biomarker_selection`.

> [!WARNING]
>
> Os biomarcadores não podem ser removidos depois de chamares [Confirmar colheita de
> sangue](https://docs.anivahealth.com/pt/api/appointments/confirm-blood-draw.md).

## Pedido

### Parâmetros de caminho

**id** `string` *required*

Identificador único (UUID) da marcação.

### Parâmetros do corpo

**biomarker\_ids** `number[]` *required*

Array de IDs de biomarcadores a desassociar. Deve conter pelo menos um elemento. Um ID que não
esteja na marcação é ignorado.

## Resposta

**success** `boolean`

`true` quando os biomarcadores foram removidos com sucesso.

## Respostas de erro

A remoção nunca devolve `biomarker_not_priced`. O preço de um marcador não depende do resto do
conjunto. Um conjunto que já tenha um marcador sem preço continua editável. Consulta [Adicionar
biomarcadores individuais](https://docs.anivahealth.com/pt/api/appointments/add-individual-biomarkers.md).

| Estado | Descrição |
| - | - |
| `400` | `biomarker_ids` vazio / não inteiro, o conjunto após a remoção falha a validação de fecho (`validation.failures`), ou a remoção deixaria isolado um biomarcador vendido apenas dentro de uma posição (`error: "biomarker_requires_position"`). |
| `403` | Proibido — âmbito em falta ou marcação fora do contexto de acesso. |
| `404` | Marcação não encontrada. |
| `409` | Conflito — os biomarcadores não podem ser modificados 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/biomarkers \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "biomarker_ids": [42]
  }'
```

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

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


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