Update a patient

PATCH/patients/{patientId}

Updates the fields you send and leaves the rest unchanged.

Credentials: API key, or an OAuth access token
Scope: patients.write

Run in Postman: import the collection, set api_key, and find this request in its folder.

Path parameters

patientIdUUIDRequired

ID of the patient.

Query parameters

org_idUUID

The organization the call acts on, from List organizations. Required when an account API key reaches more than one organization; an organization key or a key limited to one organization can leave it out.

Body parameters

Only the fields you send change. Send null to clear a field.

first_namestring

First name.

last_namestring

Last name.

date_of_birthdate or null

Date of birth.

phonestring or null

Mobile number.

emailstring or null

Email address.

mrnstring or null

The patient’s ID in your system.

Any other field returns 422 unknown_field. See Unknown fields are rejected.

Returns

Returns 200 OK with the Patient object.

Errors

Failed requests return application/problem+json problem details. The errors specific to this endpoint:

Status	Code	Meaning
400	`invalid_request`	The request is malformed, such as invalid JSON.
400	`org_id_required`	The key reaches more than one organization: pass `org_id`.
401	`invalid_token`	The API key is missing or malformed, or isn’t a BloomText key.
401	`key_revoked`	The API key was revoked.
401	`key_expired`	The API key’s expiry has passed.
403	`insufficient_scope`	The key doesn’t have the scope this endpoint needs.
403	`org_not_reachable`	The key can’t reach the organization in `org_id`.
404	`not_found`	The resource doesn’t exist, or isn’t visible to this credential.
422	`validation_failed`	A field failed validation. See `field_errors`.
429	`rate_limited`	Too many requests. Retry after `Retry-After` seconds.

cURL

Request


curl -X PATCH "https://api.bloomtext.com/v1/patients/5a1c9e2b-7d44-4f1a-9c3e-2b8d6f0a1e77" \
  -H "Authorization: Bearer $BLOOMTEXT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone":"+15125550177"}'

JavaScript

Request


const response = await fetch('https://api.bloomtext.com/v1/patients/5a1c9e2b-7d44-4f1a-9c3e-2b8d6f0a1e77', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.BLOOMTEXT_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({"phone":"+15125550177"}),
})
 
if (!response.ok) throw new Error(`BloomText API error: ${response.status}`)
const data = await response.json()

Python

Request


import os
 
import requests
 
response = requests.patch(
    "https://api.bloomtext.com/v1/patients/5a1c9e2b-7d44-4f1a-9c3e-2b8d6f0a1e77",
    headers={
        "Authorization": f"Bearer {os.environ['BLOOMTEXT_API_KEY']}",
    },
    json={"phone":"+15125550177"},
)
response.raise_for_status()
data = response.json()

Go

Request


package main
 
import (
	"bytes"
	"fmt"
	"io"
	"net/http"
	"os"
)
 
func main() {
	body := bytes.NewBufferString(`{"phone":"+15125550177"}`)
	req, err := http.NewRequest("PATCH", "https://api.bloomtext.com/v1/patients/5a1c9e2b-7d44-4f1a-9c3e-2b8d6f0a1e77", body)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("BLOOMTEXT_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
 
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
 
	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.Status, string(out))
}

Ruby

Request


require "net/http"
require "json"
 
uri = URI("https://api.bloomtext.com/v1/patients/5a1c9e2b-7d44-4f1a-9c3e-2b8d6f0a1e77")
request = Net::HTTP::Patch.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("BLOOMTEXT_API_KEY")}"
request["Content-Type"] = "application/json"
request.body = { phone: "+15125550177" }.to_json
 
response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
data = JSON.parse(response.body)

Response · 200 OK


{
  "id": "5a1c9e2b-7d44-4f1a-9c3e-2b8d6f0a1e77",
  "first_name": "Jane",
  "last_name": "Doe",
  "date_of_birth": "1986-04-12",
  "phone": "+15125550177",
  "email": "jane.doe@example.com",
  "mrn": "MRN-20931",
  "sms_opted_out": false,
  "sms_undeliverable_reasons": [],
  "conversation_count": 2,
  "created_at": "2026-02-03T17:22:10Z",
  "matched_by": null
}