Skip to main content
DELETE
/
api
/
v1
/
appointments
/
{id}
/
custom-snapshot
curl --request DELETE \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/custom-snapshot \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_id": "00000000-0000-0000-0000-000000000aff",
    "biomarker_ids": [42]
  }'

{
  "success": true
}
Remove one or more individual biomarkers from an appointment under a chosen custom container panel.
Breaking change (ENG-1243, 2026-05-11) — the request body now requires panel_id. Pass the UUID of the same custom panel you originally wrote the biomarkers under.
Panel nameUUIDRoutes to
Aniva Custom ZotzKlimas00000000-0000-0000-0000-000000000affZotzKlimas
Aniva Custom Labclinic00000000-0000-0000-0000-000000000bffLabclinic
When the chosen panel routes exclusively to a single lab — Aniva Custom ZotzKlimas (ZK) or Aniva Custom Labclinic (LC) — the server validates that the post-removal biomarker set remains orderable at that lab as a coherent combination. Removing a biomarker that would leave an incoherent residual order (e.g. dropping LDL while keeping LDL/HDL Ratio) is rejected with 400 and a multi-candidate explanation listing the missing biomarkers per orderable option (see the example 400 responses below). 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

​
id
string
required
Unique identifier (UUID) of the appointment.

​
Body parameters

​
panel_id
string
required
UUID of the is_custom=true panel to remove biomarkers from. Must match the panel you used when adding them. Must be a custom panel reachable via your API key.
​
biomarker_ids
number[]
required
Array of biomarker IDs to detach. Must contain at least one item, and every ID must currently be on the appointment.

​
Response

​
success
boolean
true when the biomarkers have been successfully removed.

​
Error responses

StatusDescription
400Validation error — panel_id missing, or the lab’s order-requirements validator (ZK or LC) rejected the post-removal set.
403Forbidden — missing scope, appointment outside access context, or the requested custom panel is not reachable.
404Appointment not found, or one or more biomarkers not associated with the appointment.
409Conflict — biomarkers cannot be modified after the blood draw has been confirmed.
500Internal server error.
curl --request DELETE \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a/custom-snapshot \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "panel_id": "00000000-0000-0000-0000-000000000aff",
    "biomarker_ids": [42]
  }'

{
  "success": true
}