Create a provenance
post
/Provenance
Creates a new provenance.
Note:
- Only the body fields mentioned below are supported. Unsupported fields are ignored or can result in errors.
- The
Provenance.write
scope must be provided to create a provenance with an observation measurement target.
Authorization Types
This operation supports the following authorization types:
Request
Supported Media Types
- application/fhir+json
Header Parameters
-
Authorization(required): string
Contains the credentials to authenticate a consumer to the service. This should be the OAuth2 Bearer token.
-
accept(required): string
The media type to be requested. See what the resource's operation produces for what is supported.
-
content-type(required): string
Specifies the content type of the request entity body.
The body of the create operation
Root Schema : ProvenanceCreate
Type:
object
A summary representation of the create (POST) operation for a provenance.
Show Source
-
agent(required):
array agent
An actor with a role in an activity who can be assigned some degree of responsibility for the activity.
Note: Provide at least one agent.
Example:{ "agent": [ { "type": { "coding": [ { "system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-provenance-participant-type", "code": "transmitter" } ] }, "role": [ { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes", "code": "SOURCE" } ] } ], "who": { "reference": "Organization/619848" } } ] }
-
entity:
array entity
An entity used in this activity.
Example:{ "entity": [ { "role": "source", "what": { "reference": "DocumentReference/S-201" } } ] }
-
recorded(required):
string
The time at which the activity was recorded.
Example:{ "recorded": "2019-10-25T14:57:43Z" }
-
resourceType(required):
string
Allowed Values:
[ "Provenance" ]
The type of the FHIR resource. -
target(required):
object target
The references that were generated or updated by the activity described in this resource.
Note:- Only one target may be provided.
- The following resources are supported:
- AllergyIntolerance
- CarePlan
- CareTeam
- Condition
- DiagnosticReport
- DocumentReference
- Encounter
- Goal
- Immunization
- MedicationRequest
- Observation
- Patient
- Procedure
{ "target": [ { "reference": "DocumentReference/881049" } ] }
Nested Schema : agent
Type:
array
An actor with a role in an activity who can be assigned some degree of responsibility for the activity.
Note: Provide at least one agent.
Example:
Show Source
Note: Provide at least one agent.
Example:
{
"agent": [
{
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-provenance-participant-type",
"code": "transmitter"
}
]
},
"role": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
"code": "SOURCE"
}
]
}
],
"who": {
"reference": "Organization/619848"
}
}
]
}
Nested Schema : entity
Type:
array
An entity used in this activity.
Example:
Show Source
Example:
{
"entity": [
{
"role": "source",
"what": {
"reference": "DocumentReference/S-201"
}
}
]
}
Nested Schema : target
Type:
object
The references that were generated or updated by the activity described in this resource.
Note:
Show Source
Note:
- Only one target may be provided.
- The following resources are supported:
- AllergyIntolerance
- CarePlan
- CareTeam
- Condition
- DiagnosticReport
- DocumentReference
- Encounter
- Goal
- Immunization
- MedicationRequest
- Observation
- Patient
- Procedure
{
"target": [
{
"reference": "DocumentReference/881049"
}
]
}
Nested Schema : items
Type:
Show Source
object
-
agent.role:
object agent.role
The function of the agent with respect to the activity.
Example:{ "role": [ { "coding": [ { "system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes", "code": "SOURCE" } ] } ] }
-
agent.type:
object agent.type
The participation the agent had with respect to the activity.
Example:{ "type": { "coding": [ { "system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-provenance-participant-type", "code": "transmitter" } ] } }
-
agent.who:
object agent.who
The individual, device, or organization that participated in the event.
Example:{ "who": { "reference": "Organization/619848" } }
Nested Schema : agent.role
Type:
object
The function of the agent with respect to the activity.
Example:
Show Source
Example:
{
"role": [
{
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/contractsignertypecodes",
"code": "SOURCE"
}
]
}
]
}
Nested Schema : agent.type
Type:
object
The participation the agent had with respect to the activity.
Example:
Show Source
Example:
{
"type": {
"coding": [
{
"system": "http://hl7.org/fhir/us/core/CodeSystem/us-core-provenance-participant-type",
"code": "transmitter"
}
]
}
}
Nested Schema : agent.who
Type:
object
The individual, device, or organization that participated in the event.
Example:
Show Source
Example:
{
"who": {
"reference": "Organization/619848"
}
}
Nested Schema : items
Type:
Show Source
object
-
entity.role:
string
How the entity was used during the activity.
Example:{ "role": "source" }
-
entity.what:
object entity.what
The identity of the entity used.
Example:{ "what": { "reference": "DocumentReference/S-201" } }
Nested Schema : entity.what
Type:
object
The identity of the entity used.
Example:
Show Source
Example:
{
"what": {
"reference": "DocumentReference/S-201"
}
}
Response
Supported Media Types
- application/fhir+json
Default Response
Example Request:
POST https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance
Example Request Body:
{
'resourceType': 'Provenance',
'target': [
{
'reference': 'DocumentReference/881049'
}
],
'recorded': '2019-10-25T14:57:43Z',
'agent': [
{
'type': {
'coding': [
{
'system': 'http://hl7.org/fhir/us/core/CodeSystem/us-core-provenance-participant-type',
'code': 'transmitter'
}
]
},
'role': [
{
'coding': [
{
'system': 'http://terminology.hl7.org/CodeSystem/contractsignertypecodes',
'code': 'SOURCE'
}
]
}
],
'who': {
'reference': 'Organization/619848'
}
}
],
'entity': [
{
'role': 'source',
'what': {
'reference': 'DocumentReference/S-201'
}
}
]
}
Example Response:
Cache-Control: no-cache
Content-Length: 0
Content-Type: text/html
Date: Tue, 31 Mar 2020 15:37:25 GMT
Etag: W/"881057"
Location: https://fhir-open.cerner.com/r4/ec2458f2-1e24-41c8-b71b-0e701af7583d/Provenance/doc-881057
Last-Modified: Tue, 31 Mar 2020 15:37:25 GMT
Vary: Origin
opc-request-id: /11111111111111111111111111111111/11111111111111111111111111111111
X-Request-Id: 11111111-1111-1111-1111-111111111111
The ETag
response header indicates the current If-Match
version to use on a subsequent update.
Headers
-
Etag: string
For Update or Patch versioning controls. Related to
If-Match
. When a resource performs an operation that creates or updates a record, anEtag
value is returned as a header. This same value should be included in request headers as anIf-Match
for any subsequent update to that record. -
X-Request-Id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
X-Request-Id
, if present. -
opc-request-id: string
Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a particular request, provide the
opc-Request-Id
, if present.