CoverMyMeds

Upload prior auth attachment

Upload prior auth attachment in CoverMyMeds

POSThttps://api.ontross.com/api/integrations/covermymeds/upload-prior-auth-attachment

Upload a file

Send multipart/form-data with auth_id, input serialized as JSON text, and exactly one original file in files. Let your HTTP client set the Content-Type boundary. In Try it, select a connection, fill in the input fields and choose the file.

The file must be non-empty and no larger than 50 MiB. Use the provider’s input fields below to select the patient and document destination.

Request Fields

auth_id

string

required

Saved connection to run this operation through, from the Authentication page. It decides which practice and login the call uses.

input.request_key

string

required

The provider-issued identifier for the prior authorization request.

Example

"TEST7K2M"

input.expected_lock_version

integer

required

The revision from the most recent authorization response.

Example

4

input.idempotency_key

string

required

A caller-generated UUID reused when retrying the same operation.

Example

"3f2504e0-4f89-11d3-9a0c-0305e82c3301"

input.attachment_name

string

required

A caller-supplied display label for the supporting document.

Example

"Clinical notes"

input.file_name

string

required

The uploaded document's filename, including its extension.

Example

"clinical_notes.pdf"

input.sha256

string

required

The file's SHA-256 digest encoded as lowercase hexadecimal.

Example

"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad"

files

file

required

Exactly one original document file; send its bytes, not a path or base64 string.

Output Fields

request_key

string

The provider-issued identifier for the prior authorization request.

Example

"TEST7K2M"

attachment_id

string

The provider-issued identifier of the affected document.

Example

"att_7c9e2b4f8a1d"

lock_version

integer

The resulting revision to use for subsequent changes.

Example

6

replayed

boolean

Whether this response repeats a previously completed operation.

Example

false

Code

curl 'https://api.ontross.com/api/integrations/covermymeds/upload-prior-auth-attachment' \
  -H 'X-API-Key: YOUR_API_KEY' \
  --form-string 'auth_id=YOUR_AUTH_ID' \
  --form-string 'input={"request_key":"TEST7K2M","expected_lock_version":4,"idempotency_key":"3f2504e0-4f89-11d3-9a0c-0305e82c3301","attachment_name":"Clinical notes","file_name":"clinical_notes.pdf","sha256":"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad"}' \
  -F 'files=@document.pdf;type=application/pdf'

input form field (JSON)

{
  "request_key": "TEST7K2M",
  "expected_lock_version": 4,
  "idempotency_key": "3f2504e0-4f89-11d3-9a0c-0305e82c3301",
  "attachment_name": "Clinical notes",
  "file_name": "clinical_notes.pdf",
  "sha256": "ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad"
}

Response BODY

{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "request_key": "TEST7K2M",
    "attachment_id": "att_7c9e2b4f8a1d",
    "lock_version": 6,
    "replayed": false
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}