Update Observation

PUT creation and restoration

A PUT to an unused ID creates that identity; a PUT to a logically deleted resource restores it. Both return 201 Created and require create and update permission. Updating a live resource returns 200 OK and requires update permission. For ID syntax, headers, version preconditions, batch behavior, and availability, see Create, Update, and Restore Resources with PUT.

Endpoint

PUT /api/fhir/r6-ballot4/Observation/{rid}

Base URL: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4

Example request: PUT /api/fhir/r6-ballot4/Observation/00000000-0000-4000-8000-000000000006

Example URL: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4/Observation/00000000-0000-4000-8000-000000000006

The examples use illustrative identifiers and values.

Headers

{"Accept":"application/fhir+json","Authorization":"Bearer [REDACTED]","Content-Type":"application/fhir+json"}

Parameters

Version preconditions

Optionally send the ETag from your last read as If-Match, for example If-Match: W/"4". A nonmatching condition returns 412 Precondition Failed without applying the PUT; malformed headers return 400. Omitting the header does not protect against concurrent changes. A supplied condition cannot create an unused ID. See Update with If-Match.

Authorization

The supported authorization model uses OAuth 2.0 scopes issued by OCI Identity Domains. Send the access token as a bearer token. Resource-server definitions and issued access-token claims use canonical system/... scopes. Client grants and token requests use the corresponding ddfssystem/... form. For examples, see Reference: Authentication and Scopes.

Example Request

{"resourceType":"Observation","identifier":[{"system":"https://example.com/fhir/identifier/Observation","value":"example-resource"}],"status":"final","code":{"coding":[{"system":"http://loinc.org","code":"8867-4","display":"Heart rate"}]},"subject":{"reference":"Patient/00000000-0000-4000-8000-000000000001"},"effectiveDateTime":"2020-01-01T00:00:00Z","valueQuantity":{"value":72,"unit":"beats/minute","system":"http://unitsofmeasure.org","code":"/min"},"meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"example-resource","display":"Example resource"},{"system":"https://example.com/fhir/tag/phase","code":"updated","display":"Example update"}]},"category":[{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/observation-category","code":"vital-signs","display":"Vital Signs"}]}],"device":{"reference":"Device/00000000-0000-4000-8000-000000000004"},"encounter":{"reference":"Encounter/00000000-0000-4000-8000-000000000005"},"id":"00000000-0000-4000-8000-000000000006"}

Example Response

{
  "resourceType": "Observation",
  "code": {
    "coding": [
      {
        "system": "http://loinc.org",
        "code": "8867-4",
        "display": "Heart rate"
      }
    ]
  },
  "id": "00000000-0000-4000-8000-000000000006",
  "meta": {
    "versionId": "2",
    "lastUpdated": "2025-01-01T00:00:00Z",
    "profile": [],
    "security": [],
    "tag": [
      {
        "system": "https://example.com/fhir/tag",
        "code": "example-resource",
        "display": "Example resource"
      },
      {
        "system": "https://example.com/fhir/tag/phase",
        "code": "updated",
        "display": "Example update"
      }
    ]
  },
  "identifier": [
    {
      "system": "https://example.com/fhir/identifier/Observation",
      "value": "example-resource"
    }
  ],
  "basedOn": [],
  "partOf": [],
  "status": "final",
  "category": [
    {
      "coding": [
        {
          "system": "http://terminology.hl7.org/CodeSystem/observation-category",
          "code": "vital-signs",
          "display": "Vital Signs"
        }
      ]
    }
  ],
  "subject": {
    "reference": "Patient/00000000-0000-4000-8000-000000000001"
  },
  "focus": [],
  "encounter": {
    "reference": "Encounter/00000000-0000-4000-8000-000000000005"
  },
  "effectiveDateTime": "2020-01-01T00:00:00Z",
  "performer": [],
  "valueQuantity": {
    "value": 72,
    "unit": "beats/minute",
    "system": "http://unitsofmeasure.org",
    "code": "/min"
  },
  "interpretation": [],
  "note": [],
  "device": {
    "reference": "Device/00000000-0000-4000-8000-000000000004"
  },
  "referenceRange": [],
  "hasMember": [],
  "derivedFrom": []
}

Behavior

Creates a Observation at an unused logical ID, replaces an existing live resource, or restores a logically deleted resource. The body resource type and ID must match the request path. Creation and restoration return 201; live replacement returns 200. See PUT creation and restoration for response headers and history behavior.

cURL Example

curl.exe `
  -sS `
  -X PUT `
  https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r6-ballot4/Observation/00000000-0000-4000-8000-000000000006 `
  -H 'Accept: application/fhir+json' `
  -H 'Authorization: Bearer [REDACTED]' `
  -H 'Content-Type: application/fhir+json' `
  --data '{"resourceType":"Observation","identifier":[{"system":"https://example.com/fhir/identifier/Observation","value":"example-resource"}],"status":"final","code":{"coding":[{"system":"http://loinc.org","code":"8867-4","display":"Heart rate"}]},"subject":{"reference":"Patient/00000000-0000-4000-8000-000000000001"},"effectiveDateTime":"2020-01-01T00:00:00Z","valueQuantity":{"value":72,"unit":"beats/minute","system":"http://unitsofmeasure.org","code":"/min"},"meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"example-resource","display":"Example resource"},{"system":"https://example.com/fhir/tag/phase","code":"updated","display":"Example update"}]},"category":[{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/observation-category","code":"vital-signs","display":"Vital Signs"}]}],"device":{"reference":"Device/00000000-0000-4000-8000-000000000004"},"encounter":{"reference":"Encounter/00000000-0000-4000-8000-000000000005"},"id":"00000000-0000-4000-8000-000000000006"}'

Status Codes

FHIR Definition

Canonical: https://hl7.org/fhir/6.0.0-ballot4/observation.html

Related Operations

• Create Observation
• Read Observation
• Read Observation Version
• Delete Observation
• Search Observation
• Hard Delete Observation
• Purge Deleted Observation