From f07c5873099c7d904313c2fc6768d7dcb0bff89e Mon Sep 17 00:00:00 2001
From: Joakim Berglund <mail@joakimberglund.com>
Date: Sat, 16 May 2026 23:20:59 +0200
Subject: [PATCH 1/2] Add support for setting group member label

---
 doc/EXAMPLES.md       | 10 ++++++++++
 src/api/api.go        | 16 +++++++++-------
 src/client/client.go  | 16 +++++++++++++++-
 src/docs/docs.go      |  6 ++++++
 src/docs/swagger.json |  8 +++++++-
 src/docs/swagger.yaml |  4 ++++
 6 files changed, 51 insertions(+), 9 deletions(-)

diff --git a/doc/EXAMPLES.md b/doc/EXAMPLES.md
index 597175d..11c235c 100644
--- a/doc/EXAMPLES.md
+++ b/doc/EXAMPLES.md
@@ -115,6 +115,16 @@ e.g:
 
   `curl -X GET -H "Content-Type: application/json" 'http://127.0.0.1:8080/v1/groups/+431212131491291'`
 
+- Update your group member label
+
+  Updates the member label for the registered number in the given group. The group id can be obtained via the "List groups" REST call.
+
+  `curl -X PUT -H "Content-Type: application/json" -d '{"member_label": "<label>", "member_label_emoji": "<emoji>"}' 'http://127.0.0.1:8080/v1/groups/<number>/<group id>'`
+
+  e.g:
+
+  `curl -X PUT -H "Content-Type: application/json" -d '{"member_label": "Dad", "member_label_emoji": "👨‍👧"}' 'http://127.0.0.1:8080/v1/groups/+431212131491291/<group id>'`
+
 - Delete a group
 
   Delete the group with the given group id. The group id can be obtained via the "List groups" REST call.
diff --git a/src/api/api.go b/src/api/api.go
index 3ec81a2..6d8bdae 100644
--- a/src/api/api.go
+++ b/src/api/api.go
@@ -48,12 +48,14 @@ type CreateGroupRequest struct {
 }
 
 type UpdateGroupRequest struct {
-	Base64Avatar   *string              `json:"base64_avatar,omitempty"`
-	Description    *string              `json:"description,omitempty"`
-	Name           *string              `json:"name,omitempty"`
-	ExpirationTime *int                 `json:"expiration_time,omitempty"`
-	GroupLinkState *string              `json:"group_link,omitempty" enums:"disabled,enabled,enabled-with-approval"`
-	Permissions    *ds.GroupPermissions `json:"permissions,omitempty"`
+	Base64Avatar     *string              `json:"base64_avatar,omitempty"`
+	Description      *string              `json:"description,omitempty"`
+	Name             *string              `json:"name,omitempty"`
+	MemberLabel      *string              `json:"member_label,omitempty"`
+	MemberLabelEmoji *string              `json:"member_label_emoji,omitempty"`
+	ExpirationTime   *int                 `json:"expiration_time,omitempty"`
+	GroupLinkState   *string              `json:"group_link,omitempty" enums:"disabled,enabled,enabled-with-approval"`
+	Permissions      *ds.GroupPermissions `json:"permissions,omitempty"`
 }
 
 type PinMessageInGroupRequest struct {
@@ -1860,7 +1862,7 @@ func (a *Api) UpdateGroup(c *gin.Context) {
 	}
 
 	err = a.signalClient.UpdateGroup(number, internalGroupId, req.Base64Avatar, req.Description, req.Name, req.ExpirationTime, groupLinkState,
-		editGroupPermission, addMembersPermission, sendMessagesPermission)
+		editGroupPermission, addMembersPermission, sendMessagesPermission, req.MemberLabel, req.MemberLabelEmoji)
 	if err != nil {
 		c.JSON(400, Error{Msg: err.Error()})
 		return
diff --git a/src/client/client.go b/src/client/client.go
index 5dc5985..8964b87 100644
--- a/src/client/client.go
+++ b/src/client/client.go
@@ -2053,7 +2053,8 @@ func (s *SignalClient) QuitGroup(number string, groupId string) error {
 }
 
 func (s *SignalClient) UpdateGroup(number string, groupId string, base64Avatar *string, groupDescription *string, groupName *string, expirationTime *int,
-	groupLinkState *GroupLinkState, editGroupPermission GroupPermission, addMembersPermission GroupPermission, sendMessagesPermission GroupPermission) error {
+	groupLinkState *GroupLinkState, editGroupPermission GroupPermission, addMembersPermission GroupPermission, sendMessagesPermission GroupPermission,
+	memberLabel *string, memberLabelEmoji *string) error {
 	var err error
 	var avatarTmpPath string = ""
 	if base64Avatar != nil {
@@ -2102,6 +2103,8 @@ func (s *SignalClient) UpdateGroup(number string, groupId string, base64Avatar *
 			EditGroupPermissions    string  `json:"setPermissionEditDetails,omitempty"`
 			AddMembersPermissions   string  `json:"setPermissionAddMember,omitempty"`
 			SendMessagesPermissions string  `json:"setPermissionSendMessages,omitempty"`
+			MemberLabel             *string `json:"memberLabel,omitempty"`
+			MemberLabelEmoji        *string `json:"memberLabelEmoji,omitempty"`
 		}
 		request := Request{GroupId: groupId}
 
@@ -2132,6 +2135,9 @@ func (s *SignalClient) UpdateGroup(number string, groupId string, base64Avatar *
 			request.SendMessagesPermissions = sendMessagesPermission.String()
 		}
 
+		request.MemberLabel = memberLabel
+		request.MemberLabelEmoji = memberLabelEmoji
+
 		jsonRpc2Client, err := s.getJsonRpc2Client()
 		if err != nil {
 			return err
@@ -2171,6 +2177,14 @@ func (s *SignalClient) UpdateGroup(number string, groupId string, base64Avatar *
 			cmd = append(cmd, []string{"--set-permission-send-messages", sendMessagesPermission.String()}...)
 		}
 
+		if memberLabelEmoji != nil {
+			cmd = append(cmd, []string{"--member-label-emoji", *memberLabelEmoji}...)
+		}
+
+		if memberLabel != nil {
+			cmd = append(cmd, []string{"--member-label", *memberLabel}...)
+		}
+
 		_, err = s.cliClient.Execute(true, cmd, "")
 	}
 
diff --git a/src/docs/docs.go b/src/docs/docs.go
index d4e175d..e99120a 100644
--- a/src/docs/docs.go
+++ b/src/docs/docs.go
@@ -3353,6 +3353,12 @@ const docTemplate = `{
                         "enabled-with-approval"
                     ]
                 },
+                "member_label": {
+                    "type": "string"
+                },
+                "member_label_emoji": {
+                    "type": "string"
+                },
                 "name": {
                     "type": "string"
                 },
diff --git a/src/docs/swagger.json b/src/docs/swagger.json
index e8fbd6f..a9abc3a 100644
--- a/src/docs/swagger.json
+++ b/src/docs/swagger.json
@@ -3350,6 +3350,12 @@
                         "enabled-with-approval"
                     ]
                 },
+                "member_label": {
+                    "type": "string"
+                },
+                "member_label_emoji": {
+                    "type": "string"
+                },
                 "name": {
                     "type": "string"
                 },
@@ -3835,4 +3841,4 @@
             "name": "Sticker Packs"
         }
     ]
-}
\ No newline at end of file
+}
diff --git a/src/docs/swagger.yaml b/src/docs/swagger.yaml
index 0d10fc6..ad98a35 100644
--- a/src/docs/swagger.yaml
+++ b/src/docs/swagger.yaml
@@ -438,6 +438,10 @@ definitions:
         - enabled
         - enabled-with-approval
         type: string
+      member_label:
+        type: string
+      member_label_emoji:
+        type: string
       name:
         type: string
       permissions:

From 0938262814a70af91f7daba84e868586c1c6bc4a Mon Sep 17 00:00:00 2001
From: Joakim Berglund <mail@joakimberglund.com>
Date: Sun, 17 May 2026 00:13:08 +0200
Subject: [PATCH 2/2] Expose group member labels in group responses

---
 src/client/client.go     | 128 +++++++++++++++++++++++++++------------
 src/client/group_test.go |  82 +++++++++++++++++++++++++
 src/docs/docs.go         |   8 +++
 src/docs/swagger.json    |   8 +++
 src/docs/swagger.yaml    |   6 ++
 5 files changed, 193 insertions(+), 39 deletions(-)
 create mode 100644 src/client/group_test.go

diff --git a/src/client/client.go b/src/client/client.go
index 8964b87..caef103 100644
--- a/src/client/client.go
+++ b/src/client/client.go
@@ -113,22 +113,26 @@ func (g GroupLinkState) FromString(input string) GroupLinkState {
 }
 
 type GroupEntry struct {
-	Name            string              `json:"name"`
-	Description     string              `json:"description"`
-	Id              string              `json:"id"`
-	InternalId      string              `json:"internal_id"`
-	Members         []string            `json:"members"`
-	Blocked         bool                `json:"blocked"`
-	PendingInvites  []string            `json:"pending_invites"`
-	PendingRequests []string            `json:"pending_requests"`
-	InviteLink      string              `json:"invite_link"`
-	Admins          []string            `json:"admins"`
-	Permissions     ds.GroupPermissions `json:"permissions"`
+	Name             string              `json:"name"`
+	Description      string              `json:"description"`
+	Id               string              `json:"id"`
+	InternalId       string              `json:"internal_id"`
+	MemberLabel      string              `json:"member_label"`
+	MemberLabelEmoji string              `json:"member_label_emoji"`
+	Members          []string            `json:"members"`
+	Blocked          bool                `json:"blocked"`
+	PendingInvites   []string            `json:"pending_invites"`
+	PendingRequests  []string            `json:"pending_requests"`
+	InviteLink       string              `json:"invite_link"`
+	Admins           []string            `json:"admins"`
+	Permissions      ds.GroupPermissions `json:"permissions"`
 }
 
 type GroupMember struct {
-	Number string `json:"number"`
-	Uuid   string `json:"uuid"`
+	Number     string  `json:"number"`
+	Uuid       string  `json:"uuid"`
+	LabelEmoji *string `json:"label_emoji,omitempty"`
+	Label      *string `json:"label,omitempty"`
 }
 
 type GroupAdmin struct {
@@ -136,18 +140,27 @@ type GroupAdmin struct {
 	Uuid   string `json:"uuid"`
 }
 
+type SignalCliGroupMember struct {
+	Number     string  `json:"number"`
+	Uuid       string  `json:"uuid"`
+	LabelEmoji *string `json:"labelEmoji"`
+	Label      *string `json:"label"`
+}
+
 type ExpandedGroupEntry struct {
-	Name            string              `json:"name"`
-	Description     string              `json:"description"`
-	Id              string              `json:"id"`
-	InternalId      string              `json:"internal_id"`
-	Members         []GroupMember       `json:"members"`
-	Blocked         bool                `json:"blocked"`
-	PendingInvites  []GroupMember       `json:"pending_invites"`
-	PendingRequests []GroupMember       `json:"pending_requests"`
-	InviteLink      string              `json:"invite_link"`
-	Admins          []GroupAdmin        `json:"admins"`
-	Permissions     ds.GroupPermissions `json:"permissions"`
+	Name             string              `json:"name"`
+	Description      string              `json:"description"`
+	Id               string              `json:"id"`
+	InternalId       string              `json:"internal_id"`
+	MemberLabel      string              `json:"member_label"`
+	MemberLabelEmoji string              `json:"member_label_emoji"`
+	Members          []GroupMember       `json:"members"`
+	Blocked          bool                `json:"blocked"`
+	PendingInvites   []GroupMember       `json:"pending_invites"`
+	PendingRequests  []GroupMember       `json:"pending_requests"`
+	InviteLink       string              `json:"invite_link"`
+	Admins           []GroupAdmin        `json:"admins"`
+	Permissions      ds.GroupPermissions `json:"permissions"`
 }
 
 type IdentityEntry struct {
@@ -160,20 +173,22 @@ type IdentityEntry struct {
 }
 
 type SignalCliGroupEntry struct {
-	Name                  string        `json:"name"`
-	Description           string        `json:"description"`
-	Id                    string        `json:"id"`
-	IsMember              bool          `json:"isMember"`
-	IsBlocked             bool          `json:"isBlocked"`
-	Members               []GroupMember `json:"members"`
-	PendingMembers        []GroupMember `json:"pendingMembers"`
-	RequestingMembers     []GroupMember `json:"requestingMembers"`
-	GroupInviteLink       string        `json:"groupInviteLink"`
-	Admins                []GroupAdmin  `json:"admins"`
-	Uuid                  string        `json:"uuid"`
-	PermissionEditDetails string        `json:"permissionEditDetails"`
-	PermissionAddMember   string        `json:"permissionAddMember"`
-	PermissionSendMessage string        `json:"permissionSendMessage"`
+	Name                  string                 `json:"name"`
+	Description           string                 `json:"description"`
+	Id                    string                 `json:"id"`
+	IsMember              bool                   `json:"isMember"`
+	IsBlocked             bool                   `json:"isBlocked"`
+	MemberLabel           *string                `json:"memberLabel"`
+	MemberLabelEmoji      *string                `json:"memberLabelEmoji"`
+	Members               []SignalCliGroupMember `json:"members"`
+	PendingMembers        []GroupMember          `json:"pendingMembers"`
+	RequestingMembers     []GroupMember          `json:"requestingMembers"`
+	GroupInviteLink       string                 `json:"groupInviteLink"`
+	Admins                []GroupAdmin           `json:"admins"`
+	Uuid                  string                 `json:"uuid"`
+	PermissionEditDetails string                 `json:"permissionEditDetails"`
+	PermissionAddMember   string                 `json:"permissionAddMember"`
+	PermissionSendMessage string                 `json:"permissionSendMessage"`
 }
 
 type SignalCliIdentityEntry struct {
@@ -1205,6 +1220,35 @@ func prefixUsernameMembers(members []string) []string {
 	return res
 }
 
+func signalCliGroupMembersToGroupMembers(signalCliGroupMembers []SignalCliGroupMember) []GroupMember {
+	groupMembers := []GroupMember{}
+	for _, signalCliGroupMember := range signalCliGroupMembers {
+		groupMembers = append(groupMembers, GroupMember{
+			Number:     signalCliGroupMember.Number,
+			Uuid:       signalCliGroupMember.Uuid,
+			LabelEmoji: signalCliGroupMember.LabelEmoji,
+			Label:      signalCliGroupMember.Label,
+		})
+	}
+	return groupMembers
+}
+
+func stringValue(value *string) string {
+	if value == nil {
+		return ""
+	}
+	return *value
+}
+
+func findOwnGroupMemberLabel(members []SignalCliGroupMember, number string) (string, string) {
+	for _, member := range members {
+		if member.Number == number {
+			return stringValue(member.Label), stringValue(member.LabelEmoji)
+		}
+	}
+	return "", ""
+}
+
 func (s *SignalClient) updateGroupMembers(number string, groupId string, members []string, add bool) error {
 
 	if len(members) == 0 {
@@ -1366,10 +1410,15 @@ func (s *SignalClient) GetGroupsExpanded(number string) ([]ExpandedGroupEntry, e
 		groupEntry.Id = convertInternalGroupIdToGroupId(signalCliGroupEntry.Id)
 		groupEntry.Blocked = signalCliGroupEntry.IsBlocked
 		groupEntry.Description = signalCliGroupEntry.Description
+		groupEntry.MemberLabel = stringValue(signalCliGroupEntry.MemberLabel)
+		groupEntry.MemberLabelEmoji = stringValue(signalCliGroupEntry.MemberLabelEmoji)
+		if groupEntry.MemberLabel == "" && groupEntry.MemberLabelEmoji == "" {
+			groupEntry.MemberLabel, groupEntry.MemberLabelEmoji = findOwnGroupMemberLabel(signalCliGroupEntry.Members, number)
+		}
 		groupEntry.Permissions.SendMessages = signalCliGroupPermissionToRestApiGroupPermission(signalCliGroupEntry.PermissionSendMessage)
 		groupEntry.Permissions.EditGroup = signalCliGroupPermissionToRestApiGroupPermission(signalCliGroupEntry.PermissionSendMessage)
 		groupEntry.Permissions.AddMembers = signalCliGroupPermissionToRestApiGroupPermission(signalCliGroupEntry.PermissionAddMember)
-		groupEntry.Members = signalCliGroupEntry.Members
+		groupEntry.Members = signalCliGroupMembersToGroupMembers(signalCliGroupEntry.Members)
 		groupEntry.PendingInvites = signalCliGroupEntry.PendingMembers
 		groupEntry.PendingRequests = signalCliGroupEntry.RequestingMembers
 		groupEntry.Admins = signalCliGroupEntry.Admins
@@ -1391,6 +1440,7 @@ func (s *SignalClient) GetGroups(number string) ([]GroupEntry, error) {
 	for _, expandedGroupEntry := range expandedGroupEntries {
 		groupEntry := GroupEntry{InternalId: expandedGroupEntry.InternalId, Name: expandedGroupEntry.Name,
 			Id: expandedGroupEntry.Id, Blocked: expandedGroupEntry.Blocked, Description: expandedGroupEntry.Description,
+			MemberLabel: expandedGroupEntry.MemberLabel, MemberLabelEmoji: expandedGroupEntry.MemberLabelEmoji,
 			Permissions: expandedGroupEntry.Permissions, InviteLink: expandedGroupEntry.InviteLink}
 
 		members := []string{}
diff --git a/src/client/group_test.go b/src/client/group_test.go
new file mode 100644
index 0000000..98accd8
--- /dev/null
+++ b/src/client/group_test.go
@@ -0,0 +1,82 @@
+package client
+
+import (
+	"encoding/json"
+	"testing"
+)
+
+func TestSignalCliGroupEntryMemberLabelFields(t *testing.T) {
+	var signalCliGroupEntry SignalCliGroupEntry
+	rawGroup := []byte(`{"id":"abc","members":[{"number":"+1234","uuid":"uuid-1","labelEmoji":"\ud83d\udc4b","label":"Dad"}]}`)
+
+	if err := json.Unmarshal(rawGroup, &signalCliGroupEntry); err != nil {
+		t.Fatalf("json.Unmarshal() error: %v", err)
+	}
+
+	memberLabel, memberLabelEmoji := findOwnGroupMemberLabel(signalCliGroupEntry.Members, "+1234")
+
+	if memberLabel != "Dad" {
+		t.Fatalf("memberLabel got %v, want Dad", memberLabel)
+	}
+
+	if memberLabelEmoji != "\U0001F44B" {
+		t.Fatalf("memberLabelEmoji got %v, want \\U0001F44B", memberLabelEmoji)
+	}
+
+	groupEntry := GroupEntry{
+		MemberLabel:      memberLabel,
+		MemberLabelEmoji: memberLabelEmoji,
+	}
+
+	encodedGroup, err := json.Marshal(groupEntry)
+	if err != nil {
+		t.Fatalf("json.Marshal() error: %v", err)
+	}
+
+	var response map[string]any
+	if err := json.Unmarshal(encodedGroup, &response); err != nil {
+		t.Fatalf("json.Unmarshal() response error: %v", err)
+	}
+
+	if response["member_label"] != "Dad" {
+		t.Fatalf("member_label got %v, want Dad", response["member_label"])
+	}
+
+	if response["member_label_emoji"] != "\U0001F44B" {
+		t.Fatalf("member_label_emoji got %v, want \\U0001F44B", response["member_label_emoji"])
+	}
+}
+
+func TestSignalCliGroupEntryMissingMemberLabelFields(t *testing.T) {
+	var signalCliGroupEntry SignalCliGroupEntry
+	rawGroup := []byte(`{"id":"abc","members":[{"number":"+1234","uuid":"uuid-1"}]}`)
+
+	if err := json.Unmarshal(rawGroup, &signalCliGroupEntry); err != nil {
+		t.Fatalf("json.Unmarshal() error: %v", err)
+	}
+
+	memberLabel, memberLabelEmoji := findOwnGroupMemberLabel(signalCliGroupEntry.Members, "+1234")
+
+	groupEntry := GroupEntry{
+		MemberLabel:      memberLabel,
+		MemberLabelEmoji: memberLabelEmoji,
+	}
+
+	encodedGroup, err := json.Marshal(groupEntry)
+	if err != nil {
+		t.Fatalf("json.Marshal() error: %v", err)
+	}
+
+	var response map[string]any
+	if err := json.Unmarshal(encodedGroup, &response); err != nil {
+		t.Fatalf("json.Unmarshal() response error: %v", err)
+	}
+
+	if response["member_label"] != "" {
+		t.Fatalf("member_label got %v, want empty string", response["member_label"])
+	}
+
+	if response["member_label_emoji"] != "" {
+		t.Fatalf("member_label_emoji got %v, want empty string", response["member_label_emoji"])
+	}
+}
diff --git a/src/docs/docs.go b/src/docs/docs.go
index e99120a..ec0caad 100644
--- a/src/docs/docs.go
+++ b/src/docs/docs.go
@@ -3496,6 +3496,8 @@ const docTemplate = `{
                 "id",
                 "internal_id",
                 "invite_link",
+                "member_label",
+                "member_label_emoji",
                 "members",
                 "name",
                 "pending_invites",
@@ -3524,6 +3526,12 @@ const docTemplate = `{
                 "invite_link": {
                     "type": "string"
                 },
+                "member_label": {
+                    "type": "string"
+                },
+                "member_label_emoji": {
+                    "type": "string"
+                },
                 "members": {
                     "type": "array",
                     "items": {
diff --git a/src/docs/swagger.json b/src/docs/swagger.json
index a9abc3a..5da1b0e 100644
--- a/src/docs/swagger.json
+++ b/src/docs/swagger.json
@@ -3493,6 +3493,8 @@
                 "id",
                 "internal_id",
                 "invite_link",
+                "member_label",
+                "member_label_emoji",
                 "members",
                 "name",
                 "pending_invites",
@@ -3521,6 +3523,12 @@
                 "invite_link": {
                     "type": "string"
                 },
+                "member_label": {
+                    "type": "string"
+                },
+                "member_label_emoji": {
+                    "type": "string"
+                },
                 "members": {
                     "type": "array",
                     "items": {
diff --git a/src/docs/swagger.yaml b/src/docs/swagger.yaml
index ad98a35..f51a941 100644
--- a/src/docs/swagger.yaml
+++ b/src/docs/swagger.yaml
@@ -546,6 +546,10 @@ definitions:
         type: string
       invite_link:
         type: string
+      member_label:
+        type: string
+      member_label_emoji:
+        type: string
       members:
         items:
           type: string
@@ -569,6 +573,8 @@ definitions:
     - id
     - internal_id
     - invite_link
+    - member_label
+    - member_label_emoji
     - members
     - name
     - pending_invites