Attribution API v1
Attribution is a relation between a provider and a person, which indicates that the provider is responsible for the person’s health outcomes.
The Oracle Health Data Intelligence Attribution API enables the configuration of available attribution algorithms for a given population based on the requirements. See Attribution Algorithm Overview in the Reference Pages on Cerner Wiki for more information.
Note: The data retrieved by this API is filtered based on your sensitive data filters for Health Data Intelligence. Ensure that your implementations of this API are designed with this in mind, and if you integrate data from Health Data Intelligence into a clinical workflow using this API, ensure that your users are informed of your sensitive data filters. See Understand Sensitive Data in Oracle Health Data Intelligence in the Reference Pages on Cerner Wiki for more information.
URL: https://cernerdemo.api.us-1.healtheintent.com/attribution/v1
Configurations
The attribution configuration specifies the attribution algorithm and its corresponding custom settings to be used for processing a given client’s data.
Create a Configuration
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/attribution/v1/configurations', headers: headers, body: {"name":"Attribution production configuration.","description":"This attribution configuration is for production.","population":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d"},"algorithm":{"id":"fc36d5ee-955d-47ab-ae81-233756b07e3b","version":"1.0.0","name":"Cerner Standard attribution algorithm - Template 1","description":"This algorithm attributes the persons who have one of the following criteria:\n Hard Attribution, Hard Attribution and Soft attribution.\n Hard Attribution, Soft Attribution, Hard Attribution, and Soft attribution.\n Hard Attribution, Hard Attribution, Soft Attribution, and Soft attribution.\n Hard Attribution, Soft Attribution, Soft Attribution, and Hard attribution.","customSettings":[{"description":"Map of personnel by id of those personnel that are attributable.","key":"cernerdemo-attribution/attributable-personnel-by-id","settingValueType":"PERSONNEL_BY_ID","metadata":[{"dataSetType":"PERSONNEL_GROUP_MNEMONIC","referenceId":"attributable_personnel"}]}]}}.to_json )
print JSON.pretty_generate(result)
# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/configurations \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Attribution production configuration.","description":"This attribution configuration is for production.","population":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d"},"algorithm":{"id":"fc36d5ee-955d-47ab-ae81-233756b07e3b","version":"1.0.0","name":"Cerner Standard attribution algorithm - Template 1","description":"This algorithm attributes the persons who have one of the following criteria:\n Hard Attribution, Hard Attribution and Soft attribution.\n Hard Attribution, Soft Attribution, Hard Attribution, and Soft attribution.\n Hard Attribution, Hard Attribution, Soft Attribution, and Soft attribution.\n Hard Attribution, Soft Attribution, Soft Attribution, and Hard attribution.","customSettings":[{"description":"Map of personnel by id of those personnel that are attributable.","key":"cernerdemo-attribution/attributable-personnel-by-id","settingValueType":"PERSONNEL_BY_ID","metadata":[{"dataSetType":"PERSONNEL_GROUP_MNEMONIC","referenceId":"attributable_personnel"}]}]}}
Example response
{
"id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
"version": "1",
"name": "Attribution configuration For Client A - 2020",
"description": "This attribution configuration is for production.",
"population": {
"id": "1424e81d-8cea-4d6b-b140-d6630c684a58"
},
"algorithm": {
"id": "fc36d5ee-955d-47ab-ae81-233756b07e3b",
"version": "1.0.0",
"name": "Cerner Standard attribution algorithm - Template 1",
"description": "This algorithm attributes the persons who have one of the following criteria:\nHard Attribution, Hard Attribution and Soft attribution.\nHard Attribution, Soft Attribution, Hard Attribution, and Soft attribution.\nHard Attribution, Hard Attribution, Soft Attribution, and Soft attribution.\nHard Attribution, Soft Attribution, Soft Attribution, and Hard attribution.\n",
"customSettings": [
{
"description": "Map of personnel by id of those personnel that are attributable.",
"key": "cernerdemo-attribution/attributable-personnel-by-id",
"settingValueType": "PERSONNEL_BY_ID",
"metadata": [
{
"dataSetType": "PERSONNEL_GROUP_MNEMONIC",
"referenceId": "attributable_personnel"
}
]
}
]
},
"createdAt": "2020-11-11T12:30:45Z",
"updatedAt": "2020-11-11T12:30:45Z"
}
POST /configurations
Creates a new configuration for a client.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| body | body | postConfigurations | true | N/A | No description | - |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | A configuration object. | AttributionPublicApi_Entities_V1_Configuration_Configuration |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
Retrieve a List of Configurations
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/attribution/v1/configurations', headers: headers)
print JSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/configurations \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'
Example response
{
"items": [
{
"id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
"version": "1",
"name": "Attribution configuration For Client A - 2020",
"description": "This attribution configuration is for production.",
"population": {
"id": "1424e81d-8cea-4d6b-b140-d6630c684a58"
},
"algorithm": {
"id": "fc36d5ee-955d-47ab-ae81-233756b07e3b",
"version": "1.0.0",
"name": "Cerner Standard attribution algorithm - Template 1",
"description": "This algorithm attributes the persons who have one of the following criteria:\nHard Attribution, Hard Attribution and Soft attribution.\nHard Attribution, Soft Attribution, Hard Attribution, and Soft attribution.\nHard Attribution, Hard Attribution, Soft Attribution, and Soft attribution.\nHard Attribution, Soft Attribution, Soft Attribution, and Hard attribution.\n",
"customSettings": [
{
"description": "Map of personnel by id of those personnel that are attributable.",
"key": "cernerdemo-attribution/attributable-personnel-by-id",
"settingValueType": "PERSONNEL_BY_ID",
"metadata": [
{
"dataSetType": "PERSONNEL_GROUP_MNEMONIC",
"referenceId": "attributable_personnel"
}
]
}
]
},
"createdAt": "2020-11-11T12:30:45Z",
"updatedAt": "2020-11-11T12:30:45Z"
}
],
"totalResults": 1,
"firstLink": "https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/configurations?offset=0&limit=20",
"lastLink": "https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/configurations?offset=0&limit=20"
}
GET /configurations
Retrieves a list of all configurations available for a given client when no parameters are passed. The most recently created version of the configuration is retrieved based on the population ID included in the query parameters.Note: For any population ID, more than one active configuration cannot exist.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| populationId | query | string | false | N/A | The unique ID of the population. | - |
| 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,updatedAt | A comma-separated list of fields by which to sort. | name, -name, updatedAt, -updatedAt |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | A collection of configuration objects. | Configurations |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
| 404 | Not Found | Not Found | Error |
Delete a Configuration
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/attribution/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers)
print JSON.pretty_generate(result)
# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'
DELETE /configurations/{configurationId}
Deletes an existing configuration.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| configurationId | path | string | true | N/A | The unique ID of the configuration. | - |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | No content (Delete successful) | None |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
| 404 | Not Found | Not Found | Error |
Update a Configuration
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/attribution/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91', headers: headers, body: {"name":"Attribution production configuration.","description":"This attribution configuration is for production.","population":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d"},"algorithm":{"id":"fc36d5ee-955d-47ab-ae81-233756b07e3b","version":"1.0.0","name":"Cerner Standard attribution algorithm - Template 1","description":"This algorithm attributes the persons who have one of the following criteria:\n Hard Attribution, Hard Attribution and Soft attribution.\n Hard Attribution, Soft Attribution, Hard Attribution, and Soft attribution.\n Hard Attribution, Hard Attribution, Soft Attribution, and Soft attribution.\n Hard Attribution, Soft Attribution, Soft Attribution, and Hard attribution.","customSettings":[{"description":"Map of personnel by id of those personnel that are attributable.","key":"cernerdemo-attribution/attributable-personnel-by-id","settingValueType":"PERSONNEL_BY_ID","metadata":[{"dataSetType":"PERSONNEL_GROUP_MNEMONIC","referenceId":"attributable_personnel"}]}]}}.to_json )
print JSON.pretty_generate(result)
# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/configurations/a426149a-c19c-413a-8d9f-d7988aec4a91 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"Attribution production configuration.","description":"This attribution configuration is for production.","population":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d"},"algorithm":{"id":"fc36d5ee-955d-47ab-ae81-233756b07e3b","version":"1.0.0","name":"Cerner Standard attribution algorithm - Template 1","description":"This algorithm attributes the persons who have one of the following criteria:\n Hard Attribution, Hard Attribution and Soft attribution.\n Hard Attribution, Soft Attribution, Hard Attribution, and Soft attribution.\n Hard Attribution, Hard Attribution, Soft Attribution, and Soft attribution.\n Hard Attribution, Soft Attribution, Soft Attribution, and Hard attribution.","customSettings":[{"description":"Map of personnel by id of those personnel that are attributable.","key":"cernerdemo-attribution/attributable-personnel-by-id","settingValueType":"PERSONNEL_BY_ID","metadata":[{"dataSetType":"PERSONNEL_GROUP_MNEMONIC","referenceId":"attributable_personnel"}]}]}}
Example response
{
"id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
"version": "1",
"name": "Attribution configuration For Client A - 2020",
"description": "This attribution configuration is for production.",
"population": {
"id": "1424e81d-8cea-4d6b-b140-d6630c684a58"
},
"algorithm": {
"id": "fc36d5ee-955d-47ab-ae81-233756b07e3b",
"version": "1.0.0",
"name": "Cerner Standard attribution algorithm - Template 1",
"description": "This algorithm attributes the persons who have one of the following criteria:\nHard Attribution, Hard Attribution and Soft attribution.\nHard Attribution, Soft Attribution, Hard Attribution, and Soft attribution.\nHard Attribution, Hard Attribution, Soft Attribution, and Soft attribution.\nHard Attribution, Soft Attribution, Soft Attribution, and Hard attribution.\n",
"customSettings": [
{
"description": "Map of personnel by id of those personnel that are attributable.",
"key": "cernerdemo-attribution/attributable-personnel-by-id",
"settingValueType": "PERSONNEL_BY_ID",
"metadata": [
{
"dataSetType": "PERSONNEL_GROUP_MNEMONIC",
"referenceId": "attributable_personnel"
}
]
}
]
},
"createdAt": "2020-11-11T12:30:45Z",
"updatedAt": "2020-11-11T12:30:45Z"
}
PUT /configurations/{configurationId}
Updates an existing configuration for a client.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| configurationId | path | string | true | N/A | The unique ID of the configuration. | - |
| body | body | putConfigurations | true | N/A | No description | - |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | A single configuration object. | AttributionPublicApi_Entities_V1_Configuration_Configuration |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
| 404 | Not Found | Not Found | Error |
Algorithms
The attribution algorithm defines the algorithm to be used by the configurations. The algorithm is used to identify namespaces of the rules and the available settings.
Retrieve a List of Algorithms
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/attribution/v1/algorithms', headers: headers)
print JSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/algorithms \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'
Example response
{
"items": [
{
"id": "fc36d5ee-955d-47ab-ae81-233756b07e3b",
"version": "1.0.0",
"name": "Cerner Standard attribution algorithm - Template 1",
"description": "This algorithm attributes the persons who have one of the following criteria:\nHard Attribution, Hard Attribution and Soft attribution.\nHard Attribution, Soft Attribution, Hard Attribution, and Soft attribution.\nHard Attribution, Hard Attribution, Soft Attribution, and Soft attribution.\nHard Attribution, Soft Attribution, Soft Attribution, and Hard attribution.\n",
"availableSettings": [
{
"name": "scoring-group-by-id",
"required": true,
"description": "Map of scoring group objects by id for all scoring groups.",
"default": null,
"processingConfiguration": {
"key": "cernerdemo-attribution/scoring-group-by-id",
"settingValueType": "PERSONNEL_GROUP_BY_ID"
}
},
{
"name": "ppr-type-concepts",
"required": false,
"description": "Concepts used to identify the primary care provider PPR for hard attribution. Any additional types should be provided using config.",
"default": "[\"PRIMARY_CARE_PROVIDER_PRROLE\", \"ATTRIBUTED_PROVIDER_PRROLE\"]",
"processingConfiguration": {
"key": "cernerdemo-attribution/ppr-type-concepts",
"settingValueType": "STRINGS"
}
},
{
"name": "visit-lookback-period",
"required": false,
"description": "Lookback period in months for visits.",
"default": "24",
"processingConfiguration": {
"key": "cernerdemo-attribution/visit-lookback-period",
"settingValueType": "STRING"
}
},
{
"name": "pcp-hard-look-back",
"required": false,
"description": "Number of days to look back for a ProviderRelationship.endDate",
"default": "180",
"processingConfiguration": {
"key": "cernerdemo-attribution/pcp-hard-look-back",
"settingValueType": "STRING"
}
},
{
"name": "gecb-partitions",
"required": true,
"description": "Setting for set of GECB data partitions.",
"default": null,
"processingConfiguration": {
"key": "cernerdemo-attribution/gecb-partitions",
"settingValueType": "DATA_PARTITION_IDS"
}
},
{
"name": "emr-data-partitions",
"required": true,
"description": "Setting for set of emr data partitions.",
"default": null,
"processingConfiguration": {
"key": "cernerdemo-attribution/emr-data-partitions",
"settingValueType": "DATA_PARTITION_IDS"
}
}
]
}
],
"totalResults": 1,
"firstLink": "https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/algorithms?offset=0&limit=20",
"lastLink": "https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/algorithms?offset=0&limit=20"
}
GET /algorithms
Retrieves a list of algorithms available for a client.
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. | - |
| orderBy | query | string | false | name,updatedAt | A comma-separated list of fields by which to sort. | name, -name, updatedAt, -updatedAt |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | A collection of algorithm objects. | Algorithms |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
Pipelines
An Attribution Pipeline is an instance of a configurable data pipeline for running an Attribution Job. Attribution Entitlement would limit the number of Pipelines the tenant could run.
Create a Pipeline
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/attribution/v1/pipelines', headers: headers, body: {"name":"name","population":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d"},"state":"ACTIVE","executionSettings":{"frequencyValue":8,"frequencyUnit":"HOURS","timeOfDay":"00:00"},"properties":[{"key":"property key 1","value":"property detail 1"},{"key":"property key 2","value":"property detail 2"}],"job":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d","version":2}}.to_json )
print JSON.pretty_generate(result)
# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/pipelines \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"name","population":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d"},"state":"ACTIVE","executionSettings":{"frequencyValue":8,"frequencyUnit":"HOURS","timeOfDay":"00:00"},"properties":[{"key":"property key 1","value":"property detail 1"},{"key":"property key 2","value":"property detail 2"}],"job":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d","version":2}}
Example response
{
"id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
"version": 2,
"name": "Attribution Pipeline 1",
"population": {
"id": "1424e81d-8cea-4d6b-b140-d6630c684a58"
},
"state": "ACTIVE",
"executionSettings": {
"frequencyValue": 8,
"frequencyUnit": "HOURS",
"timeOfDay": "00:00"
},
"lastRunStatus": "COMPLETED",
"lastSuccessfulRun": "2021-12-02T12:30:45Z",
"properties": [
{
"key": "property key 1",
"value": "property detail 1"
},
{
"key": "property key 2",
"value": "property detail 2"
}
],
"job": {
"id": "151d33be-cdc8-4637-89d4-c5c27b6f498d",
"version": 2
},
"tags": [
{
"key": "tag key 1",
"value": "tag detail 1"
},
{
"key": "tag key 2",
"value": "tag detail 2"
}
],
"createdAt": "2020-11-11T12:30:45Z",
"updatedAt": "2020-11-11T12:30:45Z"
}
POST /pipelines
Creates a new pipeline.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| body | body | postPipelines | true | N/A | No description | - |
Response Statuses
| Status | Meaning | Description | Schema |
|---|
|201|Created|A pipeline object.|AttributionPublicApi_Entities_V1_Pipeline_Pipeline| |400|Bad Request|Bad Request|Error| |401|Unauthorized|Unauthorized|Error| |403|Forbidden|Forbidden|Error|
Retrieve a List of Pipelines
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/attribution/v1/pipelines', headers: headers)
print JSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/pipelines \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'
Example response
{
"items": [
{
"id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
"version": 2,
"name": "Attribution Pipeline 1",
"population": {
"id": "1424e81d-8cea-4d6b-b140-d6630c684a58"
},
"state": "ACTIVE",
"executionSettings": {
"frequencyValue": 8,
"frequencyUnit": "HOURS",
"timeOfDay": "00:00"
},
"lastRunStatus": "COMPLETED",
"lastSuccessfulRun": "2021-12-02T12:30:45Z",
"properties": [
{
"key": "property key 1",
"value": "property detail 1"
},
{
"key": "property key 2",
"value": "property detail 2"
}
],
"job": {
"id": "151d33be-cdc8-4637-89d4-c5c27b6f498d",
"version": 2
},
"tags": [
{
"key": "tag key 1",
"value": "tag detail 1"
},
{
"key": "tag key 2",
"value": "tag detail 2"
}
],
"createdAt": "2020-11-11T12:30:45Z",
"updatedAt": "2020-11-11T12:30:45Z"
}
],
"totalResults": 1,
"firstLink": "https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/pipelines?offset=0&limit=20",
"lastLink": "https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/pipelines?offset=0&limit=20"
}
GET /pipelines
Retrieves a list of pipelines.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| populationId | query | string | false | N/A | The unique ID of the population. | - |
| tag | query | string | false | N/A | Filters the response by the specified tags. Each tag can be represented as a single key or a key:value pair. | - |
| 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,updatedAt | A comma-separated list of fields by which to sort. | name, -name, updatedAt, -updatedAt |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | A collection of pipeline objects. | Pipelines |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
Delete a Pipeline
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/attribution/v1/pipelines/74ee2a39-2703-4796-9b5e-d103e537e999', headers: headers)
print JSON.pretty_generate(result)
# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/pipelines/74ee2a39-2703-4796-9b5e-d103e537e999 \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'
DELETE /pipelines/{pipelineId}
Deletes a pipeline with the specified ID.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| pipelineId | path | string | true | N/A | The unique ID of the pipeline. | - |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | No content (Delete successful) | None |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
| 404 | Not Found | Not Found | Error |
Update a Pipeline
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/attribution/v1/pipelines/74ee2a39-2703-4796-9b5e-d103e537e999', headers: headers, body: {"name":"name","population":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d"},"state":"ACTIVE","executionSettings":{"frequencyValue":8,"frequencyUnit":"HOURS","timeOfDay":"00:00"},"properties":[{"key":"property key 1","value":"property detail 1"},{"key":"property key 2","value":"property detail 2"}],"job":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d","version":2}}.to_json )
print JSON.pretty_generate(result)
# You can also use wget
curl -X PUT https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/pipelines/74ee2a39-2703-4796-9b5e-d103e537e999 \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"name":"name","population":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d"},"state":"ACTIVE","executionSettings":{"frequencyValue":8,"frequencyUnit":"HOURS","timeOfDay":"00:00"},"properties":[{"key":"property key 1","value":"property detail 1"},{"key":"property key 2","value":"property detail 2"}],"job":{"id":"151d33be-cdc8-4637-89d4-c5c27b6f498d","version":2}}
Example response
{
"id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
"version": 2,
"name": "Attribution Pipeline 1",
"population": {
"id": "1424e81d-8cea-4d6b-b140-d6630c684a58"
},
"state": "ACTIVE",
"executionSettings": {
"frequencyValue": 8,
"frequencyUnit": "HOURS",
"timeOfDay": "00:00"
},
"lastRunStatus": "COMPLETED",
"lastSuccessfulRun": "2021-12-02T12:30:45Z",
"properties": [
{
"key": "property key 1",
"value": "property detail 1"
},
{
"key": "property key 2",
"value": "property detail 2"
}
],
"job": {
"id": "151d33be-cdc8-4637-89d4-c5c27b6f498d",
"version": 2
},
"tags": [
{
"key": "tag key 1",
"value": "tag detail 1"
},
{
"key": "tag key 2",
"value": "tag detail 2"
}
],
"createdAt": "2020-11-11T12:30:45Z",
"updatedAt": "2020-11-11T12:30:45Z"
}
PUT /pipelines/{pipelineId}
Updates a pipeline with the specified ID.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| pipelineId | path | string | true | N/A | The unique ID of the pipeline. | - |
| body | body | putPipelines | true | N/A | No description | - |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | The pipeline is successfully updated. | AttributionPublicApi_Entities_V1_Pipeline_Pipeline |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
| 404 | Not Found | Not Found | Error |
Retrieve a Pipeline
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/attribution/v1/pipelines/{pipelineId}', headers: headers)
print JSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/pipelines/{pipelineId} \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'
Example response
{
"id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
"version": 2,
"name": "Attribution Pipeline 1",
"population": {
"id": "1424e81d-8cea-4d6b-b140-d6630c684a58"
},
"state": "ACTIVE",
"executionSettings": {
"frequencyValue": 8,
"frequencyUnit": "HOURS",
"timeOfDay": "00:00"
},
"lastRunStatus": "COMPLETED",
"lastSuccessfulRun": "2021-12-02T12:30:45Z",
"properties": [
{
"key": "property key 1",
"value": "property detail 1"
},
{
"key": "property key 2",
"value": "property detail 2"
}
],
"job": {
"id": "151d33be-cdc8-4637-89d4-c5c27b6f498d",
"version": 2
},
"tags": [
{
"key": "tag key 1",
"value": "tag detail 1"
},
{
"key": "tag key 2",
"value": "tag detail 2"
}
],
"createdAt": "2020-11-11T12:30:45Z",
"updatedAt": "2020-11-11T12:30:45Z"
}
GET /pipelines/{pipelineId}
Retrieves a pipeline with the specified ID.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| pipelineId | path | string | true | N/A | The unique ID of the pipeline. | - |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Retrieves pipeline object successfully. | AttributionPublicApi_Entities_V1_Pipeline_Pipeline |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
Tags
Tags are used to assign metadata to the attribution pipeline or job resource. The metadata can be used to provide information on categorizing whether the resource is used for production or validation, or any arbitrary information related to tracking the issues contributing to the creation of the resource.
Create a Tag
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/attribution/v1/tags', headers: headers, body: {"key":"Tag Key 1","value":"Tag Key Value 1","resource":{"id":"a426149a-c19c-413a-8d9f-d7988aec4a91","type":"PIPELINE"}}.to_json)
print JSON.pretty_generate(result)
# You can also use wget
curl -X POST https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/tags \
-H 'Authorization: {auth_header}' \
-H 'Content-Type: application/json' \ \
-H 'Accept: application/json' \
-d {"key":"Tag Key 1","value":"Tag Key Value 1","resource":{"id":"a426149a-c19c-413a-8d9f-d7988aec4a91","type":"PIPELINE"}}
Example response
{
"id": "d1e7af18-713f-43db-806c-c8c8a77e5f89",
"key": "Tag Key 1",
"value": "Tag Key Value 1",
"resource": {
"id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
"type": "PIPELINE"
}
}
POST /tags
Creates a new tag for a pipleine or job.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| body | body | postTags | true | N/A | No description | - |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 201 | Created | A tag object. | AttributionPublicApi_Entities_V1_Tag_Tag |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
Retrieve a List of Tags
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/attribution/v1/tags', headers: headers)
print JSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/tags \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'
Example response
{
"items": [
{
"id": "d1e7af18-713f-43db-806c-c8c8a77e5f89",
"key": "Tag Key 1",
"value": "Tag Key Value 1",
"resource": {
"id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
"type": "PIPELINE"
}
}
],
"totalResults": 1,
"firstLink": "https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/tags?offset=0&limit=20",
"lastLink": "https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/tags?offset=0&limit=20"
}
GET /tags
Retrieves a list of tags.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| resourceType | query | string | false | N/A | The resource type of the tag pipeline or job. | - |
| 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 | key | A comma-separated list of fields by which to sort. | key, -key |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | A collection of tag objects. | Tags |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
Delete a Tag
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/attribution/v1/tags/{tagId}', headers: headers)
print JSON.pretty_generate(result)
# You can also use wget
curl -X DELETE https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/tags/{tagId} \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'
DELETE /tags/{tagId}
Deletes a tag with the specified ID.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| tagId | path | string | true | N/A | The unique ID of the tag. | - |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 204 | No Content | No content (Delete successful) | None |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
| 404 | Not Found | Not Found | Error |
Retrieve a Tag
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/attribution/v1/tags/{tagId}', headers: headers)
print JSON.pretty_generate(result)
# You can also use wget
curl -X GET https://cernerdemo.api.us-1.healtheintent.com/attribution/v1/tags/{tagId} \
-H 'Authorization: {auth_header}' \
-H 'Accept: application/json'
Example response
{
"id": "d1e7af18-713f-43db-806c-c8c8a77e5f89",
"key": "Tag Key 1",
"value": "Tag Key Value 1",
"resource": {
"id": "a426149a-c19c-413a-8d9f-d7988aec4a91",
"type": "PIPELINE"
}
}
GET /tags/{tagId}
Retrieves a tag with the specified ID.
Parameters
| Parameter | In | Type | Required | Default | Description | Accepted Values |
|---|---|---|---|---|---|---|
| tagId | path | string | true | N/A | The unique ID of the tag. | - |
Response Statuses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | Retrieves tag object successfully. | AttributionPublicApi_Entities_V1_Tag_Tag |
| 400 | Bad Request | Bad Request | Error |
| 401 | Unauthorized | Unauthorized | Error |
| 403 | Forbidden | Forbidden | Error |
Schema Definitions
postConfigurations
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| name | string | true | The unique name of the attribution configuration. | - |
| description | string | true | The description of the attribution configuration. | - |
| population | object | true | The unique ID of the population that identifies the longitudinal records used to process the attributions. | - |
| » id | string | true | The unique ID of the population. | - |
| algorithm | object | true | The algorithm that the provided configuration uses. | - |
| » id | string | true | The unique ID of the algorithm that is used by the configuration. | - |
| » version | string | true | The version of the algorithm used as part of the configuration. | - |
| » name | string | true | The name of the algorithm to use as part of the configuration. | - |
| » description | string | false | The description of the algorithm to use as part of the configuration. | - |
| » customSettings | [object] | false | The custom settings used by the algorithm during processing. These can have either configured values or metadata. | - |
| »» description | string | false | The description provided for the custom setting. | - |
| »» key | string | true | The unique key to identify the custom setting. | - |
| »» settingValueType | string | false | The type of the custom setting. | - |
| »» metadata | [object] | false | Metadata for the custom setting. | - |
| »»» dataSetType | string | true | The dataset type for the custom setting. | - |
| »»» referenceId | string | true | The reference ID used by the custom setting. | - |
| »» value | string | false | A single value for the custom setting. | - |
| »» values | [string] | false | The values used to initialize the custom setting. | - |
AttributionPublicApi_Entities_V1_Configuration_Configuration
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| id | string | true | The unique ID of the configuration. | - |
| version | integer(int32) | true | The version number of the configuration, which is incremented automatically. | - |
| name | string | true | The name of the configuration. | - |
| description | string | true | The description of the configuration. | - |
| population | AttributionPublicApi_Entities_V1_PopulationReference | true | The unique ID of the population that identifies the longitudinal records used to process the attributions. | - |
| algorithm | AttributionPublicApi_Entities_V1_Configuration_ConfigurationAlgorithm | true | The algorithm that the configuration uses. | - |
| createdAt | string | true | The date and time when the configuration was initially entered into the system. This value is provided in International Organization for Standardization (ISO) 8601 formatting with precision to YYYY-MM-DDThh:mm:ss.SSSZ, such as 2018-02-13T20:41:18.181Z. The time is set automatically when the configuration is first created. Therefore, the field does not need to be set explicitly. | - |
| updatedAt | string | true | The date and time when the configuration was updated in the system. This value is provided in ISO 8601 formatting with precision to YYYY-MM-DDThh:mm:ss.SSSZ, such as 2018-02-13T20:41:18.181Z. The time is set automatically when the configuration is updated. Therefore, the field does not need to be set explicitly. | - |
AttributionPublicApi_Entities_V1_PopulationReference
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| id | string | true | The unique ID of the population. | - |
AttributionPublicApi_Entities_V1_Configuration_ConfigurationAlgorithm
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| id | string | true | The unique ID of the algorithm. | - |
| version | string | true | The version of the algorithm to use as part of the configuration. | - |
| name | string | true | The name of the algorithm to use as part of the configuration. | - |
| description | string | false | The description of the algorithm to use as part of the configuration. | - |
| customSettings | [AttributionPublicApi_Entities_V1_Configuration_CustomSetting] | true | The custom settings the algorithm uses during processing. These can have either configured values or metadata. | - |
AttributionPublicApi_Entities_V1_Configuration_CustomSetting
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| description | string | false | The description provided for the custom setting. | - |
| key | string | true | The unique key to identify the custom setting. | - |
| settingValueType | string | false | The type of the custom setting. | BENEFIT_PLANS_BY_SOURCE_ID, ORGANIZATION, ORGANIZATION_RECORDS, ORG_IDS_BY_ORG_CLASS, ORG_NAME_BY_ID, ORG_SERVICE_POSTAL_CODES_BY_ID, PERSONNEL_BY_ID, PERSONNEL_BY_ORG_ID, PERSONNEL_GROUP_BY_ID, PRSNL_ORG_COMMITMENT_BY_ORG_ID |
| metadata | [AttributionPublicApi_Entities_V1_Configuration_Metadata] | false | Metadata for the custom setting. | - |
| value | string | false | A single value for the custom setting. | - |
| values | [string] | false | The values used to initialize the custom setting. | - |
AttributionPublicApi_Entities_V1_Configuration_Metadata
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| dataSetType | string | true | The dataset type of the custom setting. | PERSONNEL_GROUP, PERSONNEL_GROUP_MNEMONIC, PERSONNEL_GROUPS, PERSONNEL_PCOLLECTION, PERSONNEL_GROUP_PCOLLECTION, ORG_CLASS, ORGANIZATION, BENEFIT_PLAN_REF, ORGANIZATION_RECORD_REF, SUBPOPULATION, ORGANIZATIONS, ORGANIZATION_PCOLLECTION, PROVIDER_PERSONNEL_ROLES_PCOLLECTION, PROVIDER_BRANCH_CONFIG_PCOLLECTION, PROVIDER_HIERARCHY_BRANCH_PCOLLECTION, PROVIDER_SPECIALTY_PCOLLECTION |
| referenceId | string | true | The reference ID used by the custom setting. | - |
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. | - |
Configurations
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| items | [AttributionPublicApi_Entities_V1_Configuration_Configuration] | true | An array containing the current page of results. | - |
| totalResults | integer(int32) | false | The total number of results for the specified parameters. | - |
| firstLink | string | true | The first page of results. | - |
| lastLink | string | false | The last page of results. | - |
| prevLink | string | false | The previous page of results. | - |
| nextLink | string | false | The next page of results. | - |
putConfigurations
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| name | string | true | The unique name of the attribution configuration. | - |
| description | string | true | The description of the attribution configuration. | - |
| population | object | true | The unique ID of the population that identifies the longitudinal records used to process the attributions. | - |
| » id | string | true | The unique ID of the population. | - |
| algorithm | object | true | The algorithm that the provided configuration uses. | - |
| » id | string | true | The unique ID of the algorithm that is used by the configuration. | - |
| » version | string | true | The version of the algorithm used as part of the configuration. | - |
| » name | string | true | The name of the algorithm to use as part of the configuration. | - |
| » description | string | false | The description of the algorithm to use as part of the configuration. | - |
| » customSettings | [object] | false | The custom settings used by the algorithm during processing. These can have either configured values or metadata. | - |
| »» description | string | false | The description provided for the custom setting. | - |
| »» key | string | true | The unique key to identify the custom setting. | - |
| »» settingValueType | string | false | The type of the custom setting. | - |
| »» metadata | [object] | false | Metadata for the custom setting. | - |
| »»» dataSetType | string | true | The dataset type for the custom setting. | - |
| »»» referenceId | string | true | The reference ID used by the custom setting. | - |
| »» value | string | false | A single value for the custom setting. | - |
| »» values | [string] | false | The values used to initialize the custom setting. | - |
Algorithms
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| items | [AttributionPublicApi_Entities_V1_Algorithm_Algorithm] | true | An array containing the current page of results. | - |
| totalResults | integer(int32) | false | The total number of results for the specified parameters. | - |
| firstLink | string | true | The first page of results. | - |
| lastLink | string | false | The last page of results. | - |
| prevLink | string | false | The previous page of results. | - |
| nextLink | string | false | The next page of results. | - |
AttributionPublicApi_Entities_V1_Algorithm_Algorithm
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| id | string | true | The unique ID of the algorithm. | - |
| version | string | true | The version of the algorithm. | - |
| name | string | true | The name of the algorithm. | - |
| description | string | false | The description of the configuration. | - |
| availableSettings | [AttributionPublicApi_Entities_V1_Algorithm_AvailableSetting] | false | The available settings for the given algorithm. | - |
AttributionPublicApi_Entities_V1_Algorithm_AvailableSetting
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| name | string | true | The name given to the available setting. | - |
| required | boolean | true | A Boolean value to denote whether the setting value must be manually defined. | - |
| description | string | false | The description provided for the available setting. | - |
| default | string | false | The default values for the available setting in string format. A null value indicates that no default value is assigned. | - |
| processingConfiguration | [AttributionPublicApi_Entities_V1_Algorithm_ProcessingConfiguration] | true | Processing configuration details for the available setting. | - |
AttributionPublicApi_Entities_V1_Algorithm_ProcessingConfiguration
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| key | string | true | The key used to identify the custom setting. | - |
| settingValueType | string | false | The value type of the custom setting. | BENEFIT_PLANS_BY_SOURCE_ID, DATA_PARTITION_ID, DATA_PARTITION_IDS, ISO_8601_STRING, ISO_8601_STRINGS, NUMBER, NUMBERS, ORGANIZATION, ORGANIZATION_RECORDS, ORG_IDS_BY_ORG_CLASS, ORG_NAME_BY_ID, ORG_SERVICE_POSTAL_CODES_BY_ID, PERSONNEL_BY_ID, PERSONNEL_BY_ORG_ID, PERSONNEL_GROUP_BY_ID, PRSNL_ORG_COMMITMENT_BY_ORG_ID, STRING, STRINGS |
postPipelines
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| name | string | true | The name of the pipeline. | - |
| population | object | true | The unique population ID. | - |
| » id | string | true | The unique ID of the population. | - |
| state | string | true | state. | - |
| executionSettings | object | false | The execution setting values. | - |
| » frequencyValue | integer(int32) | true | The frequency value defining how often a coordinator will run. | - |
| » frequencyUnit | string | true | The frequency unit in which frequency occurs and the allowed values are minutes, hours, days, and months. | - |
| » timeOfDay | string | true | The time of day (HH:MM) in Coordinated Universal Time (UTC) when a coordinator instance job will run. | - |
| properties | [object] | false | Properties key and values. | - |
| » key | string | true | The pipeline properties key. | - |
| » value | string | true | The pipeline properties value. | - |
| job | object | false | The ID or version pair for adding arbitrary metadata. | - |
| » id | string | true | The unique ID of the job. | - |
| » version | integer(int32) | true | The version number of the job. | - |
AttributionPublicApi_Entities_V1_Pipeline_Pipeline
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| id | string | true | The unique ID of the pipeline. | - |
| version | integer(int32) | true | The version of the pipeline. | - |
| name | string | true | The name of the pipeline. | - |
| population | AttributionPublicApi_Entities_V1_PopulationReference | true | The unique ID of the population that identifies the longitudinal records used to process the attributions. | - |
| state | string | true | A value to denote the state of the pipeline. | ACTIVE, INACTIVE, ACTIVE_ADHOC |
| executionSettings | AttributionPublicApi_Entities_V1_Pipeline_PipelineExecutionSetting | true | The pipeline execution settings. | - |
| lastRunStatus | string | true | The status of the pipeline execution during the last run. | COMPLETED, FAILED |
| lastSuccessfulRun | string | true | The date and time that the last execution of the pipeline stopped its work. | - |
| properties | [AttributionPublicApi_Entities_V1_Pipeline_PipelinePropSetting] | false | The list of pipeline properties. | - |
| job | AttributionPublicApi_Entities_V1_Pipeline_PipelineJobSetting | true | The job properties which contain the job ID and version. | - |
| tags | [AttributionPublicApi_Entities_V1_Pipeline_PipelineTagSetting] | false | An optional list of tags for the pipeline. | - |
| createdAt | string | true | The date and time when the pipeline was initially entered in the system. This value is provided in International Organization for Standardization (ISO) 8601 formatting with precision to YYYY-MM-DDThh:mm:ss.SSSZ, such as 2018-02-13T20:41:18.181Z. The time is set automatically when the pipeline is first created. Therefore, the field does not need to be set explicitly. | - |
| updatedAt | string | true | The date and time when the pipeline was updated in the system. This value is provided in ISO 8601 formatting with precision to YYYY-MM-DDThh:mm:ss.SSSZ, such as 2018-02-13T20:41:18.181Z. The time is set automatically when the pipeline is updated. Therefore, the field does not need to be set explicitly. | - |
AttributionPublicApi_Entities_V1_Pipeline_PipelineExecutionSetting
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| frequencyValue | integer(int32) | true | The frequency value defining how often a coordinator will run. | - |
| frequencyUnit | string | true | The frequency unit in which frequency occurs and the allowed values are minutes, hours, days, and months. | - |
| timeOfDay | string | true | The time of day (HH:MM) in Coordinated Universal Time (UTC) when a coordinator instance job should run. | - |
AttributionPublicApi_Entities_V1_Pipeline_PipelinePropSetting
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| key | string | true | The key of the pipeline property setting. | - |
| value | string | true | The value of the pipeline property settings key. | - |
AttributionPublicApi_Entities_V1_Pipeline_PipelineJobSetting
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| id | string | true | The unique ID of the job. | - |
| version | integer(int32) | true | The version number of the job. | - |
AttributionPublicApi_Entities_V1_Pipeline_PipelineTagSetting
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| key | string | true | The key for the pipline tag settings. | - |
| value | string | false | The value of the pipeline tag key. | - |
Pipelines
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| items | [AttributionPublicApi_Entities_V1_Pipeline_Pipeline] | true | An array containing the current page of results. | - |
| totalResults | integer(int32) | false | The total number of results for the specified parameters. | - |
| firstLink | string | true | The first page of results. | - |
| lastLink | string | false | The last page of results. | - |
| prevLink | string | false | The previous page of results. | - |
| nextLink | string | false | The next page of results. | - |
putPipelines
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| name | string | true | The name of the pipeline. | - |
| population | object | true | The unique population ID. | - |
| » id | string | true | The unique ID of the population. | - |
| state | string | true | state. | - |
| executionSettings | object | false | The execution setting values. | - |
| » frequencyValue | integer(int32) | true | The frequency value defining how often a coordinator will run. | - |
| » frequencyUnit | string | true | The frequency unit in which frequency occurs and the allowed values are minutes, hours, days, and months. | - |
| » timeOfDay | string | true | The time of day (HH:MM) in Coordinated Universal Time (UTC) when a coordinator instance job will run. | - |
| properties | [object] | false | Properties key and values. | - |
| » key | string | true | The pipeline properties key. | - |
| » value | string | true | The pipeline properties value. | - |
| job | object | false | The ID or version pair for adding arbitrary metadata. | - |
| » id | string | true | The unique ID of the job. | - |
| » version | integer(int32) | true | The version number of the job. | - |
postTags
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| key | string | true | The tag key. | - |
| value | string | false | The tag key value. | - |
| resource | object | true | The resource attribute information of the tag. | - |
| » id | string | true | The unique pipeline ID or job ID. | - |
| » type | string | true | The resource type for the given resource ID example (“PIPELINE” or “JOB”). | - |
AttributionPublicApi_Entities_V1_Tag_Tag
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| id | string | true | The unique ID of the tag. | - |
| key | string | true | The key of the tag. | - |
| value | string | false | The value of the tag. | - |
| resource | AttributionPublicApi_Entities_V1_TagResource | true | The resource settings of the tag. | - |
AttributionPublicApi_Entities_V1_TagResource
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| id | string | true | The unique ID of the pipeline or job. | - |
| type | string | true | A string to denote the pipeline or job. | - |
Tags
| Name | Type | Required | Description | Accepted Values |
|---|---|---|---|---|
| items | [AttributionPublicApi_Entities_V1_Tag_Tag] | true | An array containing the current page of results. | - |
| totalResults | integer(int32) | false | The total number of results for the specified parameters. | - |
| firstLink | string | true | The first page of results. | - |
| lastLink | string | false | The last page of results. | - |
| prevLink | string | false | The previous page of results. | - |
| nextLink | string | false | The next page of results. | - |
