Tross
ATHENA

Update document

Update document in Athena

POSThttps://api.ontross.com/api/integrations/athena/update-document
Request Fields
input.org_id
integer
required
Org id
Example
1
input.patient_id
integer
required
Patient id
Example
1
input.document_id
string
required
Document id
Example
"12345"
input.expected_version
string
required
Expected version
Example
"string"
input.edit_context_token
string
required
Edit context token
Example
"string"
input.changes
object
required
Changes object.
input.changes.department_id
string
Department id
Example
"12345"
input.changes.provider_username
string
Provider username
Example
"string"
input.changes.label_id
string
Label id
Example
"12345"
input.changes.document_date
string
Document date
Example
"2026-01-01"
input.department_id
integer
required
Runtime Athena context department; distinct from the portal route number.
Example
1
auth_id
string
required
Saved connection to run this operation through, from the Authentication page. It decides which practice and login the call uses.
Example
"00000000-0000-4000-8000-000000000000"
Output Fields
outcome
string
Outcome
document
object
Output object.
document.document_id
string
Source identifiers remain strings.
document.patient_id
string
Source identifiers remain strings.
document.chart_id
string
Source identifiers remain strings.
document.department_id
string
Source identifiers remain strings.
document.document_class
string
Document class
document.label_id
string
Source identifiers remain strings.
document.label_name
string
Label name
document.provider_username
string
Provider username
document.source_status
string
Source status
document.actual_assignee_username
string
Actual assignee username
document.document_date
string
Document date
document.pin_action_note_to_top
boolean
Pin action note to top
document.version_token
string
Version token
document.action_note_id
string
Action note id
document.edit_context_token
string
Edit context token
document.allowed_actions
array
List of allowed actions.
document.action_context_expires_at
string
Action context expires at
document.pin_semantics
string
Pin semantics
document.chart_top_visibility_verified
boolean
Chart top visibility verified
action_note_id
string
Action note id
metadata_verified
boolean
Metadata verified
warnings
array
List of warnings.
Code
curl --request POST \
  --url https://api.ontross.com/api/integrations/athena/update-document \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"org_id":1,"patient_id":1,"document_id":"12345","expected_version":"string","edit_context_token":"string","changes":{"department_id":"12345","provider_username":"string","label_id":"12345","document_date":"2026-01-01"},"department_id":1},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "org_id": 1,
    "patient_id": 1,
    "document_id": "12345",
    "expected_version": "string",
    "edit_context_token": "string",
    "changes": {
      "department_id": "12345",
      "provider_username": "string",
      "label_id": "12345",
      "document_date": "2026-01-01"
    },
    "department_id": 1
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "outcome": "updated",
    "document": {
      "document_id": "string",
      "patient_id": "string",
      "chart_id": "string",
      "department_id": "string",
      "document_class": "string",
      "label_id": "string",
      "label_name": "string",
      "provider_username": "string",
      "source_status": "string",
      "actual_assignee_username": "string",
      "document_date": "2019-08-24",
      "pin_action_note_to_top": true,
      "version_token": "string",
      "action_note_id": "string",
      "edit_context_token": "string",
      "allowed_actions": [
        "string"
      ],
      "action_context_expires_at": "2019-08-24T14:15:22Z",
      "pin_semantics": "action_note",
      "chart_top_visibility_verified": true
    },
    "action_note_id": "string",
    "metadata_verified": true,
    "warnings": [
      "string"
    ]
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}