go-ring API Reference
Guides

Recordings and timeline

Browse history, stream a recording, and manage saved events.

GetDeviceHistory lists a device's recordings. Use OlderThan for the next page. GetDeviceTimeline and GetHistoryDevices provide other history views; GetActiveDings returns current events.

history, err := client.GetDeviceHistory(ctx, ring.GetDeviceHistoryRequest{
	Auth: auth, DeviceID: deviceID, Limit: 20,
})
if err != nil {
	return err
}

GetRecording opens a video stream for a recording ID; close its body after reading. GetRecordingShareURL asks the server for a share link. FavoriteRecording and DeleteRecording change saved recordings. Confirm deletion with your user before calling DeleteRecording.

Wire contracts: history, timeline, stream, share, favorite, and delete.