Appearance
Kind 39001: Group Admins
Overview
This event contains a list of administrators for a relay-based group along with their assigned roles. It is generated and signed by the relay itself and serves as an authoritative source of information about who has administrative privileges in the group.
Specification
Property | Value |
---|---|
Kind Number | 39001 |
Event Range | Addressable |
Defined in | NIP-29 |
Content Format
The content
field typically contains a short description of the event, such as "list of admins for the [group name] group".
Schema
"list of admins for the [group name] group"
Tags
Tag Name | Description | Format | Required |
---|---|---|---|
d | Group identifier | ["d", "<group-id>"] | Yes |
p | Admin public key with roles | ["p", "<pubkey-hex>", "<role1>", "<role2>", ...] | Yes |
Client Behavior
Clients should use this event to identify who has administrative privileges in the group and what roles they hold. This information can be used to display admin badges or special indicators next to admin names, and to determine who can perform certain administrative actions.
Relay Behavior
This event MUST be generated and signed by the relay's master key. Relays shouldn't accept these events if they're signed by anyone else.
Relays should create or update this event when:
- A new group is created and initial admins are assigned.
- Users are granted administrative roles via kind 9000 events.
- Admins are removed or have their roles changed.
Each admin is listed along with one or more roles. These roles SHOULD have a correspondence with the roles supported by the relay, as advertised by the kind 39003 event.
Users with any roles that have any privilege can be considered admins in a broad sense and should be included in this event.
Use Cases
- Displaying admin badges or indicators in the client UI.
- Determining who is allowed to perform administrative actions.
- Identifying group leadership or moderation team.
Example
json
{
"id": "...",
"pubkey": "1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"created_at": 1671217411,
"kind": 39001,
"tags": [
["d", "vegans-united"],
["p", "abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890", "ceo"],
["p", "bcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890a", "secretary", "gardener"],
["p", "cdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890ab", "moderator"]
],
"content": "list of admins for the vegan group",
"sig": "..."
}
References
Related Kinds
- Kind 9000: Group User Addition
- Kind 39000: Group Metadata
- Kind 39002: Group Members
- Kind 39003: Group Roles
Notes
The exact role names (such as "ceo", "secretary", "moderator", etc.) are not standardized in NIP-29. Each relay may define its own role names and associated permissions. The kind 39003 event should provide information about what roles are supported by the relay and what they mean.