diff --git a/account.proto b/account.proto
index 3f237e4..2766f3d 100644
--- a/account.proto
+++ b/account.proto
@@ -1,7 +1,7 @@
 syntax = "proto3";
 
 import "google/protobuf/struct.proto";
-import "google/protobuf/timestamp.proto";    
+import "google/protobuf/timestamp.proto";
 
 package account;
 
@@ -74,12 +74,12 @@ message CreateAccountResponse {
 
 message AdminGetAccountRequest {
     // The name of the account to get
-    string name = 1; 
+    string name = 1;
 }
 
 message DeleteAccountRequest {
     // The name of the account to delete
-    string name = 1;     
+    string name = 1;
 }
 message DeleteAccountResponse {}
 
@@ -229,7 +229,7 @@ message CreateSourceResponse {
 }
 
 message GetSourceRequest {
-    bytes UUID = 1; 
+    bytes UUID = 1;
 }
 
 message GetSourceResponse {
@@ -254,8 +254,17 @@ message DeleteSourceRequest {
 
 message DeleteSourceResponse {}
 
-message KeepaliveSourcesRequest {}
-message KeepaliveSourcesResponse {}
+message KeepaliveSourcesRequest {
+    // Set to true to have the API call wait until the source is up and healthy
+    bool waitForHealthy = 1;
+}
+message KeepaliveSourcesResponse {
+    // returns true if any of the sources did not come up in time
+    bool failed = 1;
+
+    // returns an indication of why not all sources were healthy
+    string error = 2;
+}
 
 message CreateTokenRequest {
     // The Public NKey of the user that is requesting a token
diff --git a/bookmarks.proto b/bookmarks.proto
index cc01ca1..557f152 100644
--- a/bookmarks.proto
+++ b/bookmarks.proto
@@ -31,6 +31,7 @@ import "items.proto";
 option go_package = "github.com/overmindtech/sdp-go;sdp";
 
 service BookmarksService {
+    // returns all bookmarks of the current user. note that this does not include the actual bookmark data, use GetBookmark for that
     rpc ListBookmarks(ListBookmarksRequest) returns (ListBookmarkResponse);
     rpc CreateBookmark(CreateBookmarkRequest) returns (CreateBookmarkResponse);
     rpc GetBookmark(GetBookmarkRequest) returns (GetBookmarkResponse);