operator-alerts

Admin: create an alert for an expert

Changed on

Opens one alert of an admin-creatable type. The body carries ids only: the server checks they fit the type, resolves the metadata the expert's close needs and composes title and description. Admin only.

post/api/operator-alerts/admin

Request

  • Base URL: https://api.corabea.it (the document declares no server; this is the origin it was published from)
  • URL: https://api.corabea.it/api/operator-alerts/admin
  • Auth: HTTP bearer

Request body

operator_idstring uuid required

Expert the alert is for

type'modifica_stato_appuntamento' | 'conferma_stato_appuntamento' | 'conferma_stato_grave_paziente' | 'aggiungi_nota_stato_paziente' | 'frequenza_non_rispettata' | 'abbandono_parziale' | 'aggiungi_disponibilita' | 'aggiungi_fasce_orarie' | 'invia_fattura_mensile' | 'correggi_fattura' | 'conferma_riassegnazione_paziente' | 'report_multidisciplinari' | 'conferma_rientro_sostituzione' | 'carica_materiale_cassetta' | 'carica_video_presentazione' | 'sostituisci_video_presentazione' | 'richiesta_cambio_stato_paziente' | 'conferma_partecipazione_mini_equipe' | 'compila_verbale_mini_equipe' | 'compila_report_supervisione' | 'gestisci_andamento_supervisionato' required

Operator alert type constants.

patient_idstring uuid nullable

Patient the alert is about (every type but the return one)

appointment_idstring uuid nullable

DA_RIPROGRAMMARE appointment (conferma_stato_appuntamento)

requested_statusstring nullable

Manual status the expert must set (richiesta_cambio_stato_paziente)

status_note_idstring uuid nullable

The expert's status note on the patient they must rewrite (aggiungi_nota_stato_paziente)

messagestring nullable

Optional note from the admin, appended to the description

is_blockingboolean nullable

Force whether this alert can block portal access; defaults from type when omitted

blocking_starts_atstring date-time nullable

When the alert should start blocking, in place of the default grace period. Stored as whole hours from creation, rounded up: it blocks at most an hour later, never earlier; a moment already past blocks at once

Response

Successful Response

idstring uuid nullable

Alert UUID

operator_idstring uuid nullable

Operator UUID

operator_namestring nullable

The expert's full name; filled on the paged feed only.

created_atstring date-time nullable

Creation timestamp

updated_atstring date-time nullable

Last update timestamp

statusstring nullable

Alert status

typestring nullable

Alert type

titlestring nullable

Alert title

descriptionstring nullable

Alert description

availability_progressobject nullable

Live slot/day requirements for an open availability alert, over its own two-week window.

closed_atstring date-time nullable

Close timestamp

duration_hoursinteger nullable

Alert duration in hours

is_blockingboolean

Whether this alert can block portal access once its grace period elapses

is_currently_blockingboolean required

Whether this alert is blocking access right now (grace period considered)

Changes