Skip to main content
PATCH
Update Prior Auth By Id
Append evidence to an existing PA, complete outreach, or do both in one request. Use the PA ID returned at creation.

Append evidence

New evidence is added to the PA and triggers re-answering using all accepted evidence. Existing evidence is retained. Send a non-empty evidence array using the clinical evidence formats.
Or use asset.file_content with Base64-encoded file bytes instead of file_url. An evidence upload alone keeps outreach open until explicit completion or the organization’s configured deadline.

Complete outreach

For a PA with current external outreach, send:
Send only status inside provider_outreach; no outreach ID is accepted. You can include this object alongside evidence in the same PATCH. Status-only completion can be repeated while the PA remains eligible for updates. The PATCH cannot start outreach or change the organization’s method or deadline. See provider outreach setup for the creation and platform review flows.

Response handling

A 200 response contains the updated PA in the same format as GET /prior-authorization/{id}. Evidence processing is asynchronous: acceptance does not mean updated answers are ready. Track data.status through GET or PA status-change webhooks. Evidence processing can return processing. If outreach is still active, the PA returns to awaiting_provider_response. Completion or deadline exhaustion returns it to awaiting_review after accepted evidence finishes processing. For external outreach, data.provider_outreach reports the current outreach status and deadline.

API errors

Updates are available before submission while awaiting review or processing provider information. This endpoint cannot replace an active DH-managed outreach flow or update a submitted or terminal PA. See Response handling for common authentication and validation errors.

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

Body

application/json

Base model for all API request or response models.

evidence
EvidenceItem · object[]

Evidence to append to this PA. Accepted uploads trigger re-answering; updated answers are not ready immediately.

Minimum array length: 1
provider_outreach
Provider Outreach · object

Complete this PA's current external outreach, alone or with evidence. This endpoint cannot start outreach.

Response

The prior authorization after the accepted update. Evidence processing is asynchronous; acceptance does not mean updated answers are ready.

Represents the response structure for a GET /prior-authorization/:id request.

This class extends the generic ApiResponse, specifically tailored to handle responses related to prior authorizations. It primarily includes the data attribute, which holds detailed information about the benefit verification process and its results.

status
default:success
Available options:
success
error
ApiError · object
data
Data · object

Contains the data from your prior authorization request, or None if an error occurred.