NAV
Ruby Shell

Personnel API v1

URL: https://cernerdemo.api.us-1.healtheintent.com/personnel/v1

Personnel

Personnel are the people involved in the health care of a population. In most cases, personnel are employees or affiliates of a health care system or provider.

Note: Users are personnel who log in to HealtheIntent applications. All users must be personnel, but not all personnel are necessarily users. Users gain access to features and information in HealtheIntent applications through membership in personnel groups and by being a member or administrator of organizations.

Retrieve a Personnel List

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel',
  query: {
  'aliasValue' => 'string'
}, headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel?aliasValue=type,string \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "f89fa3dd-0000-494b-1111-4640ccc081e3",
      "birthDate": "1970-11-15",
      "gender": "FEMALE",
      "name": {
        "prefix": "Dr.",
        "given": "Jane",
        "middle": "Elizabeth",
        "family": "Smith",
        "suffix": "MD",
        "formatted": "Dr. Jane Elizabeth Smith MD"
      },
      "addresses": [
        {
          "use": "WORK",
          "text": "2800 Rockcreek Pkwy\\nSuite 1, Kansas City, MO, USA, 64117",
          "lines": [
            "2800 Rockcreek Pkwy",
            "Suite 1"
          ],
          "city": "Kansas City",
          "state": "MO",
          "postalCode": "64117",
          "country": "USA"
        }
      ],
      "aliases": [
        {
          "value": "123.456.7890",
          "system": "5ecaf544-01d5-01kf-95hj-8e2bcec12006",
          "type": "SPI"
        }
      ],
      "telecoms": [
        {
          "system": "PHONE",
          "value": "816-201-0001"
        },
        {
          "system": "EMAIL",
          "value": "jane.smith@cerner.com"
        }
      ],
      "languages": [
        "en",
        "hi",
        "fr"
      ],
      "qualifications": [
        {
          "code": "BFA",
          "issuer": "University of Missouri - Kansas City",
          "start": "2010-01-05T00:00:00Z",
          "end": "2050-01-05T00:00:00Z"
        }
      ],
      "isManual": true,
      "createdAt": "2016-09-02T02:35:10Z",
      "updatedAt": "2018-01-23T14:42:49Z"
    },
    {
      "id": "hgjfut83-0000-h9g2-1111-4640cjd97de3",
      "birthDate": "1975-09-30",
      "gender": "UNKNOWN",
      "name": {
        "prefix": "Dr.",
        "given": "John",
        "middle": "Michael",
        "family": "Doe",
        "suffix": "III",
        "formatted": "Dr. John Michael Doe III"
      },
      "addresses": [
        {
          "use": "WORK",
          "text": "2800 Rockcreek Pkwy\\nSuite 1, Kansas City, MO, USA, 64117",
          "lines": [
            "2800 Rockcreek Pkwy",
            "Suite 1"
          ],
          "city": "Kansas City",
          "state": "MO",
          "postalCode": "64117",
          "country": "USA"
        }
      ],
      "aliases": [
        {
          "value": "0193.421321.31543",
          "system": "5echdj54-15a9-01jf-8110-8e202jf72006",
          "type": "SPI"
        }
      ],
      "telecoms": [
        {
          "system": "PHONE",
          "value": "816-201-0001"
        },
        {
          "system": "EMAIL",
          "value": "john.doe@cerner.com"
        }
      ],
      "languages": [
        "en",
        "fr",
        "es"
      ],
      "qualifications": [
        {
          "code": "BFA",
          "issuer": "University of Kansas",
          "start": "2010-01-05T00:00:00Z",
          "end": "2050-01-05T00:00:00Z"
        }
      ],
      "isManual": true,
      "createdAt": "2017-10-02T02:05:10Z",
      "updatedAt": "2018-01-23T14:42:49Z"
    }
  ],
  "totalResults": 2,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel?formattedName=Dr&orderBy=givenName&offset=0&limit=2",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel?formattedName=Dr&orderBy=givenName&offset=2&limit=2"
}

GET /personnel

Retrieves a personnel list who match the query. This list is a combination of all personnel who came from an external source or were created using the API or a configuration tool.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelId query array[string] false N/A Filters by personnel IDs. -
formattedName query string false N/A Filters by the full name of the personnel entity. Filtering by a partial match is allowed. -
birthDate query string false N/A Filters by the birth date of the personnel entity. Must be an exact date in YYYY-MM-DD format. -
gender query string false N/A Filters by the gender of the personnel entity. MALE, FEMALE, OTHER, UNKNOWN
groupMnemonic query string false N/A Filters personnel to only members of the personnel groups that match the specified mnemonic. -
manualOnly query boolean false N/A Indicates whether to retrieve only manually created personnel. -
offset query integer(int32) false 0 The number of results to skip from the beginning of the list of results (typically for the purpose of paging). The minimum offset is 0. There is no maximum offset. -
limit query integer(int32) false 20 The maximum number of results to display per page. The minimum limit is 1. The maximum limit is 100. -
orderBy query string false formattedName Orders results by a given value in ascending or descending alphabetic order; to specify descending, prefix the value with a hyphen (-). formattedName, -formattedName, givenName, -givenName, familyName, -familyName
aliasValue query string true N/A Filters by the unique alias ID. Requires aliasType or aliasSystem. -
aliasType query string false N/A The type of alias by which to search. Requires aliasValue. NPI, DEA, SPI, TAX, SL, EXTERNAL, UPIN, USER, UNKNOWN
aliasSystem query string false N/A The source of the alias value. This is needed because an alias value that is unique within a given assigning authority (such as Standard Provider Identifier [SPI] or Cerner Millennium ID) is not guaranteed to be unique across sources. For example, a username of ‘JSMITH’ from Cerner Millennium can represent one person while the username of ‘JSMITH’ from Allscripts represents another person. This overlap presents security and data integrity concerns, such as data being linked to the wrong organization or provider. Requires aliasValue. -

Response Statuses

Status Meaning Description Schema
200 OK A collection of personnel objects. Personnels
400 Bad Request Bad Request Error

Create a Personnel Entity

Example Request:




require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Content-Type' => 'application/json',
  'Accept' => 'application/json'
} 

result = HTTParty.post('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel', headers: headers, body: {"birthDate":"1970-11-15","gender":"FEMALE","languages":["en","fr"],"name":{"prefix":"Dr.","given":"Jane","middle":"Elizabeth","family":"Smith","suffix":"Jr","formatted":"Dr. Jane Elizabeth Smith Jr"},"addresses":[{"use":"WORK","text":"2800 Rockcreek Pkwy\\nSuite 1, Kansas City, MO, USA, 64117","lines":["2800 Rockcreek Pkwy","Suite 1"],"city":"Kansas City","state":"MO","postalCode":"64117","country":"USA"}],"aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}],"telecoms":[{"system":"EMAIL","value":"jane.smith@rockhurst.edu"}],"qualifications":[{"issuer":"Rockhurst University","code":"MD"}],"sourceIdentifiers":[{"id":"10924.21321042.4vda1","dataPartitionId":"d1fb6eba-0f56-44fe-8680-b67985533184"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"birthDate":"1970-11-15","gender":"FEMALE","languages":["en","fr"],"name":{"prefix":"Dr.","given":"Jane","middle":"Elizabeth","family":"Smith","suffix":"Jr","formatted":"Dr. Jane Elizabeth Smith Jr"},"addresses":[{"use":"WORK","text":"2800 Rockcreek Pkwy\\nSuite 1, Kansas City, MO, USA, 64117","lines":["2800 Rockcreek Pkwy","Suite 1"],"city":"Kansas City","state":"MO","postalCode":"64117","country":"USA"}],"aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}],"telecoms":[{"system":"EMAIL","value":"jane.smith@rockhurst.edu"}],"qualifications":[{"issuer":"Rockhurst University","code":"MD"}],"sourceIdentifiers":[{"id":"10924.21321042.4vda1","dataPartitionId":"d1fb6eba-0f56-44fe-8680-b67985533184"}]}

Example response

{
  "id": "f89fa3dd-0000-494b-1111-4640ccc081e3",
  "birthDate": "1970-11-15",
  "gender": "FEMALE",
  "name": {
    "prefix": "Dr.",
    "given": "Jane",
    "middle": "Elizabeth",
    "family": "Smith",
    "suffix": "Jr",
    "formatted": "Dr. Jane Elizabeth Smith Jr"
  },
  "addresses": [
    {
      "use": "WORK",
      "text": "2800 Rockcreek Pkwy\\nSuite 1, Kansas City, MO, USA, 64117",
      "lines": [
        "2800 Rockcreek Pkwy",
        "Suite 1"
      ],
      "city": "Kansas City",
      "state": "MO",
      "postalCode": "64117",
      "country": "USA"
    }
  ],
  "aliases": [
    {
      "value": "123.456.7890",
      "system": "5ecaf544-01d5-01kf-95hj-8e2bcec12006",
      "type": "EXTERNAL"
    }
  ],
  "telecoms": [
    {
      "system": "EMAIL",
      "value": "jane.smith@rockhurst.edu"
    }
  ],
  "languages": [
    "en",
    "fr"
  ],
  "qualifications": [
    {
      "issuer": "Rockhurst University",
      "code": "MD"
    }
  ],
  "sourceIdentifiers": [
    {
      "id": "10924.21321042.4vda1",
      "dataPartitionId": "d1fb6eba-0f56-44fe-8680-b67985533184"
    }
  ],
  "isManual": true,
  "createdAt": "2018-01-10T15:48:32Z",
  "updatedAt": "2018-01-10T15:48:32Z"
}

POST /personnel

Creates a personnel entity.

Parameters

Parameter In Type Required Default Description Accepted Values
body body postPersonnel true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created Single Personnel entity object Personnel
400 Bad Request Bad Request Error
409 Conflict Conflict Error

Retrieve a Single Personnel Entity

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel/f89fa3dd-0000-494b-1111-4640ccc081e3', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel/f89fa3dd-0000-494b-1111-4640ccc081e3 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "f89fa3dd-0000-494b-1111-4640ccc081e3",
  "birthDate": "1970-11-15",
  "gender": "FEMALE",
  "name": {
    "prefix": "Dr.",
    "given": "Jane",
    "middle": "Elizabeth",
    "family": "Smith",
    "suffix": "Jr",
    "formatted": "Dr. Jane Elizabeth Smith Jr"
  },
  "addresses": [
    {
      "use": "WORK",
      "text": "2800 Rockcreek Pkwy\\nSuite 1, Kansas City, MO, USA, 64117",
      "lines": [
        "2800 Rockcreek Pkwy",
        "Suite 1"
      ],
      "city": "Kansas City",
      "state": "MO",
      "postalCode": "64117",
      "country": "USA"
    }
  ],
  "aliases": [
    {
      "value": "123.456.7890",
      "system": "5ecaf544-01d5-01kf-95hj-8e2bcec12006",
      "type": "EXTERNAL"
    }
  ],
  "telecoms": [
    {
      "system": "EMAIL",
      "value": "jane.smith@rockhurst.edu"
    }
  ],
  "languages": [
    "en",
    "fr"
  ],
  "qualifications": [
    {
      "issuer": "Rockhurst University",
      "code": "MD"
    }
  ],
  "sourceIdentifiers": [
    {
      "id": "10924.21321042.4vda1",
      "dataPartitionId": "d1fb6eba-0f56-44fe-8680-b67985533184"
    }
  ],
  "isManual": true,
  "createdAt": "2018-01-10T15:48:32Z",
  "updatedAt": "2018-01-10T15:48:32Z"
}

GET /personnel/{personnelId}

Retrieves a single personnel entity.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelId path string true N/A The ID of the personnel entity. -

Response Statuses

Status Meaning Description Schema
200 OK Single Personnel entity object Personnel
404 Not Found Not Found Error

Update a Personnel Entity

Example Request:




require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Content-Type' => 'application/json',
  'Accept' => 'application/json'
} 

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel/f89fa3dd-0000-494b-1111-4640ccc081e3', headers: headers, body: {"birthDate":"1970-11-15","gender":"FEMALE","languages":["en","fr"],"name":{"prefix":"Dr.","given":"Jane","middle":"Elizabeth","family":"Smith","suffix":"Jr","formatted":"Dr. Jane Elizabeth Smith Jr"},"addresses":[{"use":"WORK","text":"2800 Rockcreek Pkwy\\nSuite 1, Kansas City, MO, USA, 64117","lines":["2800 Rockcreek Pkwy","Suite 1"],"city":"Kansas City","state":"MO","postalCode":"64117","country":"USA"}],"aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}],"telecoms":[{"system":"EMAIL","value":"jane.smith@rockhurst.edu"}],"qualifications":[{"issuer":"Rockhurst University","code":"MD"}],"sourceIdentifiers":[{"id":"10924.21321042.4vda1","dataPartitionId":"d1fb6eba-0f56-44fe-8680-b67985533184"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel/f89fa3dd-0000-494b-1111-4640ccc081e3 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"birthDate":"1970-11-15","gender":"FEMALE","languages":["en","fr"],"name":{"prefix":"Dr.","given":"Jane","middle":"Elizabeth","family":"Smith","suffix":"Jr","formatted":"Dr. Jane Elizabeth Smith Jr"},"addresses":[{"use":"WORK","text":"2800 Rockcreek Pkwy\\nSuite 1, Kansas City, MO, USA, 64117","lines":["2800 Rockcreek Pkwy","Suite 1"],"city":"Kansas City","state":"MO","postalCode":"64117","country":"USA"}],"aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}],"telecoms":[{"system":"EMAIL","value":"jane.smith@rockhurst.edu"}],"qualifications":[{"issuer":"Rockhurst University","code":"MD"}],"sourceIdentifiers":[{"id":"10924.21321042.4vda1","dataPartitionId":"d1fb6eba-0f56-44fe-8680-b67985533184"}]}

PUT /personnel/{personnelId}

Updates a personnel entity.

Note: If your organization uses an external system to create personnel, you cannot edit or delete personnel using this API. If you send a request to update or delete a personnel entity using the API in this case, a 400 response (Bad Request) is sent.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelId path string true N/A The ID of the personnel entity. -
body body putPersonnel true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
400 Bad Request Bad Request Error
404 Not Found Not Found Error
409 Conflict Conflict Error

Remove a Personnel Entity

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel/f89fa3dd-0000-494b-1111-4640ccc081e3', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel/f89fa3dd-0000-494b-1111-4640ccc081e3 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /personnel/{personnelId}

Removes a personnel entity.

Note: If your organization uses an external system to create personnel, you cannot edit or delete personnel using this API. If you send a request to update or delete a personnel entity using the API in this case, a 400 response (Bad Request) is sent.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelId path string true N/A The ID of the personnel entity. -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
400 Bad Request Bad Request Error
404 Not Found Not Found Error
409 Conflict Conflict Error

Personnel Groups

Personnel groups are sets of personnel who are grouped together to give them access to the same features or information. A personnel can belong to as many or as few personnel groups as necessary. For more information on how personnel groups are used within HealtheIntent visit our reference page Understand the HealtheIntent Security Model.

Retrieve a Personnel Group List

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "1b69dc47-6358-4221-bb61-8618323d18a2",
      "name": "Analytics Data Authors",
      "mnemonic": "analytics_data_authors",
      "aliases": [
        {
          "value": "8cbbffdc-acfe-11e7-abc4-cec278b6b50c",
          "system": "2.16.840.1.113883.4.6",
          "type": "EXTERNAL"
        }
      ],
      "isManual": true,
      "createdAt": "2018-01-21T16:41:24Z",
      "updatedAt": "2018-02-21T16:41:44Z"
    },
    {
      "id": "15d2635d-1264-4b36-9474-4ce28ffc4978",
      "name": "Analytics Data Model Consumers",
      "mnemonic": "analytics_data_model_consumers",
      "dynamicPersonnelGroupId": "0068b66f-122d-4336-9e44-b0fadb1a013b",
      "aliases": [
        {
          "value": "9acerner-acfe-11e7-abc4-cec278b6b50c",
          "system": "3.16.840.1.113883.4.6",
          "type": "EXTERNAL"
        }
      ],
      "isManual": true,
      "createdAt": "2018-01-11T16:12:24Z",
      "updatedAt": "2018-01-21T13:41:14Z"
    }
  ],
  "totalResults": 2,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups?name=analytics data&orderBy=mnemonic&offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups?name=analytics data&orderBy=mnemonic&offset=0&limit=20"
}

GET /personnel-groups

Returns a personnel group list matching the query. This list is a combination of all personnel groups that came from an external source or were created using the API or a configuration tool.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelGroupId query array[string] false N/A The IDs of the personnel groups. -
memberPersonnelId query string false N/A The personnel ID for the member of the group. -
name query string false N/A The name of the personnel group. Filtering by a partial match is allowed. -
manualOnly query boolean false N/A Indicates whether to retrieve only manually created personnel groups. -
mnemonic query string false N/A The mnemonic determines the function of the personnel group. For example, a mnemonic with an application name followed by _whitelist indicates that the members of the group have access to that specific application. -
offset query integer(int32) false 0 The number of results to skip from the beginning of the list of results (typically for the purpose of paging). The minimum offset is 0. There is no maximum offset. -
limit query integer(int32) false 20 The maximum number of results to display per page. The minimum limit is 1. The maximum limit is 100. -
orderBy query string false name Orders results by a given value in ascending or descending alphabetic order; to specify descending, prefix the value with a hyphen (-). name, -name, mnemonic, -mnemonic
aliasType query string false N/A The type of alias to search. Requires aliasValue and aliasSystem. EXTERNAL
aliasValue query string false N/A The unique identifier of alias to search. Requires aliasType and aliasSystem. -
aliasSystem query string false N/A The source of the alias value. This is needed because an alias value that is unique within a given assigning authority is not guaranteed to be unique across sources. Requires aliasType and aliasValue. -

Response Statuses

Status Meaning Description Schema
200 OK Collection of Personnel Group objects PersonnelGroups
400 Bad Request Bad Request Error

Create a Personnel Group

Example Request:




require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Content-Type' => 'application/json',
  'Accept' => 'application/json'
} 

result = HTTParty.post('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups', headers: headers, body: {"name":"Analytics Whitelist","mnemonic":"mpm_whitelist","aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Analytics Whitelist","mnemonic":"mpm_whitelist","aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}]}

Example response

{
  "id": "1928bad5-11d2-4028-af95-d7ae3c578567",
  "name": "Person Management",
  "mnemonic": "mpm_whitelist",
  "dynamicPersonnelGroupId": "0068b66f-122d-4336-9e44-b0fadb1a013b",
  "aliases": [
    {
      "value": "123.456.7890",
      "system": "5ecaf544-01d5-01kf-95hj-8e2bcec12006",
      "type": "EXTERNAL"
    }
  ],
  "isManual": true,
  "createdAt": "2018-01-10T12:23:12Z",
  "updatedAt": "2018-05-12T15:48:32Z"
}

POST /personnel-groups

Creates a personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
body body postPersonnelGroups true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created Personnel Group object PersonnelGroup
400 Bad Request Bad Request Error
409 Conflict Conflict Error

Retrieve a Single Personnel Group

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "1928bad5-11d2-4028-af95-d7ae3c578567",
  "name": "Person Management",
  "mnemonic": "mpm_whitelist",
  "dynamicPersonnelGroupId": "0068b66f-122d-4336-9e44-b0fadb1a013b",
  "aliases": [
    {
      "value": "123.456.7890",
      "system": "5ecaf544-01d5-01kf-95hj-8e2bcec12006",
      "type": "EXTERNAL"
    }
  ],
  "isManual": true,
  "createdAt": "2018-01-10T12:23:12Z",
  "updatedAt": "2018-05-12T15:48:32Z"
}

GET /personnel-groups/{personnelGroupId}

Returns a single personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelGroupId path string true N/A The ID of the personnel group. -

Response Statuses

Status Meaning Description Schema
200 OK Single Personnel Group object PersonnelGroup
404 Not Found Not Found Error

Update a Personnel Group

Example Request:




require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Content-Type' => 'application/json',
  'Accept' => 'application/json'
} 

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567', headers: headers, body: {"name":"Analytics Whitelist","mnemonic":"mpm_whitelist","aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Analytics Whitelist","mnemonic":"mpm_whitelist","aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}]}

PUT /personnel-groups/{personnelGroupId}

Updates a personnel group.

Note: If your organization uses an external system to create personnel groups, you cannot edit or delete personnel groups using this API. If you send a request to update or delete a personnel group using the API in this case, a 400 response (Bad request) is returned.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelGroupId path string true N/A The ID of the personnel group. -
body body putPersonnelGroups true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
400 Bad Request Bad Request Error
404 Not Found Not Found Error
409 Conflict Conflict Error

Remove a Personnel Group

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /personnel-groups/{personnelGroupId}

Removes a personnel group.

Note: If your organization uses an external system to create personnel groups, you cannot edit or delete personnel groups using this API. If you send a request to update or delete a personnel group using the API in this case, a 400 response (Bad request) is returned.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelGroupId path string true N/A The ID of the personnel group. -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
400 Bad Request Bad Request Error
404 Not Found Not Found Error

Retrieve a Personnel Group Member List

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/members', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/members \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "60adc152-07bf-4779-a1a2-3cba0015425a",
      "name": "Paula Poindexter"
    },
    {
      "id": "73a4190b-a3c2-4912-bff5-fb13e45076f9",
      "name": "Schultz Joel"
    }
  ],
  "totalResults": 2,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/members&offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/members&offset=0&limit=20"
}

GET /personnel-groups/{personnelGroupId}/members

Returns a personnel group member list.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelGroupId path string true N/A The ID of the personnel group. -
offset query integer(int32) false 0 The number of results to skip from the beginning of the list of results (typically for the purpose of paging). The minimum offset is 0. There is no maximum offset. -
limit query integer(int32) false 20 The maximum number of results to display per page. The minimum limit is 1. The maximum limit is 100. -
orderBy query string false name Orders results by a given value in ascending or descending alphabetic order; to specify descending, prefix the value with a hyphen (-). name, -name

Response Statuses

Status Meaning Description Schema
200 OK Collection of Personnel Group Member objects PersonnelGroupMembers
400 Bad Request Bad Request Error

Add a Personnel Group Member

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/members/222db7d9-7d6b-467b-9f99-d884883939f3', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/members/222db7d9-7d6b-467b-9f99-d884883939f3 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

PUT /personnel-groups/{personnelGroupId}/members/{personnelGroupMemberId}

Adds a personnel member to the personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelGroupId path string true N/A The ID of the personnel group. -
personnelGroupMemberId path string true N/A The ID of the personnel member being added to the personnel group. -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
400 Bad Request Bad Request Error
404 Not Found Not Found Error

Remove a Personnel Group Member

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/members/222db7d9-7d6b-467b-9f99-d884883939f3', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/members/222db7d9-7d6b-467b-9f99-d884883939f3 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /personnel-groups/{personnelGroupId}/members/{personnelGroupMemberId}

Removes a personnel member from the personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelGroupId path string true N/A The ID of the personnel group. -
personnelGroupMemberId path string true N/A The ID of the personnel member to be removed from the personnel group. -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
400 Bad Request Bad Request Error
404 Not Found Not Found Error

Retrieve a Dynamic Personnel Group List

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/dynamic-personnel-groups', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/dynamic-personnel-groups \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "1b69dc47-6358-4221-bb61-8618323d18a2",
      "name": "Analytics Data Authors",
      "mnemonic": "analytics_data_authors",
      "mnemonicType": "MULTIVALUED",
      "membersJoinType": "UNION",
      "aliases": [
        {
          "value": "8cbbffdc-acfe-11e7-abc4-cec278b6b50c",
          "system": "2.16.840.1.113883.4.6",
          "type": "EXTERNAL"
        }
      ]
    },
    {
      "id": "15d2635d-1264-4b36-9474-4ce28ffc4978",
      "name": "Analytics Data Model Consumers",
      "mnemonic": "analytics_data_model_consumers",
      "mnemonicType": "MULTIVALUED",
      "membersJoinType": "UNION",
      "aliases": [
        {
          "value": "9acerner-acfe-11e7-abc4-cec278b6b50c",
          "system": "3.16.840.1.113883.4.6",
          "type": "EXTERNAL"
        }
      ]
    }
  ],
  "totalResults": 2,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups?offset=0&limit=20"
}

GET /personnel-groups/{personnelGroupId}/dynamic-personnel-groups

Returns a list of dynamic personnel groups that contain a provided personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
personnelGroupId path string true N/A The ID of the personnel group. -
offset query integer(int32) false 0 The number of results to skip from the beginning of the list of results (typically for the purpose of paging). The minimum offset is 0. There is no maximum offset. -
limit query integer(int32) false 20 The maximum number of results to display per page. The minimum limit is 1. The maximum limit is 100. -

Response Statuses

Status Meaning Description Schema
200 OK Collection of Dynamic Personnel Group objects DynamicPersonnelGroups
400 Bad Request Bad Request Error
404 Not Found Not Found Error

Retrieve All Valid Mnemonics

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-group-mnemonics', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-group-mnemonics \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "ad_hoc_reporting_administrators",
      "type": "SINGLETON"
    },
    {
      "id": "analytics_administrators",
      "type": "SINGLETON"
    },
    {
      "id": "analytics_content_authors",
      "type": "SINGLETON"
    },
    {
      "id": "analytics_data_authors",
      "type": "SINGLETON"
    },
    {
      "id": "analytics_query_authors",
      "type": "SINGLETON"
    },
    {
      "id": "analytics_whitelist",
      "type": "SINGLETON"
    },
    {
      "id": "announcement_tool_whitelist",
      "type": "SINGLETON"
    },
    {
      "id": "assignable_care_managers",
      "type": "SINGLETON"
    },
    {
      "id": "ATTENDING_PROVIDERS",
      "type": "SINGLETON"
    },
    {
      "id": "attributable_personnel",
      "type": "SINGLETON"
    },
    {
      "id": "behavioral_health",
      "type": "SINGLETON"
    },
    {
      "id": "care_management_administrators",
      "type": "SINGLETON"
    },
    {
      "id": "care_management_whitelist",
      "type": "SINGLETON"
    },
    {
      "id": "clinical_document_viewers",
      "type": "SINGLETON"
    },
    {
      "id": "cost_accounting_whitelist",
      "type": "SINGLETON"
    },
    {
      "id": "data_ingestion_administrators",
      "type": "SINGLETON"
    },
    {
      "id": "data_ingestion_tool_whitelist",
      "type": "SINGLETON"
    },
    {
      "id": "data_syndication_whitelist",
      "type": "SINGLETON"
    },
    {
      "id": "demographics_data_entry_clerks",
      "type": "SINGLETON"
    },
    {
      "id": "genetic_counselor",
      "type": "SINGLETON"
    }
  ],
  "totalResults": 72,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-group-mnemonics?offset=0&limit=20",
  "lastLink": "https:/cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-group-mnemonics?offset=60&limit=20",
  "nextLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/personnel-group-mnemonics?offset=20&limit=20"
}

GET /personnel-group-mnemonics

Returns a personnel group mnemonic list.

Parameters

Parameter In Type Required Default Description Accepted Values
offset query integer(int32) false 0 The number of results to skip from the beginning of the list of results (typically for the purpose of paging). The minimum offset is 0. There is no maximum offset. -
limit query integer(int32) false 20 The maximum number of results to display per page. The minimum limit is 1. The maximum limit is 100. -

Response Statuses

Status Meaning Description Schema
200 OK OK PersonnelGroupMnemonics
400 Bad Request Bad Request Error

Dynamic Personnel Groups

Dynamic personnel groups are groups of personnel derived from existing personnel groups. As members of the existing personnel groups change, those members are automatically added to or removed from the dynamic personnel groups as well. Dynamic personnel groups can be derived from an existing, single personnel group, or from logical intersections or unions of multiple personnel groups.

Retrieve a Dynamic Personnel Group List

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "1b69dc47-6358-4221-bb61-8618323d18a2",
      "name": "Analytics Data Authors",
      "mnemonic": "analytics_data_authors",
      "mnemonicType": "MULTIVALUED",
      "membersJoinType": "UNION",
      "aliases": [
        {
          "value": "8cbbffdc-acfe-11e7-abc4-cec278b6b50c",
          "system": "2.16.840.1.113883.4.6",
          "type": "EXTERNAL"
        }
      ]
    },
    {
      "id": "15d2635d-1264-4b36-9474-4ce28ffc4978",
      "name": "Analytics Data Model Consumers",
      "mnemonic": "analytics_data_model_consumers",
      "mnemonicType": "MULTIVALUED",
      "membersJoinType": "UNION",
      "aliases": [
        {
          "value": "9acerner-acfe-11e7-abc4-cec278b6b50c",
          "system": "3.16.840.1.113883.4.6",
          "type": "EXTERNAL"
        }
      ]
    }
  ],
  "totalResults": 2,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups?offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups?offset=0&limit=20"
}

GET /dynamic-personnel-groups

Returns a dynamic personnel group list matching the query.

Parameters

Parameter In Type Required Default Description Accepted Values
dynamicGroupId query array[string] false N/A Filters by the IDs of the dynamic personnel groups. -
offset query integer(int32) false 0 The number of results to skip from the beginning of the list of results (typically for the purpose of paging). The minimum offset is 0. There is no maximum offset. -
limit query integer(int32) false 20 The maximum number of results to display per page. The minimum limit is 1. The maximum limit is 100. -

Response Statuses

Status Meaning Description Schema
200 OK Collection of Dynamic Personnel Group objects DynamicPersonnelGroups
400 Bad Request Bad Request Error

Create a Dynamic Personnel Group

Example Request:




require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Content-Type' => 'application/json',
  'Accept' => 'application/json'
} 

result = HTTParty.post('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups', headers: headers, body: {"name":"Analytics Whitelist","mnemonic":"mpm_whitelist","membersJoinType":"UNION","aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Analytics Whitelist","mnemonic":"mpm_whitelist","membersJoinType":"UNION","aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}]}

Example response

{
  "id": "1928bad5-11d2-4028-af95-d7ae3c578567",
  "name": "Person Management",
  "mnemonic": "mpm_whitelist",
  "mnemonicType": "MULTIVALUED",
  "membersJoinType": "UNION",
  "aliases": [
    {
      "value": "123.456.7890",
      "system": "5ecaf544-01d5-01kf-95hj-8e2bcec12006",
      "type": "EXTERNAL"
    }
  ]
}

POST /dynamic-personnel-groups

Creates a dynamic personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
body body postDynamicPersonnelGroups true N/A No description -

Response Statuses

Status Meaning Description Schema
201 Created Dynamic Personnel Group object DynamicPersonnelGroup
400 Bad Request Bad Request Error
409 Conflict Conflict Error

Retrieve a Single Dynamic Personnel Group

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "id": "1928bad5-11d2-4028-af95-d7ae3c578567",
  "name": "Person Management",
  "mnemonic": "mpm_whitelist",
  "mnemonicType": "MULTIVALUED",
  "membersJoinType": "UNION",
  "aliases": [
    {
      "value": "123.456.7890",
      "system": "5ecaf544-01d5-01kf-95hj-8e2bcec12006",
      "type": "EXTERNAL"
    }
  ]
}

GET /dynamic-personnel-groups/{dynamicPersonnelGroupId}

Returns a single dynamic personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
dynamicPersonnelGroupId path string true N/A The ID of the dynamic personnel group. -

Response Statuses

Status Meaning Description Schema
200 OK Single Dynamic Personnel Group object DynamicPersonnelGroup
404 Not Found Not Found Error

Update a Dynamic Personnel Group

Example Request:




require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Content-Type' => 'application/json',
  'Accept' => 'application/json'
} 

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567', headers: headers, body: {"name":"Analytics Whitelist","mnemonic":"mpm_whitelist","membersJoinType":"UNION","aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}]}.to_json )

print JSON.pretty_generate(result)




# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Analytics Whitelist","mnemonic":"mpm_whitelist","membersJoinType":"UNION","aliases":[{"value":"123.456.7890","system":"5ecaf544-01d5-01kf-95hj-8e2bcec12006","type":"EXTERNAL"}]}

PUT /dynamic-personnel-groups/{dynamicPersonnelGroupId}

Updates a dynamic personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
dynamicPersonnelGroupId path string true N/A The ID of the dynamic personnel group. -
body body putDynamicPersonnelGroups true N/A No description -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
400 Bad Request Bad Request Error
404 Not Found Not Found Error
409 Conflict Conflict Error

Remove a Dynamic Personnel Group

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/1928bad5-11d2-4028-af95-d7ae3c578567 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /dynamic-personnel-groups/{dynamicPersonnelGroupId}

Removes a dynamic personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
dynamicPersonnelGroupId path string true N/A The ID of the dynamic personnel group. -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
404 Not Found Not Found Error

Retrieve a Dynamic Personnel Group Members List

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.get('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/member-personnel-groups', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/member-personnel-groups \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

Example response

{
  "items": [
    {
      "id": "1b69dc47-6358-4221-bb61-8618323d18a2",
      "name": "Analytics Data Authors"
    },
    {
      "id": "15d2635d-1264-4b36-9474-4ce28ffc4978",
      "name": "Analytics Data Model Consumers"
    }
  ],
  "totalResults": 2,
  "firstLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/member-personnel-groups&offset=0&limit=20",
  "lastLink": "https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/member-personnel-groups&offset=0&limit=20"
}

GET /dynamic-personnel-groups/{dynamicPersonnelGroupId}/member-personnel-groups

Returns a dynamic personnel group member list.

Parameters

Parameter In Type Required Default Description Accepted Values
dynamicPersonnelGroupId path string true N/A The ID of the dynamic personnel group. -
memberPersonnelGroupName query string false N/A Filters by the name of the personnel group within a dynamic personnel group. Filtering by a partial match is allowed. -
offset query integer(int32) false 0 The number of results to skip from the beginning of the list of results (typically for the purpose of paging). The minimum offset is 0. There is no maximum offset. -
limit query integer(int32) false 20 The maximum number of results to display per page. The minimum limit is 1. The maximum limit is 100. -
orderBy query string false name Orders results by a given value in ascending or descending alphabetic order; to specify descending, prefix the value with a hyphen (-). name, -name

Response Statuses

Status Meaning Description Schema
200 OK Collection of Dynamic Personnel Group Member objects. DynamicPersonnelGroupMembers
400 Bad Request Bad Request Error
404 Not Found Not Found Error

Add a Dynamic Personnel Group Member

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.put('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/member-personnel-groups/222db7d9-7d6b-467b-9f99-d884883939f3', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/member-personnel-groups/222db7d9-7d6b-467b-9f99-d884883939f3 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

PUT /dynamic-personnel-groups/{dynamicPersonnelGroupId}/member-personnel-groups/{personnelGroupMemberId}

Adds a personnel member to the dynamic personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
dynamicPersonnelGroupId path string true N/A The ID of the dynamic personnel group. -
personnelGroupMemberId path string true N/A The ID of the personnel group being added to the dynamic personnel group. -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
404 Not Found Not Found Error
409 Conflict Conflict Error

Remove a Dynamic Personnel Group Member

Example Request:


require 'httparty' # Using HTTParty 0.16.2
require 'json'

headers = {
  'Authorization' => '<auth_header>',
  'Accept' => 'application/json'
} 

result = HTTParty.delete('https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/member-personnel-groups/222db7d9-7d6b-467b-9f99-d884883939f3', headers: headers)

print JSON.pretty_generate(result)


# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/personnel/v1/dynamic-personnel-groups/01e28848-0bad-4f09-ab46-4a7cc5bef73c/member-personnel-groups/222db7d9-7d6b-467b-9f99-d884883939f3 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'

DELETE /dynamic-personnel-groups/{dynamicPersonnelGroupId}/member-personnel-groups/{personnelGroupMemberId}

Removes a personnel member from the dynamic personnel group.

Parameters

Parameter In Type Required Default Description Accepted Values
dynamicPersonnelGroupId path string true N/A The ID of the dynamic personnel group. -
personnelGroupMemberId path string true N/A The ID of the personnel group to be removed from the dynamic personnel group. -

Response Statuses

Status Meaning Description Schema
204 No Content No content None
404 Not Found Not Found Error

Schema Definitions

Personnels

Name Type Required Description Accepted Values
items [Personnel] true [Personnel model] -
firstLink string true The first page of results. -
lastLink string true The last page of results. -
prevLink string false The previous page of results. -
nextLink string false The next page of results. -
totalResults integer(int32) true The total number of results for the specified parameters. -

Personnel

Name Type Required Description Accepted Values
id string true The ID of the personnel entity. -
birthDate string false The birth date of the personnel entity. Must be an exact date in YYYY-MM-DD format. -
gender string false The gender of the personnel entity. MALE, FEMALE, OTHER, UNKNOWN
name object true The name components of the personnel entity. -
addresses [Address] false The addresses of the personnel entity. -
aliases [Alias] false The aliases of the personnel entity. -
telecoms [Telecom] false The contact details of the personnel entity. -
languages [string] false BCP 47 formatted language tags indicating what languages the personnel knows, in order of preference. For valid subtags, see the following page on the Internet Assigned Numbers Authority (IANA) website: Language Subtab Registry. -
qualifications [Qualification] false The qualifications of the personnel entity. -
sourceIdentifiers [SourceIdentifier] false The identifiers linking the personnel entity to an external source. -
isManual boolean false Indicates whether this personnel entity was created manually. -
createdAt string(date-time) true The date and time in YYYY-MM-DDThh:mm:ssZ format when the personnel entity was created. -
updatedAt string(date-time) true The date and time in YYYY-MM-DDThh:mm:ssZ format of the most recent update to this personnel entity. -

Address

Name Type Required Description Accepted Values
postalCode string false The region defined by the postal service for this address. -
country string false The nation specified for this address. -
use string false The type of address. HOME, WORK
text string false The formatted display text of the address. -
city string false The city of the address. -
state string false The state of the address. -
lines [string] false The street component of the address. -

Alias

Name Type Required Description Accepted Values
type string true The type of alias. Note: You still can retrieve personnel by NPI and DEA, but you cannot create or update personnel with those alias types. NPI, DEA, SPI, TAX, SL, EXTERNAL, UPIN, USER, UNKNOWN
value string true The unique identifier used to identify the alias. -
system string true The source of the alias value. This is needed because an alias value that is unique within a given assigning authority is not guaranteed to be unique across sources. -

Telecom

Name Type Required Description Accepted Values
system string true The type of telecom system being used. PHONE, EMAIL, OTHER
value string true The value of the telecom. -

Qualification

Name Type Required Description Accepted Values
issuer string true What institute issued the qualification. -
code string true Qualification code such as MD or PhD. AA, AAS, ABA, AE, AS, BA, BBA, BE, BFA, BN, BS, BSL, BSN, BT, CANP, CER, CMA, CNM, CNP, CNS, CPNP, CRN, CTR, DBA, DED, DIP, DO, EMT, EMTP, FPNP, HS, JD, MA, MBA, MCE, MD, MDA, MDI, ME, MED, MEE, MFA, MME, MS, MSL, MSN, MT, MTH, NG, NP, PA, PHD, PHE, PNS, PN, PharmD, RMA, RN, RPH, SEC, TS
start string false The first date and time that the qualification is valid, must be in the format yyyy-mm-ddThh:mm:ssZ such as 2000-11-30T05:00:00Z. -
end string false The date and time that the qualification expires, must be in the format yyyy-mm-ddThh:mm:ssZ such as 2020-11-30T05:00:00Z. -

SourceIdentifier

Name Type Required Description Accepted Values
id string true The IDs intended to link personnel in HealtheIntent to personnel from an external data source. For Cerner Millennium, the unique ID should match the record ID for that personnel. For non-Cerner Millennium, the unique source system record ID should match the personnel ID or provider ID used for that personnel member in the raw source data onboarded into HealtheIntent. -
dataPartitionId string true The data partition ID should match the HealtheIntent partition ID for the data source. -

Name

Name Type Required Description Accepted Values
prefix string false The parts that come before the name such as Dr., Mr., or Mrs. -
suffix string false The parts that come after the name such as MD, III, or Jr. -
given string false The given name, usually the first name. -
middle string false The middle name. -
family string false The family name, usually the last name. -
formatted string true The fully formatted name. This is created from the discrete components (prefix, given, middle, family, and suffix) if not provided. -

PersonnelGroups

Name Type Required Description Accepted Values
items [PersonnelGroup] true [PersonnelGroup model] -
firstLink string true The first page of results. -
lastLink string true The last page of results. -
prevLink string false The previous page of results. -
nextLink string false The next page of results. -
totalResults integer(int32) true The total number of results for the specified parameters. -

PersonnelGroup

Name Type Required Description Accepted Values
id string true The ID of the personnel group. -
name string true The name of the personnel group. -
mnemonic string true The mnemonic determines the function of the personnel group. For example, a mnemonic with an application name followed by _whitelist indicates that the members of the group have access to that specific application. The list of valid mnemonics can be found through the /personnel-group-mnemonics endpoint or on the Configure Personnel Groups in the HealtheIntent Security Model Reference Page on Cerner Wiki. -
dynamicPersonnelGroupId string false The dynamic personnel group ID. This attribute is populated for personnel groups that are generated from a dynamic personnel group. -
aliases [PersonnelGroupAlias] false The aliases of the personnel group. -
isManual boolean false Indicates whether this personnel group was created manually. -
createdAt string(date-time) true The date and time in YYYY-MM-DDThh:mm:ssZ format when the personnel group was created. -
updatedAt string(date-time) true The date and time in YYYY-MM-DDThh:mm:ssZ format of the most recent update to this personnel group. -

PersonnelGroupAlias

Name Type Required Description Accepted Values
type string true The type of alias. EXTERNAL
value string true The unique identifier used to identify the alias. -
system string true The source of the alias value. This is needed because an alias value that is unique within a given assigning authority is not guaranteed to be unique across sources. -

PersonnelGroupMembers

Name Type Required Description Accepted Values
items [PersonnelGroupMember] true No description -
firstLink string true The first page of results. -
lastLink string true The last page of results. -
prevLink string false The previous page of results. -
nextLink string false The next page of results. -
totalResults integer(int32) true The total number of results for the specified parameters. -

PersonnelGroupMember

Name Type Required Description Accepted Values
id string true The ID of the personnel member. -
name string true The name of the personnel member. -

PersonnelGroupMnemonics

Name Type Required Description Accepted Values
items [PersonnelGroupMnemonic] true No description -
firstLink string true The first page of results. -
lastLink string true The last page of results. -
prevLink string false The previous page of results. -
nextLink string false The next page of results. -
totalResults integer(int32) true The total number of results for the specified parameters. -

PersonnelGroupMnemonic

Name Type Required Description Accepted Values
id string true The ID of the personnel group mnemonic. -
type string true The type of the personnel group mnemonic. SINGLETON, MULTIVALUED

DynamicPersonnelGroups

Name Type Required Description Accepted Values
items [DynamicPersonnelGroup] true [DynamicPersonnelGroup model] -
firstLink string true The first page of results. -
lastLink string true The last page of results. -
prevLink string false The previous page of results. -
nextLink string false The next page of results. -
totalResults integer(int32) true The total number of results for the specified parameters. -

DynamicPersonnelGroup

Name Type Required Description Accepted Values
id string true The ID of the dynamic personnel group. -
name string true The name of the dynamic personnel group. -
mnemonic string true The mnemonic determines the function of the dynamic personnel group. For example, a mnemonic with an application name followed by _whitelist indicates that the members of the group have access to that specific application. The list of valid mnemonics can be found through the /personnel-group-mnemonics endpoint or on the Configure Personnel Groups in the HealtheIntent Security Model Reference Page on Cerner Wiki. -
mnemonicType string true The type of the personnel group mnemonic. SINGLETON, MULTIVALUED
membersJoinType string true The method by which personnel group members are added to the dynamic personnel groups as members. UNION, INTERSECTION
aliases [PersonnelGroupAlias] false The aliases of the dynamic personnel group. -

DynamicPersonnelGroupMembers

Name Type Required Description Accepted Values
items [DynamicPersonnelGroupMember] true No description -
firstLink string true The first page of results. -
lastLink string true The last page of results. -
prevLink string false The previous page of results. -
nextLink string false The next page of results. -
totalResults integer(int32) true The total number of results for the specified parameters. -

DynamicPersonnelGroupMember

Name Type Required Description Accepted Values
id string true The ID of the personnel member. -
name string true The name of the personnel member. -

Error

Name Type Required Description Accepted Values
code integer(int32) true The HTTP response status code that represents the error. -
message string true A human-readable description of the error. -
errorDetails [ErrorDetail] false A list of additional error details. -

ErrorDetail

Name Type Required Description Accepted Values
domain string false A subsystem or context where an error occurred. -
reason string false A codified value that represents the specific error that caused the current error status. -
message string false A human-readable description of an error. -
locationType string false The location or type of the field that caused an error. query, header, path, formData, body
location string false The name of the field that caused an error. -

postPersonnel

Name Type Required Description Accepted Values
birthDate string false The birth date of the personnel entity. Must be an exact date in YYYY-MM-DD format. -
gender string false The gender of the personnel entity. MALE, FEMALE, OTHER, UNKNOWN
languages [string] false BCP 47 formatted language tags indicating what languages the personnel knows, in order of preference. For valid subtags, see the following page on the Internet Assigned Numbers Authority (IANA) website: Language Subtab Registry. -
name object true The name components of the personnel entity. -
» given string true The given name, usually the first name. -
» family string true The family name, usually the last name. -
» prefix string false The parts that come before the name such as Dr., Mr., or Mrs. -
» middle string false The middle name. -
» suffix string false The parts that come after the name such as MD, III, or Jr. -
» formatted string false The fully formatted name. This is created from the discrete components (prefix, given, middle, family, and suffix) if not provided. -
addresses [Address] false The addresses of the personnel entity. -
aliases [Alias] false The aliases of the personnel entity. -
telecoms [Telecom] false The contact details of the personnel entity. -
qualifications [Qualification] false The qualifications of the personnel entity. -
sourceIdentifiers [SourceIdentifier] false The identifiers linking the personnel entity to an external source. -

putPersonnel

Name Type Required Description Accepted Values
birthDate string false The birth date of the personnel entity. Must be an exact date in YYYY-MM-DD format. -
gender string false The gender of the personnel entity. MALE, FEMALE, OTHER, UNKNOWN
languages [string] false BCP 47 formatted language tags indicating what languages the personnel knows, in order of preference. For valid subtags, see the following page on the Internet Assigned Numbers Authority (IANA) website: Language Subtab Registry. -
name object true The name components of the personnel entity. -
» given string true The given name, usually the first name. -
» family string true The family name, usually the last name. -
» prefix string false The parts that come before the name such as Dr., Mr., or Mrs. -
» middle string false The middle name. -
» suffix string false The parts that come after the name such as MD, III, or Jr. -
» formatted string false The fully formatted name. This is created from the discrete components (prefix, given, middle, family, and suffix) if not provided. -
addresses [Address] false The addresses of the personnel entity. -
aliases [Alias] false The aliases of the personnel entity. -
telecoms [Telecom] false The contact details of the personnel entity. -
qualifications [Qualification] false The qualifications of the personnel entity. -
sourceIdentifiers [SourceIdentifier] false The identifiers linking the personnel entity to an external source. -

postPersonnelGroups

Name Type Required Description Accepted Values
name string true The name of the personnel group. -
mnemonic string true The mnemonic determines the function of the personnel group. For example, a mnemonic with an application name followed by _whitelist indicates that the members of the group have access to that specific application. -
aliases [PersonnelGroupAlias] false The aliases of the personnel group. -

putPersonnelGroups

Name Type Required Description Accepted Values
name string true The name of the personnel group. -
mnemonic string true The mnemonic determines the function of the personnel group. For example, a mnemonic with an application name followed by _whitelist indicates that the members of the group have access to that specific application. -
aliases [PersonnelGroupAlias] false The aliases of the personnel group. -

postDynamicPersonnelGroups

Name Type Required Description Accepted Values
name string true The name of the dynamic personnel group. -
mnemonic string true The mnemonic determines the function of the dynamic personnel group. For example, a mnemonic with an application name followed by _whitelist indicates that the members of the group have access to that specific application. -
membersJoinType string true The method by which personnel group members are added to the dynamic personnel groups as members. UNION, INTERSECTION
aliases [PersonnelGroupAlias] false The aliases of the personnel groups. -

putDynamicPersonnelGroups

Name Type Required Description Accepted Values
name string true The name of the dynamic personnel group. -
mnemonic string true The mnemonic determines the function of the dynamic personnel group. For example, a mnemonic with an application name followed by _whitelist indicates that the members of the group have access to that specific application. -
membersJoinType string true The method by which personnel group members are added to the dynamic personnel groups as members. UNION, INTERSECTION
aliases [PersonnelGroupAlias] false The aliases of the personnel groups. -