modl.gg

List Staff

Retrieve all staff members and their roles.

GET /v1/minecraft/staff

Retrieve a list of all staff members registered on the server, including their assigned roles and permissions.

Authentication

Requires the X-API-Key header with your server's API key.

X-API-Key: your-api-key-here

Request

Headers

HeaderTypeRequiredDescription
X-API-KeystringYesYour server's API key.

This endpoint takes no additional parameters.

Response

200 OK

{
  "staff": [
    {
      "id": "staff_abc123",
      "username": "StaffMember",
      "email": "staff@example.com",
      "role": "Moderator",
      "permissions": [
        "punish",
        "tickets.view",
        "tickets.reply",
        "reports.view"
      ],
      "minecraftUuid": "550e8400-e29b-41d4-a716-446655440000",
      "lastActive": "2024-01-15T12:00:00Z",
      "createdAt": "2023-06-01T00:00:00Z"
    },
    {
      "id": "staff_def456",
      "username": "AdminUser",
      "email": "admin@example.com",
      "role": "Admin",
      "permissions": [
        "punish",
        "tickets.view",
        "tickets.reply",
        "tickets.manage",
        "reports.view",
        "reports.manage",
        "staff.manage",
        "roles.manage"
      ],
      "minecraftUuid": "660e8400-e29b-41d4-a716-446655440001",
      "lastActive": "2024-01-15T14:00:00Z",
      "createdAt": "2023-01-01T00:00:00Z"
    }
  ]
}

Error Responses

Status CodeDescription
401Missing or invalid API key.
429Rate limit exceeded.
500Internal server error.

On this page