Update Portal Status
POST/api/portals/status
Tier: Internal — subject to change without notice.
Accepts a status snapshot pushed by a portal device (portal, device, antenna, sensor, and actuator states).
A device reporting PartiallyOperating whose antennas are all Operating/Disabled is promoted to
FullyOperating; if every device on the portal is then FullyOperating, the portal status is
promoted to Enums.PortalOperationStatus's OnlineOperational member. Status cascades:
portal Offline forces every device to Unknown; otherwise per-device statuses are applied and
cascade to their antennas/sensors/actuators, recording SensorStatusHistory/ActuatorStatusHistory
rows on change. Every call appends a PortalStatusHistory row with the full serialized snapshot,
regardless of whether anything changed. Status changes raise
AgentStatusNotificationEvents consumed by the domain-event alert subsystem.
Request
Responses
- 200
- 400
- 401
- 403
Returns true.
The PortalId does not resolve to a portal in the caller's organisation (NotFound).
Caller is not authenticated.
Caller does not have Create permission on the Portal module (device endpoint — requires Create, not Update).