Tross
Demo dataBook a demo
DENTRIX-ASCEND

Upload document

Upload one untagged PDF and verify it appears on the patient chart.

POSThttps://preview.ontross.com/api/integrations/dentrix-ascend/upload-document

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.patient_id
string
required
Patient chart identifier.
Example
"900001"
input.document_date
string
required
Document date in YYYY-MM-DD format.
Example
"2026-10-16"
files
file
required
Exactly one original document file; send its bytes, not a path or base64 string.
Output Fields
document
object
Item object.
document.id
string
Id
document.name
string
Name
document.byte_size
integer
Byte size
document.document_date
string
Document date in YYYY-MM-DD format.
Example
"2026-10-16"
document.type
string
Type
document.created_at
string
Creation time as an ISO 8601 UTC string.
Example
"2026-10-16T10:30:00+00:00"
document.mime_type
string
Mime type
document.status
string
Status
document.pdf_page_count
integer
Pdf page count
document.tags
array
Provider tag metadata; the verified upload is untagged.
verified
boolean
True only after the uploaded document appears in this patient's document list.
Code
curl 'https://preview.ontross.com/api/integrations/dentrix-ascend/upload-document' \
  -H 'X-API-Key: YOUR_API_KEY' \
  --form-string 'auth_id=YOUR_AUTH_ID' \
  --form-string 'input={"patient_id":"900001","document_date":"2026-10-16"}' \
  -F 'files=@document.pdf;type=application/pdf'
input form field (JSON)
{
  "patient_id": "900001",
  "document_date": "2026-10-16"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "document": {
      "id": "string",
      "name": "string",
      "byte_size": 0,
      "document_date": "2026-10-16",
      "type": "string",
      "created_at": "2026-10-16T10:30:00+00:00",
      "mime_type": "string",
      "status": "string",
      "pdf_page_count": 0,
      "tags": [
        null
      ]
    },
    "verified": true
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}