List Department Shift Types

Lists a department's shift types.

GET

/api/v1/server/departments/{departmentId}/shift-types

Request

curl -X GET "https://api.melonly.com/api/v1/server/departments/{departmentId}/shift-types" \
  -H "Authorization: Bearer YOUR_TOKEN"

Response

200

Success

{
  "data": [
    {
      "createdAt": 1794776859830,
      "discordRoleId": "1100000000000000001",
      "id": "7400000000000000000",
      "name": "Highway Patrol",
      "nicknamePrefix": "[HP] ",
      "requiredRoles": [
        "7314779729419046912"
      ],
      "serverId": "7294057520392310784"
    }
  ],
  "page": 1,
  "pageSize": 10,
  "total": 1,
  "totalPages": 1
}

You can order by createdAt (default) or id.

Authorization

Authorizationstringrequired
Your API token as Bearer YOUR_TOKEN. Create one in your server's dashboard settings.

Path parameters

departmentIdstringrequired

Query parameters

pageintegerdefault: 1
1-based page number. Defaults to 1.
pageSizeintegerdefault: 10
Items per page, clamped to 1-100. Defaults to 10.
orderBystring
Field to sort by. See the endpoint description for the accepted values.
sortstring
Sort direction. Defaults to desc.
Allowed values:ascdesc

Response

200 Success. Results are paged and also include page, pageSize, total and totalPages.

createdAtintegerrequired
When it was created.
idstringrequired
Unique ID.
namestringrequired
Shift type name.
requiredRolesstring[]required
Role IDs allowed to start this type of shift. Empty means anyone.
serverIdstringrequired
Server ID, or department ID for department shift types.
discordRoleIdstring | null
Discord role given while on this type of shift.
nicknamePrefixstring | null
Nickname prefix added while on this type of shift.

Errors

StatusMeaning
400Invalid request. validation_failed lists each invalid field in details.fields.
401Missing, invalid or expired token
404Not found
429Rate limited. See Retry-After and details.
500Internal server error