Update a patient's details

curl --request PUT \
  --url https://api.byblend.com/api/v1/patients/{patient_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "Willard",
  "middle_name": "Moises",
  "last_name": "Donnelly",
  "gender": "male",
  "email": "[email protected]",
  "phone": "6417383445",
  "date_of_birth": "1990-01-01",
  "driver_license_number": "B49188319",
  "driver_license_state": "CA",
  "ssn": "123456789",
  "primary_language": "en",
  "guardian_name": "John Guardian",
  "guardian_phone": "6417383445",
  "guardian_email": "[email protected]",
  "guardian_relationship": "parent",
  "height_inches": 72,
  "weight_pounds": 180,
  "external_id": "1234567890",
  "is_smoker": false,
  "is_diabetic": false,
  "is_pregnant": false,
  "receive_sms": true,
  "receive_email": true,
  "address": {
    "address_1": "140 Lindgren Streets",
    "city": "North Consueloburgh",
    "state": "CA",
    "zip_code": "02108",
    "address_2": "Apt 227",
    "country": "US"
  },
  "risk_factors": {
    "allergies": "peanuts, tree nuts, shellfish",
    "conditions": "asthma, hypertension",
    "medications": "albuterol, levothyroxine"
  }
}
'

{
  "id": "0227d1e5-ba9a-42b5-8fe2-38882aa65708",
  "created_at": "2025-03-15T12:00:00Z",
  "updated_at": "2025-03-15T12:00:00Z",
  "first_name": "Willard",
  "middle_name": "Moises",
  "last_name": "Donnelly",
  "gender": "male",
  "email": "[email protected]",
  "phone": "6417383445",
  "date_of_birth": "1990-01-01",
  "driver_license_number": "B49188319",
  "driver_license_state": "CA",
  "ssn": "123456789",
  "primary_language": "en",
  "guardian_name": "John Guardian",
  "guardian_phone": "6417383445",
  "guardian_email": "[email protected]",
  "guardian_relationship": "parent",
  "height_inches": 72,
  "weight_pounds": 180,
  "external_id": "1234567890",
  "is_smoker": false,
  "is_diabetic": false,
  "is_pregnant": false,
  "receive_sms": true,
  "receive_email": true,
  "address": {
    "address_1": "140 Lindgren Streets",
    "city": "North Consueloburgh",
    "state": "CA",
    "zip_code": "02108",
    "address_2": "Apt 227",
    "country": "US"
  },
  "is_minor": false
}

PUT

api

patients

{patient_id}

Update a patient's details

curl --request PUT \
  --url https://api.byblend.com/api/v1/patients/{patient_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "first_name": "Willard",
  "middle_name": "Moises",
  "last_name": "Donnelly",
  "gender": "male",
  "email": "[email protected]",
  "phone": "6417383445",
  "date_of_birth": "1990-01-01",
  "driver_license_number": "B49188319",
  "driver_license_state": "CA",
  "ssn": "123456789",
  "primary_language": "en",
  "guardian_name": "John Guardian",
  "guardian_phone": "6417383445",
  "guardian_email": "[email protected]",
  "guardian_relationship": "parent",
  "height_inches": 72,
  "weight_pounds": 180,
  "external_id": "1234567890",
  "is_smoker": false,
  "is_diabetic": false,
  "is_pregnant": false,
  "receive_sms": true,
  "receive_email": true,
  "address": {
    "address_1": "140 Lindgren Streets",
    "city": "North Consueloburgh",
    "state": "CA",
    "zip_code": "02108",
    "address_2": "Apt 227",
    "country": "US"
  },
  "risk_factors": {
    "allergies": "peanuts, tree nuts, shellfish",
    "conditions": "asthma, hypertension",
    "medications": "albuterol, levothyroxine"
  }
}
'

{
  "id": "0227d1e5-ba9a-42b5-8fe2-38882aa65708",
  "created_at": "2025-03-15T12:00:00Z",
  "updated_at": "2025-03-15T12:00:00Z",
  "first_name": "Willard",
  "middle_name": "Moises",
  "last_name": "Donnelly",
  "gender": "male",
  "email": "[email protected]",
  "phone": "6417383445",
  "date_of_birth": "1990-01-01",
  "driver_license_number": "B49188319",
  "driver_license_state": "CA",
  "ssn": "123456789",
  "primary_language": "en",
  "guardian_name": "John Guardian",
  "guardian_phone": "6417383445",
  "guardian_email": "[email protected]",
  "guardian_relationship": "parent",
  "height_inches": 72,
  "weight_pounds": 180,
  "external_id": "1234567890",
  "is_smoker": false,
  "is_diabetic": false,
  "is_pregnant": false,
  "receive_sms": true,
  "receive_email": true,
  "address": {
    "address_1": "140 Lindgren Streets",
    "city": "North Consueloburgh",
    "state": "CA",
    "zip_code": "02108",
    "address_2": "Apt 227",
    "country": "US"
  },
  "is_minor": false
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

patient_id

string<uuid>

required

Unique identifier for the patient, either UUID or external ID (e.g. my-patients-128318AA2) if you have provided one during patient creation or a prior update.

Example:

"98cae3a3-996c-4bf5-9143-0ab6d98bc1d0"

Body

application/json

first_name

string

Example:

"Willard"

middle_name

string

Example:

"Moises"

last_name

string

Example:

"Donnelly"

gender

enum<string>

Gender of the patient

Available options:

male,

female

Example:

"male"

string

Example:

"[email protected]"

phone

string

10-digit phone number without formatting, e.g. 6417383445

Example:

"6417383445"

date_of_birth

string<date>

Example:

"1990-01-01"

driver_license_number

string

Example:

"B49188319"

driver_license_state

string

Example:

"CA"

ssn

string

Social Security number. Can be provided with or without hyphens.

Example:

"123456789"

primary_language

string

ISO 639-1 language code

Example:

"en"

guardian_name

string

Name of the patient's guardian. Required if patient is a minor.

Example:

"John Guardian"

guardian_phone

string

Example:

"6417383445"

guardian_email

string

Example:

"[email protected]"

guardian_relationship

string

Relationship of the guardian to the patient. See relationship types lookup for available values; most common are parent and legal_guardian; and other can be used.

Example:

"parent"

height_inches

integer

Height of the patient in inches

Example:

72

weight_pounds

integer

Weight of the patient in pounds

Example:

180

external_id

string

External (your own) ID for the patient, to be used for prescription matching

Example:

"1234567890"

is_smoker

boolean

Whether the patient is a smoker

Example:

false

is_diabetic

boolean

Whether the patient is diabetic

Example:

false

is_pregnant

boolean

Whether the patient is pregnant

Example:

false

receive_sms

boolean

Whether the patient should receive SMS notifications for shipments. This is only applicable if you have authorized Blend to send patient communications on your behalf.

Example:

true

receive_email

boolean

Whether the patient should receive email notifications for shipments. This is only applicable if you have authorized Blend to send patient communications on your behalf.

Example:

true

address

object

Show child attributes

address.address_1

string

required

Example:

"140 Lindgren Streets"

address.city

string

required

Example:

"North Consueloburgh"

address.state

string

required

Two-letter state abbreviation

Example:

"CA"

address.zip_code

string

required

5-digit ZIP code or 9-digit ZIP+4 code, e.g. 02108 or 02108-1234.

Example:

"02108"

address.address_2

string

Example:

"Apt 227"

address.country

string

Two-letter country code, defaults to US

Example:

"US"

risk_factors

object

Raw text risk factors for the patient. These will be parsed and automatically matched to standardized risk factors. Please delimit with commas, semi-colons, or slashes. Discrete risk factors can be added using the dedicated endpoints.

Show child attributes

risk_factors.allergies

string

Example:

"peanuts, tree nuts, shellfish"

risk_factors.conditions

string

Example:

"asthma, hypertension"

risk_factors.medications

string

Example:

"albuterol, levothyroxine"

Response

200 - application/json

Patient updated successfully

string<uuid>

Unique identifier

Example:

"0227d1e5-ba9a-42b5-8fe2-38882aa65708"

created_at

string<date-time>

Date and time of creation

Example:

"2025-03-15T12:00:00Z"

updated_at

string<date-time>

Date and time of last update

Example:

"2025-03-15T12:00:00Z"

first_name

string

Example:

"Willard"

middle_name

string

Example:

"Moises"

last_name

string

Example:

"Donnelly"

gender

enum<string>

Gender of the patient

Available options:

male,

female

Example:

"male"

string

Example:

"[email protected]"

phone

string

10-digit phone number without formatting, e.g. 6417383445

Example:

"6417383445"

date_of_birth

string<date>

Example:

"1990-01-01"

driver_license_number

string

Example:

"B49188319"

driver_license_state

string

Example:

"CA"

ssn

string

Social Security number. Can be provided with or without hyphens.

Example:

"123456789"

primary_language

string

ISO 639-1 language code

Example:

"en"

guardian_name

string

Name of the patient's guardian. Required if patient is a minor.

Example:

"John Guardian"

guardian_phone

string

Example:

"6417383445"

guardian_email

string

Example:

"[email protected]"

guardian_relationship

string

Relationship of the guardian to the patient. See relationship types lookup for available values; most common are parent and legal_guardian; and other can be used.

Example:

"parent"

height_inches

integer

Height of the patient in inches

Example:

72

weight_pounds

integer

Weight of the patient in pounds

Example:

180

external_id

string

External (your own) ID for the patient, to be used for prescription matching

Example:

"1234567890"

is_smoker

boolean

Whether the patient is a smoker

Example:

false

is_diabetic

boolean

Whether the patient is diabetic

Example:

false

is_pregnant

boolean

Whether the patient is pregnant

Example:

false

receive_sms

boolean

Whether the patient should receive SMS notifications for shipments. This is only applicable if you have authorized Blend to send patient communications on your behalf.

Example:

true

receive_email

boolean

Whether the patient should receive email notifications for shipments. This is only applicable if you have authorized Blend to send patient communications on your behalf.

Example:

true

address

object

Show child attributes

address.address_1

string

required

Example:

"140 Lindgren Streets"

address.city

string

required

Example:

"North Consueloburgh"

address.state

string

required

Two-letter state abbreviation

Example:

"CA"

address.zip_code

string

required

5-digit ZIP code or 9-digit ZIP+4 code, e.g. 02108 or 02108-1234.

Example:

"02108"

address.address_2

string

Example:

"Apt 227"

address.country

string

Two-letter country code, defaults to US

Example:

"US"

is_minor

boolean

Whether the patient is a minor. Automatically calculated based on date of birth.

Example:

false

Get a patient's details Get guardian relationship types

⌘I

Authentication

Composite Creation

Electronic Prescriptions

Notifications

Orders

Patients

Prescribers

Products and Materials

Reports

Search

Update a patient's details

Authorizations

Path Parameters

Body

Response