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.