Skip to navigation

Reply to a clarification request

The account holder’s reply to the review’s question. Only accepted in info_requested; otherwise 409 med_not_writable. Attachments that explain the message go through evidence/add with the returned messageId. Close the package with POST .../submit.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired
Account identifier.
idstringRequired

The medId.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
Idempotency-KeystringOptional

Optional client-generated idempotency token (recommended for safe retries).

X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

Request

This endpoint expects an object.
bodystringRequired<=2000 characters
The account holder's reply, free text.

Response

Message recorded.
medIdstring
messageIdstring
authorKindenum
Allowed values:
bodystring
createdAtdatetime

Errors

400
Bad Request Error
404
Not Found Error
409
Conflict Error
422
Unprocessable Entity Error
500
Internal Server Error