Oracle Cloud Infrastructure Documentation

Create Group

Create a FHIR R4 Group resource.

Endpoint

POST /api/fhir/r4/Group

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

Example URL: https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r4/Group

Headers

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

Parameters

ParameterInRequiredTypeDescription
No parameters

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.

Context Scope form
Resource-server definition system/Group.c
Client grant/token request ddfssystem/Group.c
Issued token's scope claim system/Group.c

Example Request

{"resourceType":"Group","identifier":[{"system":"https://example.com/fhir/identifier/group","value":"documentation-example"}],"active":true,"type":"person","actual":true,"name":"Example group","meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"documentation-example","display":"Documentation example"}]},"managingEntity":{"reference":"Organization/00000000-0000-4000-8000-000000000009"},"code":{"coding":[{"system":"http://snomed.info/sct","code":"125676002","display":"Person"}]},"characteristic":[{"code":{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/group-characteristic","code":"gender","display":"Gender"}]},"valueCodeableConcept":{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/v3-AdministrativeGender","code":"U","display":"Unknown"}]},"exclude":false}],"member":[{"entity":{"reference":"Patient/00000000-0000-4000-8000-000000000010"}}]}

Example Response

{
  "resourceType": "Group",
  "id": "00000000-0000-4000-8000-000000000006",
  "meta": {
    "versionId": "1",
    "lastUpdated": "2020-01-01T00:00:00Z",
    "profile": [],
    "security": [],
    "tag": [
      {
        "system": "https://example.com/fhir/tag",
        "code": "documentation-example",
        "display": "Documentation example"
      }
    ]
  },
  "identifier": [
    {
      "system": "https://example.com/fhir/identifier/group",
      "value": "documentation-example"
    }
  ],
  "active": true,
  "type": "person",
  "actual": true,
  "code": {
    "coding": [
      {
        "system": "http://snomed.info/sct",
        "code": "125676002",
        "display": "Person"
      }
    ]
  },
  "name": "Example group",
  "managingEntity": {
    "reference": "Organization/00000000-0000-4000-8000-000000000009"
  },
  "characteristic": [
    {
      "code": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/group-characteristic",
            "code": "gender",
            "display": "Gender"
          }
        ]
      },
      "valueCodeableConcept": {
        "coding": [
          {
            "system": "http://terminology.hl7.org/CodeSystem/v3-AdministrativeGender",
            "code": "U",
            "display": "Unknown"
          }
        ]
      },
      "exclude": false
    }
  ],
  "member": [
    {
      "entity": {
        "reference": "Patient/00000000-0000-4000-8000-000000000010"
      },
      "inactive": false
    }
  ]
}

Behavior

Creates a Group resource.

cURL Example

curl.exe `
  -sS `
  --connect-timeout 10 `
  --max-time 90 `
  -X POST `
  https://<ddfs-instance-id>.ddfs.<region>.oci.oraclecloud.com/api/fhir/r4/Group `
  -H 'Accept: application/fhir+json' `
  -H 'Authorization: Bearer [REDACTED]' `
  -H 'Content-Type: application/fhir+json' `
  --data '{"resourceType":"Group","identifier":[{"system":"https://example.com/fhir/identifier/group","value":"documentation-example"}],"active":true,"type":"person","actual":true,"name":"Example group","meta":{"tag":[{"system":"https://example.com/fhir/tag","code":"documentation-example","display":"Documentation example"}]},"managingEntity":{"reference":"Organization/00000000-0000-4000-8000-000000000009"},"code":{"coding":[{"system":"http://snomed.info/sct","code":"125676002","display":"Person"}]},"characteristic":[{"code":{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/group-characteristic","code":"gender","display":"Gender"}]},"valueCodeableConcept":{"coding":[{"system":"http://terminology.hl7.org/CodeSystem/v3-AdministrativeGender","code":"U","display":"Unknown"}]},"exclude":false}],"member":[{"entity":{"reference":"Patient/00000000-0000-4000-8000-000000000010"}}]}'

Status Codes

CodeStatus
201 Created Group representation.

FHIR Definition

Canonical: https://hl7.org/fhir/R4/group.html

Related Operations