Regenerate the note

Writes the visit’s note again from its transcript, optionally with another template — the app’s regenerate. The visit goes back to processing; poll GET /visits/. Scope visits:write.

POST /visits/{id}/regenerate

Regenerate the note

cURL

curl --request POST \
  --url https://rxnote.ai/api/v1/visits/{id}/regenerate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "template_id": 123,
  "clinician_email": "[e-mail]"
}
'

200

{
  "id": 90211,
  "patient_id": 123,
  "status": "recording",
  "language": "<string>",
  "template_id": 123,
  "outputs": [
    "transcript"
  ],
  "created_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "icd_codes": {
    "code_version": "icd11",
    "generated_at": "<string>",
    "codes": [
      {
        "code": "CA02",
        "name": "Acute pharyngitis",
        "confidence": "high"
      }
    ]
  },
  "error": {
    "code": "TRANSCRIPTION_FAILED",
    "message": "<string>"
  },
  "upload": {
    "url": "<string>",
    "method": "PUT",
    "headers": {
      "Content-Type": "audio/webm"
    },
    "expires_at": "2023-11-07T05:31:56Z"
  },
  "transcript": {
    "text": "<string>",
    "duration_seconds": 123,
    "segments": [
      {
        "speaker": 123,
        "start_ms": 123,
        "end_ms": 123,
        "text": "<string>"
      }
    ]
  },
  "note": {
    "template": {
      "id": 123,
      "name": "<string>"
    },
    "framework": "soap",
    "sections": [
      {
        "id": "<string>",
        "title": "<string>",
        "fields": [
          {
            "id": "<string>",
            "label": "<string>",
            "text": "<string>"
          }
        ]
      }
    ],
    "html": "<string>"
  },
  "summary": {}
}

Authorizations

Authorization · string · header · required

Your API key, created in RxNote under Settings → API: Authorization: Bearer rxn_live_….

Path Parameters

id · integer · required

Example:

90211

Body

application/json

template_id · integer

Rewrite the note with this template. Omitted: the visit's current template.

clinician_email · string<email>

Required with an organization key: the RxNote member acting. With a personal key, omit it or send the owner's own email.

Maximum string length: 255

Example:

"[e-mail]"

Response

200

application/json

The visit, now processing.

id · integer · required

Example:

90211

patient_id · integer · required

status · enum<string> · required

Available options: recording, pending, processing, transcribing, generating-soap, completed, failed, no-speech

language · string · required

template_id · integer | null · required

outputs · enum<string>[] · required

Available options: transcript, note, summary

created_at · string<date-time> · required

completed_at · string<date-time> | null · required

icd_codes · object | null · required

Set once POST /visits/{id}/icd-codes has run.

Show child attributes

error · object | null · required

Show child attributes

upload · object

Only while the status is recording (waiting for the audio).

Show child attributes

transcript · object | null

Omitted unless requested; null until ready.

Show child attributes

note · object | null

Omitted unless requested; null until ready.

Show child attributes

summary · object | null

Omitted unless requested; null until ready.

Show child attributes