docs: improve documentation of recent envelopes (#1061)

envelope-zero · Aug 3, 2024 · e30e114 · e30e114
1 parent 1205da0
commit e30e114
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/pkg/controllers/v4/account.go b/pkg/controllers/v4/account.go
@@ -248,6 +248,11 @@ func GetAccount(c *gin.Context) {
 // @Failure		500	{object}	RecentEnvelopesResponse
 // @Param			id	path		string	true	"ID formatted as string"
 // @Router			/v4/accounts/{id}/recent-envelopes [get]
+//
+// GetAccountRecentEnvelopes returns recent envelopes for an account.
+//
+// Income is returned as a RecentEnvelope with the nil ID.
+// Clients must be able to handle this.
 func GetAccountRecentEnvelopes(c *gin.Context) {
 	id, err := httputil.UUIDFromString(c.Param("id"))
 	if err != nil {