List Discord guild members
Cursor-paginated list of guild members. Returns Discord's raw member objects so callers can build community-ops automation (e.g. "add role to all members joined in the last 7 days") on the actual platform shape.
Important: this endpoint requires the privileged "Server Members Intent" enabled on the Discord app (Developer Portal → Bot tab → toggle "Server Members Intent" ON, then Save). Without it, Discord returns an empty array with no error. Verify the intent is enabled before relying on this endpoint.
Pagination: pass after = the last user.id from the previous page.
Omit on the first call. Response includes a nextCursor and hasMore
flag so callers don't need to know Discord's pagination shape.
API key authentication - use your Zernio API key as a Bearer token
In: header
Path Parameters
Query Parameters
Page size (1-1000).
1001 <= value <= 1000Snowflake of the last member from the previous page.
Response Body
application/json
application/json
import Zernio from '@zernio/node';const zernio = new Zernio({ apiKey: process.env.ZERNIO_API_KEY });const { data } = await zernio.discord.listDiscordGuildMembers({ path: { guildId: 'guild_abc123', }, query: { accountId: 'account_abc123', },});console.log(data);{
"data": [
{
"user": {
"id": "string",
"username": "string",
"discriminator": "string",
"avatar": "string",
"global_name": "string"
},
"nick": "string",
"roles": [
"string"
],
"joined_at": "2019-08-24T14:15:22Z",
"premium_since": "2019-08-24T14:15:22Z"
}
],
"pagination": {
"nextCursor": "string",
"hasMore": true
}
}{
"error": "Unauthorized"
}Delete a Discord guild role DELETE
Permanently deletes a role from the guild and removes it from every member. This cannot be undone. Requires the bot to hold Manage Roles, and the target role must sit below the bot's highest role.
Assign a role to a guild member PUT
Assign one role to one member. Idempotent on Discord's side — re-running on a member who already has the role is a 204 no-op. Path shape mirrors Discord's own API (`PUT /guilds/{guild}/members/{user}/roles/{role}`) for zero-translation mental mapping. Bot needs MANAGE_ROLES permission in the guild AND its highest role must be above the target role (Discord hierarchy rule). The `@everyone` role (where roleId == guildId) cannot be assigned.