document.feedbackSubmitted - Corti API Documentation

Event Properties

Field	Value
`event`	`"document.feedbackSubmitted"`
`confidential`	`boolean`
`payload`	`object`

Public Payload
Confidential Payload

Field	Type	Description
`score`	`number`	User rating for the document
`maxScore`	`number`	Max possible rating for the document
`documentId`	`string`	Unique document identifier
`documentType`	`"legacy" \| "guided"`	Document generation type
`documentName`	`string`	Document name or title
`outputLanguage`	`string`	Output language code (e.g., “en”, “de”)
`templateType`	`"built-in" \| "custom" \| "schema-driven"`	Type of template used: built-in, custom, or schema-driven
`templateId`	`string`	Template identifier (either ref for built-in or customTemplateId for custom)
`interactionId`	`string`	Unique interaction identifier
`interactionState`	`InteractionState`	Current state of the interaction

Example

{
  "event": "document.feedbackSubmitted",
  "confidential": false,
  "payload": {
    "score": 4,
    "maxScore": 5,
    "documentId": "doc_123",
    "documentType": "legacy",
    "documentName": "SOAP note",
    "outputLanguage": "en",
    "templateType": "built-in",
    "templateId": "soap",
    "interactionId": "int_123",
    "interactionState": "ongoing"
  }
}

Field	Type	Description
`score`	`number`	User rating for the document
`maxScore`	`number`	Max possible rating for the document
`document`	`ExternalPatientDocument`	Complete document object with all sections and metadata
`interaction`	`ExternalInteraction`	Interaction context including transcripts, documents, and facts

document object properties

Field	Type	Description
`id`	`string`	Unique document identifier
`documentType`	`"legacy" \| "guided"`	Document generation type
`name`	`string`	Document name or title
`outputLanguage`	`string`	Output language code (e.g., “en”, “de”)
`sections`	`Section[]`	Document sections containing the generated content
`templateType`	`"built-in" \| "custom" \| "schema-driven"`	Type of template used: built-in, custom, or schema-driven
`templateId`	`string`	Template identifier (either ref for built-in or customTemplateId for custom)

Section properties:

Field	Type	Description
`key`	`string`	Unique key identifying the section type
`name`	`string`	Display name of the section
`text`	`string`	Section content in markdown or plain text
`structuredOutput`	`unknown`	Structured output for guided documents, null for legacy documents

interaction object properties

Field	Type	Description
`id`	`string`	Unique interaction identifier
`title`	`string \| null`	Interaction title
`state`	`InteractionState`	Current state of the interaction
`startedAt`	`string (ISO 8601 date)`	When the interaction started (ISO 8601 date string)
`transcriptCount`	`number`	Number of transcripts in the interaction
`documentCount`	`number`	Number of documents in the interaction
`facts`	`Fact[]`	Facts extracted during the interaction

Fact properties:

Field	Type	Description
`id`	`string`	Unique fact identifier
`text`	`string`	Fact text content
`group`	`string`	Fact group/category name
`source`	`"core" \| "system" \| "user"`	Source of the fact: core (AI extracted), system, or user
`isDiscarded`	`boolean`	Whether the fact has been discarded

Example

{
  "event": "document.feedbackSubmitted",
  "confidential": true,
  "payload": {
    "score": 4,
    "maxScore": 5,
    "document": {
      "id": "doc_123",
      "documentType": "legacy",
      "name": "SOAP note",
      "outputLanguage": "en",
      "sections": [
        {
          "key": "hpi",
          "name": "HPI",
          "text": "...",
          "structuredOutput": null
        }
      ],
      "templateType": "built-in",
      "templateId": "soap"
    },
    "interaction": {
      "id": "int_123",
      "title": "Visit",
      "state": "ongoing",
      "startedAt": "2024-01-01T00:00:00.000+00:00",
      "transcriptCount": 0,
      "documentCount": 0,
      "facts": []
    }
  }
}

​Event Properties

​Example

​Example

Event Properties

Example

Example