Update Health Service Resource - OnyeOne Documentation

This endpoint updates an existing HealthcareService resource. Note that this operation replaces the section in the resource as specified in the body of the request.

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Path Params

healthcareservice_id

string

required

Body Params application/json

active

boolean

optional

name

string

optional

location

array[string]

optional

Location Resource IDs where this service is offered.

telecom

array [object {2}]

optional

phone

string

optional

string

optional

coverage_area

array[string]

optional

appointment_required

boolean

optional

Indicates whether or not a prospective consumer will require an appointment for a particular service at a site to be provided by the Organization. Indicates if an appointment is required for access to this service.

available_times

array [object {4}]

optional

days_of_week

array[string]

optional

Allowed values:

montuewedthufrisatsun

all_day

boolean

optional

Always available? i.e. 24 hour service

start_time

string

optional

Opening time of day (ignored if all_day = true). A time during the day, in the format hh:mm:ss

end_time

string

optional

Closing time of day (ignored if all_day = true). A time during the day, in the format hh:mm:ss

not_available_times

array [object {3}]

optional

description

string

optional

Reason presented to the user explaining why time not available

start_date

string

optional

Service not available during this period

end_date

string

optional

Service not available during this period

availability_exceptions

string

optional

A description of site availability exceptions, e.g. public holiday availability. Succinctly describing all possible exceptions to normal site availability as details in the available Times and not available Times.

comment

string

optional

Any additional description of the service and/or any specific issues not covered by the other attributes, which can be displayed as further detail under the serviceName.

extra_details

string

optional

Extra details about the service that can't be placed in the other fields.

specialties

array [object {2}]

optional

code

string

optional

HL7 specialty code, see http://hl7.org/fhir/ValueSet/c80-practice-codes

name

string

optional

Specialty name. See http://hl7.org/fhir/ValueSet/c80-practice-codes

type

array [object {2}]

optional

code

string

required

See http://hl7.org/fhir/ValueSet/service-type for codes and names.

name

string

required

Example

{
    "active": true,
    "name": "Gerald Koch",
    "location": [
        "d0f2ff01-9bc3-5652-87cf-428d1b3f3170"
    ],
    "telecom": [
        {
            "phone": "+1234654328",
            "email": "Sid.VonRueden3@hotmail.com"
        },
        {
            "phone": "+1234986745",
            "email": "Candido_Nader54@gmail.com"
        }
    ],
    "coverage_area": [
        "d0f2ff01-9bc3-5652-87cf-428d1b3f3170"
    ],
    "appointment_required": true,
    "available_times": [
        {
            "days_of_week": [
                "wed",
                "thu",
                "fri"
            ],
            "all_day": true
        },
        {
            "days_of_week": [
                "mon",
                "tue",
                "sun"
            ],
            "all_day": true
        },
        {
            "days_of_week": [
                "tue",
                "tue",
                "fri"
            ],
            "all_day": false,
            "start_time": "12:00:00",
            "end_time": "17:00:00"
            
        }
    ],
    "not_available_times": [
        {
            "description": "Depono vado adipisci adflicto tantillus tyrannus accusamus delibero. Arbor curia subiungo carmen congregatio tertius vesco. Coma amplexus delectus vitiosus denuncio officiis auctus umerus.",
            "start_date": "2024-03-06",
            "end_date": "2025-01-06"
        },
        {
            "description": "Sonitus abutor ceno pariatur tribuo adeptio cogo. Tristis ipsam adopto aggero beneficium titulus canis una viscus cultura. Libero attollo maxime summisse vilitas advenio amitto quaerat ab accommodo.",
            "start_date": "2024-05-23",
            "end_date": "2025-05-10"
        }
    ],
    "availability_exceptions": "dolor Ut in",
    "comment": "mollit amet velit",
    "extra_details": "qui sit laborum mollit",
    "specialties": [
        {
            "code": "394586005",
            "name": "Gynecology"
        }
        
    ],
    "type": [
        {
            "code": "263",
            "name": "Birth"
        },
        {
            "code": "52",
            "name": "Chiropractic"
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request PUT 'https://staging.onyeone.com/api/emr/healthcareservice/' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--data-raw '{
    "active": true,
    "name": "Gerald Koch",
    "location": [
        "d0f2ff01-9bc3-5652-87cf-428d1b3f3170"
    ],
    "telecom": [
        {
            "phone": "+1234654328",
            "email": "Sid.VonRueden3@hotmail.com"
        },
        {
            "phone": "+1234986745",
            "email": "Candido_Nader54@gmail.com"
        }
    ],
    "coverage_area": [
        "d0f2ff01-9bc3-5652-87cf-428d1b3f3170"
    ],
    "appointment_required": true,
    "available_times": [
        {
            "days_of_week": [
                "wed",
                "thu",
                "fri"
            ],
            "all_day": true
        },
        {
            "days_of_week": [
                "mon",
                "tue",
                "sun"
            ],
            "all_day": true
        },
        {
            "days_of_week": [
                "tue",
                "tue",
                "fri"
            ],
            "all_day": false,
            "start_time": "12:00:00",
            "end_time": "17:00:00"
            
        }
    ],
    "not_available_times": [
        {
            "description": "Depono vado adipisci adflicto tantillus tyrannus accusamus delibero. Arbor curia subiungo carmen congregatio tertius vesco. Coma amplexus delectus vitiosus denuncio officiis auctus umerus.",
            "start_date": "2024-03-06",
            "end_date": "2025-01-06"
        },
        {
            "description": "Sonitus abutor ceno pariatur tribuo adeptio cogo. Tristis ipsam adopto aggero beneficium titulus canis una viscus cultura. Libero attollo maxime summisse vilitas advenio amitto quaerat ab accommodo.",
            "start_date": "2024-05-23",
            "end_date": "2025-05-10"
        }
    ],
    "availability_exceptions": "dolor Ut in",
    "comment": "mollit amet velit",
    "extra_details": "qui sit laborum mollit",
    "specialties": [
        {
            "code": "394586005",
            "name": "Gynecology"
        }
        
    ],
    "type": [
        {
            "code": "263",
            "name": "Birth"
        },
        {
            "code": "52",
            "name": "Chiropractic"
        }
    ]
}'

Responses

🟢200Success

application/json

Body

message

string

required

resource_id

string

required

updated_fields

object

required

active

boolean

optional

name

string

optional

appointmentRequired

boolean

optional

Example

{
    "message": "HealthcareService resource updated successfully.",
    "resource_id": "4e4fbc42-ce67-5a60-bfd7-9cedca2f376c",
    "updated_fields": {
        "active": false,
        "name": "Social Support",
        "appointmentRequired": false
    }
}