Skip to content

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

PropertyValue
Kind Number39001
Event RangeAddressable
Defined inNIP-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 NameDescriptionFormatRequired
dGroup identifier["d", "<group-id>"]Yes
pAdmin 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:

  1. A new group is created and initial admins are assigned.
  2. Users are granted administrative roles via kind 9000 events.
  3. 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

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.