EHRbase Item Tag Experimental API (v1)
Download OpenAPI specification:Download
Experimental API for working with Item Tags
Get tags
Returns all tags for or filters based on the given ids and/or keys.
path Parameters
| ehr_id required | string($uuid) Identifier of owner object, such as EHR. |
| versioned_object_uid required | string($uuid|$version) Identifier of target, which may be a VERSIONED_OBJECT |
query Parameters
| ids | string($uuid) Filter for tag Identifier. |
| keys | string($key) Filter for tag keys. |
header Parameters
| openEHR-VERSION | string |
| openEHR-AUDIT_DETAILS | string |
Responses
Response samples
- 200
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "target": "65a17d54-9c67-4477-8b80-d3f97e165aa5",
- "key": "string",
- "value": "string",
- "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
- "target_type": "EHR_STATUS",
- "target_path": "string"
}
]Create or Update tags
Bulk creation/update of tags. Tags without IDs are created, those with IDs are updated.
path Parameters
| ehr_id required | string($uuid) Identifier of owner object, such as EHR. |
| versioned_object_uid required | string($uuid|$version) Identifier of target, which may be a VERSIONED_OBJECT |
header Parameters
| openEHR-VERSION | string |
| openEHR-AUDIT_DETAILS | string |
| Prefer | string($prefer) Enum: "return=minimal" "return=representation" Preferred response type. |
Request Body schema: application/jsonrequired
| id | string <uuid> |
| target | string <uuid> |
| key | string |
| value | string |
| owner_id | string <uuid> |
| target_type | string Enum: "EHR_STATUS" "COMPOSITION" |
| target_path | string |
Responses
Request samples
- Payload
[- {
- "key": "tag::1",
- "value": "some textual value",
- "target_path": "/context/end_time[at0001]|value"
}
]Response samples
- 200
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "target": "65a17d54-9c67-4477-8b80-d3f97e165aa5",
- "key": "string",
- "value": "string",
- "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
- "target_type": "EHR_STATUS",
- "target_path": "string"
}
]Deletes tags
Deletes all tags for matching the given uuid or ItemTag.id.
path Parameters
| ehr_id required | string($uuid) Identifier of owner object, such as EHR. |
| versioned_object_uid required | string($uuid|$version) Identifier of target, which may be a VERSIONED_OBJECT |
header Parameters
| openEHR-VERSION | string |
| openEHR-AUDIT_DETAILS | string |
Request Body schema: application/jsonrequired
List of ItemTag string($uuid) or entries to delete
Responses
Request samples
- Payload
"string"Get tags
Returns all tags for or filters based on the given ids and/or keys.
path Parameters
| ehr_id required | string($uuid) Identifier of owner object, such as EHR. |
| versioned_object_uid required | string($uuid|$version) Identifier of target, which may be a VERSIONED_OBJECT |
query Parameters
| ids | string($uuid) Filter for tag Identifier. |
| keys | string($key) Filter for tag keys. |
header Parameters
| openEHR-VERSION | string |
| openEHR-AUDIT_DETAILS | string |
Responses
Response samples
- 200
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "target": "65a17d54-9c67-4477-8b80-d3f97e165aa5",
- "key": "string",
- "value": "string",
- "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
- "target_type": "EHR_STATUS",
- "target_path": "string"
}
]Create or Update tags
Bulk creation/update of tags. Tags without IDs are created, those with IDs are updated.
path Parameters
| ehr_id required | string($uuid) Identifier of owner object, such as EHR. |
| versioned_object_uid required | string($uuid|$version) Identifier of target, which may be a VERSIONED_OBJECT |
header Parameters
| openEHR-VERSION | string |
| openEHR-AUDIT_DETAILS | string |
| Prefer | string($prefer) Enum: "return=minimal" "return=representation" Preferred response type. |
Request Body schema: application/jsonrequired
| id | string <uuid> |
| target | string <uuid> |
| key | string |
| value | string |
| owner_id | string <uuid> |
| target_type | string Enum: "EHR_STATUS" "COMPOSITION" |
| target_path | string |
Responses
Request samples
- Payload
[- {
- "key": "tag::1",
- "value": "some textual value",
- "target_path": "/context/end_time[at0001]|value"
}
]Response samples
- 200
[- {
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "target": "65a17d54-9c67-4477-8b80-d3f97e165aa5",
- "key": "string",
- "value": "string",
- "owner_id": "8826ee2e-7933-4665-aef2-2393f84a0d05",
- "target_type": "EHR_STATUS",
- "target_path": "string"
}
]Deletes tags
Deletes all tags for matching the given uuid or ItemTag.id.
path Parameters
| ehr_id required | string($uuid) Identifier of owner object, such as EHR. |
| versioned_object_uid required | string($uuid|$version) Identifier of target, which may be a VERSIONED_OBJECT |
header Parameters
| openEHR-VERSION | string |
| openEHR-AUDIT_DETAILS | string |
Request Body schema: application/jsonrequired
List of ItemTag string($uuid) or entries to delete
Responses
Request samples
- Payload
"string"