Skip to documentation
athenahealth integration

Resolve Patient Chart Context

Resolve a known athenahealth patient ID to chart and department context for provider workflows across specialties. Requires an organization-configured athenahealth connection. patient_id is the vendor ID, not the local GenHealth patient UUID. An omitted department_id uses the connection's default department. Check success before using chart_id in insurance reads or Patient Case writeback. This action does not create a Patient Case or write a note. Missing input or connection failure returns an error; route the node's error output with fail_branch for explicit review.

View as Markdown
athena_resolve_patient_chart_context
readathenahealth

Use in a workflow

Copy the discovered node config and fill its params from the input contract. Validate the complete graph before publishing. Integration results use {{node_id.default.field}}. Check business success before dependent writes; completion alone does not prove success.

{
  "_group": "athenahealth",
  "params": {},
  "handler": "athena_resolve_patient_chart_context"
}

Action contracts and connections · Run recovery

Inputs

  • patient_id
    expressionrequired
    Patient Id

    Required athenahealth patient ID from a verified patient match. Do not pass a local GenHealth patient UUID.

  • department_id
    expression
    Department Id

    Optional athenahealth department ID. Omit to use the configured connection's default department.

Outputs

  • successSuccess
  • patient_idPatient Id
  • chart_idChart Id
  • department_idDepartment Id
  • athenaAthena
  • errorError
  • error_messageError Message

Output schema completeness: reviewed_partial

Safety

External effect
read
Confirmation recommended
No
Retry safe
Yes
Dry run supported
No

Schemas

These schemas are first-pass authoring guidance. Runtime validation remains authoritative.

Input schema
{
  "type": "object",
  "required": [
    "patient_id"
  ],
  "properties": {
    "patient_id": {
      "description": "Required athenahealth patient ID from a verified patient match. Do not pass a local GenHealth patient UUID.",
      "x-workflow-field-type": "expression"
    },
    "department_id": {
      "description": "Optional athenahealth department ID. Omit to use the configured connection's default department.",
      "x-workflow-field-type": "expression"
    }
  },
  "additionalProperties": false
}
Output schema
{
  "type": "object",
  "properties": {
    "error": {},
    "athena": {},
    "success": {
      "type": "boolean"
    },
    "chart_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "patient_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "department_id": {
      "type": [
        "string",
        "null"
      ]
    },
    "error_message": {}
  },
  "additionalProperties": true
}
View all athenahealth actions