Dictation Scope Guard

List all approved dictation scopes (route + field combinations)

{
  "data": [
    {
      "scope_id": "scope-a1b2c3",
      "route_id": "route-visit-form",
      "field_ids": [
        "field_visit_notes",
        "field_observations"
      ],
      "registered_at": "2026-03-01T08:00:00Z"
    },
    {
      "scope_id": "scope-d4e5f6",
      "route_id": "route-activity-log",
      "field_ids": [
        "field_activity_description"
      ],
      "registered_at": "2026-03-10T09:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 2
  }
}

Get a specific approved dictation scope by scope ID

{
  "scope_id": "scope-a1b2c3",
  "route_id": "route-visit-form",
  "field_ids": [
    "field_visit_notes",
    "field_observations"
  ],
  "registered_at": "2026-03-01T08:00:00Z"
}

Register an approved dictation context (route + allowed field IDs)

{
  "route_id": "route-patient-intake",
  "field_ids": [
    "field_chief_complaint",
    "field_history"
  ]
}

{
  "scope_id": "scope-g7h8i9",
  "route_id": "route-patient-intake",
  "field_ids": [
    "field_chief_complaint",
    "field_history"
  ],
  "registered_at": "2026-03-26T11:10:00Z"
}

Update the allowed field list for an existing approved scope

{
  "field_ids": [
    "field_chief_complaint",
    "field_history",
    "field_medications"
  ]
}

{
  "scope_id": "scope-g7h8i9",
  "route_id": "route-patient-intake",
  "field_ids": [
    "field_chief_complaint",
    "field_history",
    "field_medications"
  ],
  "updated_at": "2026-03-26T11:15:00Z"
}

Revoke an approved dictation scope, blocking dictation on that route

{
  "scope_id": "scope-g7h8i9",
  "revoked": true
}

Check whether dictation is allowed for a given field context, returning prohibition reason if blocked

{
  "route_id": "route-read-only-summary",
  "field_id": "field_summary_text"
}

{
  "allowed": false,
  "prohibition_reason": "Field 'field_summary_text' is not in the approved list for route 'route-read-only-summary'."
}

{
  "contract_summary": {
    "total_contracts": 410,
    "total_endpoints": 2416,
    "api_styles_used": [
      "rest"
    ]
  },
  "generated_at": "2026-03-26T06:55:53.316Z"
}