> ## 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 avulso de uma encomenda de kit de teste em casa

Remove um ou mais biomarcadores avulsos de uma encomenda de kit de teste em casa existente. A remoção é idempotente: os biomarcadores que não estejam associados são ignorados em vez de rejeitados. Consulta [Idempotência](https://docs.anivahealth.com/pt/concepts/idempotency.md).

Requer o âmbito `home_kit_orders_manage` e o âmbito de capacidade
`home_kit_orders_individual_biomarker_selection`. Os kits de teste em casa são encomendados por painel,
pelo que os marcadores individuais são ativados por parceiro. Pede à Aniva se a tua integração precisar.

> [!WARNING]
>
> Os biomarcadores só podem ser removidos enquanto o kit estiver `pending`. Assim que o kit estiver `dispatched`, a sua
> composição fica bloqueada e esta chamada devolve `409 Conflict` — o kit físico é enviado com um número
> fixo de tubos definido pelos painéis e biomarcadores selecionados, pelo que o seu conteúdo não pode mudar
> depois de ser enviado. Os kits `activated` e `cancelled` ficam igualmente bloqueados. Se precisares de
> alterar as análises de um kit bloqueado, contacta diretamente a Aniva — normalmente ainda é possível e
> fazemos a alteração por ti para manter o conteúdo do kit consistente.

## Pedido

### Parâmetros de caminho

**id** `string` *required*

Identificador único (UUID) do pedido de kit de teste em casa do qual remover biomarcadores.

### Parâmetros do corpo

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

Array de identificadores de biomarcadores a remover do pedido de kit de teste em casa. Tem de conter pelo menos um elemento.

## Resposta

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

**success** `boolean`

`true` quando os biomarcadores foram removidos com sucesso do pedido de kit de teste em casa.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `400` | Erro de validação — por ex., `biomarker_ids` está vazio ou contém um valor inválido. |
| `403` | Proibido — falta o scope `home_kit_orders_manage` ou o scope de capacidade `home_kit_orders_individual_biomarker_selection`, ou o pedido de kit de teste em casa está fora do teu âmbito de permissões. |
| `404` | Pedido de kit de teste em casa não encontrado. |
| `409` | Conflito — o kit está em `dispatched`, `activated` ou `cancelled`; o seu painel e a sua composição de biomarcadores estão bloqueados e já não podem ser alterados. |
| `409` | Conflito — estes são os únicos marcadores que um kit de substituição volta a analisar; removê-los não deixaria nada para pedir. |
| `500` | Erro interno do servidor. |

```bash cURL theme={null}
curl --request DELETE \
  --url https://anivahealth.com/api/v1/home-kit-orders/d1e2f3a4-5b6c-4d7e-8f9a-0b1c2d3e4f5a/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": "Home kit order not found"
}
```


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