> ## 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.

# Adicionar biomarcadores individuais

> Adicionar biomarcadores avulso a uma encomenda de kit de teste em casa

Adiciona um ou mais biomarcadores avulso a uma encomenda de kit de teste em casa existente, fora de qualquer painel predefinido. Este endpoint é idempotente — os biomarcadores já associados são mantidos.

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]
>
> Só é possível adicionar biomarcadores 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 enviado. Os kits `activated` e `cancelled` também ficam 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) da encomenda de kit de teste em casa à qual adicionar biomarcadores.

### Parâmetros do corpo

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

Array de identificadores de biomarcadores a adicionar à encomenda de kit de teste em casa. Tem de conter pelo menos um item. Usa
[Listar biomarcadores](https://docs.anivahealth.com/pt/api/biomarkers/list-biomarkers.md) com `home_kit=true` para descobrir os IDs dos biomarcadores.

## Resposta

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

**success** `boolean`

`true` quando os biomarcadores foram adicionados com sucesso à encomenda de kit de teste em casa.

## Respostas de erro

| Estado | Descrição |
| - | - |
| `400` | Erro de validação — por exemplo, `biomarker_ids` está vazio ou contém um valor inválido. |
| `403` | Proibido — falta o âmbito `home_kit_orders_manage` ou o âmbito de capacidade `home_kit_orders_individual_biomarker_selection`, ou a encomenda de kit de teste em casa está fora do teu âmbito de permissões. |
| `404` | Encomenda de kit de teste em casa ou um ou mais biomarcadores não encontrados. |
| `409` | Conflito — o kit está `dispatched`, `activated` ou `cancelled`; a sua composição de painéis e biomarcadores está bloqueada e já não pode ser alterada. |
| `500` | Erro interno do servidor. |

```bash cURL theme={null}
curl --request PATCH \
  --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, 87]
  }'
```

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

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


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