Mark Output Completed

Mark a specific output (letter) as acknowledged/completed. This sets the output’s read status so it no longer appears in the unread feed.

All endpoints require authentication. For credentials and access, contact the medWrite team.

Request

PATCH {{baseUrl}}/api/v1/third-parites/letters/{Output ID}/acknowledge/

Headers

Header	Type	Required	Description
Bearer Token	string	Yes	Authentication token. Contact medWrite team.
API Key	string	Yes	Service API key. Contact medWrite team.

Path parameters

Parameter	Type	Required	Description
Output ID	string	Yes	The unique identifier of the output.

Response

Status: 200 OK

{
  "data": {
    "id": "...",
    "ehr_read": true,
    "ehr_read_date": "2025-01-15T14:30:00.000000",
    "...": "..."
  },
  "message": "letter acknowledged successfully",
  "status": "success"
}

If the letter was already acknowledged, the response returns "message": "letter already acknowledged" with the existing read date.

Error responses

Status	Condition
`400`	Missing Output ID
`401`	Invalid or missing authentication
`404`	Letter not found

Authentication

Get Records

HL7 Receiver

Mark Output Completed

Request

Headers

Path parameters

Response

Error responses

Next steps

Get Approved Outputs

Get PDF Document

​Request

​Headers

​Path parameters

​Response

​Error responses

​Next steps

Get Approved Outputs

Get PDF Document

Request

Headers

Path parameters

Response

Error responses

Next steps