Remove Individual Biomarkers

DELETE

api

appointments

{id}

biomarkers

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]
  }'

{
  "success": true
}

{
  "error": "Biomarkers not associated with this appointment: 42"
}

Remove one or more individual biomarkers from an appointment’s à-la-carte set. The post-removal biomarker set is validated against each lab’s closure rules: a removal can strand the set (e.g. dropping LDL while keeping the LDL/HDL ratio). When it does, the request returns 400 with structured recovery options and nothing is removed. See Add Individual Biomarkers for the shape of the validation payload. Every ID in biomarker_ids must currently be attached to the appointment — otherwise the request returns 404.

Biomarkers cannot be removed after you call Confirm Blood Draw.

Request

Path parameters

string

required

Unique identifier (UUID) of the appointment.

Body parameters

number[]

required

Array of biomarker IDs to detach. Must contain at least one item, and every ID must currently be on the appointment.

Response

boolean

true when the biomarkers have been successfully removed.

Error responses

Status	Description
`400`	`biomarker_ids` empty / non-integer, or the post-removal set fails closure validation (`validation.failures`).
`403`	Forbidden — missing scope or appointment outside access context.
`404`	Appointment not found, or one or more biomarkers not associated with the appointment.
`409`	Conflict — biomarkers cannot be modified after the blood draw has been confirmed.
`500`	Internal server error.

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]
  }'

{
  "success": true
}

{
  "error": "Biomarkers not associated with this appointment: 42"
}

Add Individual Biomarkers

Preview Containers

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]
  }'

{
  "success": true
}

{
  "error": "Biomarkers not associated with this appointment: 42"
}

Health

Profiles

Appointments

Home Kit Orders

Biomarkers

Panels

Units

Locations

Documents

Shipments

Remove Individual Biomarkers

Request

Path parameters

Body parameters

Response

Error responses

​Request

​Path parameters

​Body parameters

​Response

​Error responses

Request

Path parameters

Body parameters

Response

Error responses