Skip to main content
PUT
/
api
/
doctors
/
:id
curl -X PUT "https://api.saludya.com/api/doctors/doc_8x9y2z3a4b5c6d7e" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "available": false
  }'
{
  "id": "doc_8x9y2z3a4b5c6d7e",
  "name": "Dr. Maria Garcia",
  "specialty": "Cardiology",
  "license_number": "MD-12345-CA",
  "email": "m.garcia@saludya.com",
  "phone": "+1-555-0125",
  "bio": "Board-certified cardiologist with 15 years of experience in interventional cardiology and heart disease prevention. Graduate of Stanford Medical School. Now specializing in preventive cardiology and cardiac rehabilitation.",
  "available": true,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-03-06T16:45:00Z"
}

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/DUVAN100/saludya-api/llms.txt

Use this file to discover all available pages before exploring further.

Path Parameters

id
string
required
Unique identifier of the doctor to update (e.g., “doc_8x9y2z3a4b5c6d7e”)

Request Body

All fields are optional. Only include fields you want to update.
name
string
Full name of the doctor
specialty
string
Medical specialty or area of expertise
license_number
string
Professional medical license number. Must be unique in the system.
email
string
Doctor’s professional email address
phone
string
Contact phone number with country code
bio
string
Professional biography and credentials. Maximum 1000 characters.
available
boolean
Whether the doctor is accepting new patients

Response

id
string
Unique identifier for the doctor
name
string
Full name of the doctor
specialty
string
Medical specialty
license_number
string
Professional medical license number
email
string
Doctor’s contact email address
phone
string
Doctor’s contact phone number
bio
string
Professional biography
available
boolean
Availability status
created_at
string
ISO 8601 timestamp of creation
updated_at
string
ISO 8601 timestamp of last update (will reflect the update time)
curl -X PUT "https://api.saludya.com/api/doctors/doc_8x9y2z3a4b5c6d7e" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "available": false
  }'
{
  "id": "doc_8x9y2z3a4b5c6d7e",
  "name": "Dr. Maria Garcia",
  "specialty": "Cardiology",
  "license_number": "MD-12345-CA",
  "email": "m.garcia@saludya.com",
  "phone": "+1-555-0125",
  "bio": "Board-certified cardiologist with 15 years of experience in interventional cardiology and heart disease prevention. Graduate of Stanford Medical School. Now specializing in preventive cardiology and cardiac rehabilitation.",
  "available": true,
  "created_at": "2024-01-15T10:30:00Z",
  "updated_at": "2024-03-06T16:45:00Z"
}

Common Use Cases

Temporarily Mark Doctor as Unavailable

When a doctor goes on leave or is temporarily not accepting patients:
{
  "available": false
}

Update Contact Information

When a doctor changes their contact details:
{
  "email": "new.email@saludya.com",
  "phone": "+1-555-9999"
}

Update Specialty or Credentials

When a doctor completes additional certifications:
{
  "specialty": "Cardiology & Cardiac Electrophysiology",
  "bio": "Updated biography with new credentials..."
}

Important Notes

  • Updating a doctor’s availability to false does not automatically cancel existing appointments
  • Changes to license numbers must still maintain uniqueness across all doctors
  • The updated_at timestamp is automatically set to the current time when any field is modified
  • Partial updates are supported - only send the fields you want to change

Build docs developers (and LLMs) love