Skip to main content
DELETE
/
medical
/
v1
/
cohort
/
{id}
/
patient
Remove Patients from Cohort
curl --request DELETE \
  --url https://api.sandbox.metriport.com/medical/v1/cohort/{id}/patient \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "patientIds": [
    "<string>"
  ],
  "allPatients": true
}'
import { MetriportMedicalApi } from "@metriport/api-sdk";

const metriport = new MetriportMedicalApi("YOUR_API_KEY");

// Remove specific patients from cohort
const result = await metriport.removePatientsFromCohort({
  cohortId: "00000000-0000-0000-0000-000000000000",
  patientIds: [
      "11111111-1111-1111-1111-111111111111",
      "22222222-2222-2222-2222-222222222222",
  ],
});

// Remove all patients from cohort
const resultAll = await metriport.removePatientsFromCohort({
  cohortId: "00000000-0000-0000-0000-000000000000",
  allPatients: true
});
For more information, see the guide about Cohorts

Path Params

id
string
required
The ID of the cohort to remove patients from.

Body

You must provide either patientIds or allPatients, but not both.
patientIds
string[]
Array of patient IDs to remove from the cohort. Mutually exclusive with the allPatients property.
allPatients
boolean
Property to confirm you want to remove all patients in your metriport instance from the cohort. Mutually exclusive with the patientIds array.

Response

message
string
required
Confirmation message indicating the operation was successful.
cohort
cohort
required
The cohort details.
import { MetriportMedicalApi } from "@metriport/api-sdk";

const metriport = new MetriportMedicalApi("YOUR_API_KEY");

// Remove specific patients from cohort
const result = await metriport.removePatientsFromCohort({
  cohortId: "00000000-0000-0000-0000-000000000000",
  patientIds: [
      "11111111-1111-1111-1111-111111111111",
      "22222222-2222-2222-2222-222222222222",
  ],
});

// Remove all patients from cohort
const resultAll = await metriport.removePatientsFromCohort({
  cohortId: "00000000-0000-0000-0000-000000000000",
  allPatients: true
});
{
  "message": "Patient(s) successfully removed from cohort",
  "cohort": {
    "id": "00000000-0000-0000-0000-000000000000",
    "eTag": "1",
    "name": "High Risk",
    "description": "Patients that need frequent and robust monitoring.",
    "color": "red",
    "settings": {
      "monitoring": {
        "hie": {
          "enabled": false,
          "frequency": "monthly"
        },
        "adt": {
          "enabled": true
        },
        "pharmacy": {
          "notifications": true,
          "schedule": {
            "enabled": false,
            "frequency": "monthly"
          }
        },
        "laboratory": {
          "notifications": true,
          "schedule": {
            "enabled": false,
            "frequency": "monthly"
          }
        }
      }
    },
    "size": 250
  }
}