{"openapi":"3.1.0","info":{"title":"Melonly API","description":"The Melonly API lets you read and update your server's data from your own bots and tools.\n\n### Getting started\n\nCreate a token in your server's dashboard settings, then send it with each request:\n\n```\nAuthorization: Bearer YOUR_TOKEN\n```\n\nA token only has access to the server it was created for (and that server's departments).\n\n### Responses\n\nSuccessful responses put the result under `data`. Lists also include `page`, `pageSize`, `total` and `totalPages`.\n\nErrors look like this:\n\n```json\n{ \"error\": { \"code\": \"not_found\", \"message\": \"log not found\" } }\n```\n\nIf a request body has a problem, you'll get a `400` with the code `validation_failed` and the bad fields listed in `details.fields`.\n\n### Paging\n\nUse `page` and `pageSize` (max 100) to page through lists, and `orderBy` / `sort` to change the order. Each endpoint lists the fields you can order by.\n\n### IDs\n\nIDs are strings, and timestamps are in milliseconds. Member IDs are Melonly user IDs, not Discord IDs. To find a member from their Discord ID, use `GET /api/v1/server/members/discord/{discordId}`.\n\n### Creating and changing things\n\nWrites are done on behalf of a staff member, who you pass as `createdBy`, `issuedBy`, `performedBy` or `memberId`. It works the same as if they did it in the dashboard: their permissions apply, and Melonly sends the usual Discord messages, DMs and role changes.\n\nA `502` means Melonly didn't confirm the change, but it may have gone through anyway, so check before trying again.\n\n### Rate limits\n\nYou can make 60 requests a minute. Servers without premium are limited to 100 requests a month.\n\nWhen you hit a limit you'll get a `429`. The `Retry-After` header says how many seconds to wait.","license":{"name":""},"version":"2.1.0"},"servers":[{"url":"https://api.melonly.com","description":"Production"}],"paths":{"/api/v1/server/applications":{"get":{"tags":["applications"],"summary":"List Applications","description":"Lists your server's forms.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_applications","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Application"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/applications/user/{userId}/responses":{"get":{"tags":["applications"],"summary":"List a User's Responses","description":"Lists everything one person has submitted to your server's forms.\n\nYou can order by `createdAt` (default), `reviewedAt`, `status` or `id`.","operationId":"user_application_responses","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_ApplicationResponse"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/applications/{applicationId}":{"get":{"tags":["applications"],"summary":"Get an Application","description":"Gets one form.","operationId":"get_application","parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Application"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/applications/{applicationId}/responses":{"get":{"tags":["applications"],"summary":"List Responses","description":"Lists the responses to a form, newest first. Order by `status` to group pending ones\ntogether.\n\nYou can order by `createdAt` (default), `reviewedAt`, `status` or `id`.","operationId":"application_responses","parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_ApplicationResponse"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/applications/{applicationId}/responses/{responseId}/approve":{"post":{"tags":["applications"],"summary":"Approve a Response","description":"Approves a pending response as `performedBy`.","operationId":"approve_application_response","parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"responseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_ApplicationResponse"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Not pending review","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/applications/{applicationId}/responses/{responseId}/deny":{"post":{"tags":["applications"],"summary":"Deny a Response","description":"Denies a pending response as `performedBy`.","operationId":"deny_application_response","parameters":[{"name":"applicationId","in":"path","required":true,"schema":{"type":"string"}},{"name":"responseId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_ApplicationResponse"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Not pending review","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/audit-logs":{"get":{"tags":["audit-logs"],"summary":"List Audit Log Events","description":"Lists audit log events, newest first.\n\nYou can order by `timestamp` (default) or `id`.","operationId":"list_audit_logs","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_AuditLogEvent"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/calls":{"get":{"tags":["cad"],"summary":"List Calls","description":"Lists calls, newest first.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_calls","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_CadCall"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"CAD is not set up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/calls/{callId}":{"get":{"tags":["cad"],"summary":"Get a Call","description":"Gets one call.","operationId":"get_call","parameters":[{"name":"callId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CadCall"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/calls/{callId}/notes":{"get":{"tags":["cad"],"summary":"List Call Notes","description":"Lists the notes on a call.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_call_notes","parameters":[{"name":"callId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_CadCallNote"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"CAD is not set up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/calls/{callId}/notes/{noteId}":{"get":{"tags":["cad"],"summary":"Get a Call Note","description":"Gets one call note.","operationId":"get_call_note","parameters":[{"name":"callId","in":"path","required":true,"schema":{"type":"string"}},{"name":"noteId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CadCallNote"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/court-hearings":{"get":{"tags":["cad"],"summary":"List Court Hearings","description":"Lists court hearings, newest first.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_court_hearings","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_CadCourtHearing"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"CAD is not set up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/court-hearings/{hearingId}":{"get":{"tags":["cad"],"summary":"Get a Court Hearing","description":"Gets one court hearing.","operationId":"get_court_hearing","parameters":[{"name":"hearingId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CadCourtHearing"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/records":{"get":{"tags":["cad"],"summary":"List Records","description":"Lists records, such as citations, arrests and reports, newest first.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_records","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_CadRecord"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"CAD is not set up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/records/{recordId}":{"get":{"tags":["cad"],"summary":"Get a Record","description":"Gets one record.","operationId":"get_record","parameters":[{"name":"recordId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CadRecord"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/unit-groups":{"get":{"tags":["cad"],"summary":"List Unit Groups","description":"Lists your unit groups.","operationId":"list_unit_groups","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_CadUnitGroup"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"CAD is not set up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/unit-groups/{groupId}":{"get":{"tags":["cad"],"summary":"Get a Unit Group","description":"Gets one unit group.","operationId":"get_unit_group","parameters":[{"name":"groupId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CadUnitGroup"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/units":{"get":{"tags":["cad"],"summary":"List Units","description":"Lists the units in your CAD.","operationId":"list_units","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_CadUnit"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"CAD is not set up","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/cad/units/{unitId}":{"get":{"tags":["cad"],"summary":"Get a Unit","description":"Gets one unit.","operationId":"get_unit","parameters":[{"name":"unitId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CadUnit"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments":{"get":{"tags":["departments"],"summary":"List Departments","description":"Lists your server's departments.\n\nYou can order by `id` (default).","operationId":"list_departments","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Department"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}":{"get":{"tags":["departments"],"summary":"Get a Department","description":"Gets one department.","operationId":"get_department","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Department"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/audit-logs":{"get":{"tags":["departments"],"summary":"List Department Audit Log Events","description":"Lists a department's audit log events.\n\nYou can order by `timestamp` (default) or `id`.","operationId":"list_audit_logs","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_AuditLogEvent"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/join-requests":{"get":{"tags":["departments"],"summary":"List Department Join Requests","description":"Lists pending requests to join a department.\n\nYou can order by `createdAt` (default) or `userId`.","operationId":"list_join_requests","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_JoinRequest"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/join-requests/{userId}":{"get":{"tags":["departments"],"summary":"Get a Department Join Request","description":"Gets one user's request to join a department.","operationId":"get_join_request","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"userId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_JoinRequest"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/loas":{"get":{"tags":["departments"],"summary":"List Department LOAs","description":"Lists a department's LOAs.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_loas","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Loa"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/loas/user/{memberId}":{"get":{"tags":["departments"],"summary":"List a Department Member's LOAs","description":"Lists one department member's LOAs.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"member_loas","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Loa"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/loas/{loaId}":{"get":{"tags":["departments"],"summary":"Get a Department LOA","description":"Gets one department LOA.","operationId":"get_loa","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"loaId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Loa"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/members":{"get":{"tags":["departments"],"summary":"List Department Members","description":"Lists a department's members.\n\nYou can order by `createdAt` (default), `rankPosition` or `id`.","operationId":"list_members","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_DepartmentMember"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/members/discord/{discordId}":{"get":{"tags":["departments"],"summary":"Get a Department Member by Discord ID","description":"Finds a department member from their Discord user ID.","operationId":"member_by_discord","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"discordId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_DepartmentMember"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/members/{memberId}":{"get":{"tags":["departments"],"summary":"Get a Department Member","description":"Gets one department member.","operationId":"get_member","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_DepartmentMember"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/members/{memberId}/discord":{"get":{"tags":["departments"],"summary":"Get a Department Member's Discord ID","description":"Gets a department member's Discord user ID.","operationId":"discord_by_member","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_DiscordIdResponse"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/ranks":{"get":{"tags":["departments"],"summary":"List Ranks","description":"Lists a department's ranks, top rank first.\n\nYou can order by `position` (default) or `id`.","operationId":"list_ranks","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_DepartmentRank"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/ranks/{rankId}":{"get":{"tags":["departments"],"summary":"Get a Rank","description":"Gets one rank.","operationId":"get_rank","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"rankId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_DepartmentRank"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/shift-types":{"get":{"tags":["departments"],"summary":"List Department Shift Types","description":"Lists a department's shift types.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_shift_types","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_ShiftType"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/shifts":{"get":{"tags":["departments"],"summary":"List Department Shifts","description":"Lists a department's shifts. Use `active=true` to see who's on shift.\n\nYou can order by `createdAt` (default), `endedAt` or `id`.","operationId":"list_shifts","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}},{"name":"active","in":"query","description":"`true` for shifts in progress, `false` for ended shifts.","required":false,"schema":{"type":"boolean"}},{"name":"type","in":"query","description":"Only shifts of this shift type ID.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["departments"],"summary":"Start a Department Shift","description":"Starts a department shift as `memberId`, exactly like the department dashboard.","operationId":"start_shift","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartShiftRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The member cannot start this shift type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The member already has an active shift","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/shifts/user/{memberId}":{"get":{"tags":["departments"],"summary":"List a Department Member's Shifts","description":"Lists one department member's shifts.\n\nYou can order by `createdAt` (default), `endedAt` or `id`.","operationId":"member_shifts","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}},{"name":"active","in":"query","description":"`true` for shifts in progress, `false` for ended shifts.","required":false,"schema":{"type":"boolean"}},{"name":"type","in":"query","description":"Only shifts of this shift type ID.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/shifts/{shiftId}":{"get":{"tags":["departments"],"summary":"Get a Department Shift","description":"Gets one department shift.","operationId":"get_shift","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"shiftId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/shifts/{shiftId}/breaks":{"post":{"tags":["departments"],"summary":"Start a Department Break","description":"Starts a break on an active department shift. Only the member on shift can start their own\nbreak.","operationId":"start_break","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"shiftId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Optional","content":{"application/json":{"schema":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ActionRequest"}]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Shift ended or already on break","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/shifts/{shiftId}/breaks/end":{"post":{"tags":["departments"],"summary":"End a Department Break","description":"Ends the break in progress. Send `performedBy` to end someone else's.","operationId":"end_break","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"shiftId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Optional","content":{"application/json":{"schema":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ActionRequest"}]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Shift ended or not on break","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/departments/{departmentId}/shifts/{shiftId}/end":{"post":{"tags":["departments"],"summary":"End a Department Shift","description":"Ends a department shift. Send `performedBy` to end someone else's.","operationId":"end_shift","parameters":[{"name":"departmentId","in":"path","required":true,"schema":{"type":"string"}},{"name":"shiftId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Optional","content":{"application/json":{"schema":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ActionRequest"}]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Shift already ended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/info":{"get":{"tags":["server"],"summary":"Get Your Server","description":"Gets the server the token belongs to. A quick way to check a new token works.","operationId":"server_info","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Server"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/infraction-settings":{"get":{"tags":["infractions"],"summary":"Get Infraction Settings","description":"Gets your guidelines and point thresholds.","operationId":"infraction_settings","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_InfractionSettings"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Infractions are not configured","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/infractions":{"get":{"tags":["infractions"],"summary":"List Infractions","description":"Lists your server's infractions, newest first.\n\nYou can order by `timestamp` (default), `points` or `id`.","operationId":"list_infractions","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Infraction"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["infractions"],"summary":"Issue an Infraction","description":"Issues an infraction as `issuedBy`, who needs the Issue Infractions permission and must\noutrank the member.\n\nPass a `guidelineId` from your infraction settings to use that guideline's points, or set\n`points` yourself.","operationId":"issue_infraction","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInfractionRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CreatedInfraction"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/infractions/user/{memberId}":{"get":{"tags":["infractions"],"summary":"List a Member's Infractions","description":"Lists one member's infractions.\n\nYou can order by `timestamp` (default), `points` or `id`.","operationId":"member_infractions","parameters":[{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Infraction"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/infractions/{infractionId}":{"get":{"tags":["infractions"],"summary":"Get an Infraction","description":"Gets one infraction.","operationId":"get_infraction","parameters":[{"name":"infractionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Infraction"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/infractions/{infractionId}/void":{"post":{"tags":["infractions"],"summary":"Void an Infraction","description":"Voids an infraction so its points no longer count.","operationId":"void_infraction","parameters":[{"name":"infractionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReasonRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Infraction"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Already voided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/join-requests":{"get":{"tags":["join-requests"],"summary":"List Join Requests","description":"Lists pending join requests, newest first.\n\nYou can order by `createdAt` (default) or `userId`.","operationId":"list_join_requests","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_JoinRequest"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/join-requests/{userId}":{"get":{"tags":["join-requests"],"summary":"Get a Join Request","description":"Gets one user's join request.","operationId":"get_join_request","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_JoinRequest"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/loas":{"get":{"tags":["loas"],"summary":"List LOAs","description":"Lists your server's LOAs, newest first.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_loas","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Loa"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["loas"],"summary":"Submit an LOA","description":"Submits an LOA request as `memberId`. Leave out `startAt` to start the leave as soon as it's\napproved. Your server's LOA settings decide whether a reason or end date is required, how\nlong the leave can be and how often members can ask.","operationId":"submit_loa","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLoaRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Loa"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/loas/user/{memberId}":{"get":{"tags":["loas"],"summary":"List a Member's LOAs","description":"Lists one member's LOAs.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"member_loas","parameters":[{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Loa"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/loas/{loaId}":{"get":{"tags":["loas"],"summary":"Get an LOA","description":"Gets one LOA.","operationId":"get_loa","parameters":[{"name":"loaId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Loa"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/loas/{loaId}/approve":{"post":{"tags":["loas"],"summary":"Approve an LOA","description":"Approves a pending LOA as `performedBy`, who needs to manage LOAs and outrank the member.","operationId":"approve_loa","parameters":[{"name":"loaId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Loa"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Not pending review","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/loas/{loaId}/deny":{"post":{"tags":["loas"],"summary":"Deny an LOA","description":"Denies a pending LOA as `performedBy`.","operationId":"deny_loa","parameters":[{"name":"loaId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReviewRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Loa"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Not pending review","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/loas/{loaId}/end":{"post":{"tags":["loas"],"summary":"End an LOA","description":"With no body, the member cancels their pending request or ends their own leave early. Send\n`performedBy` to end someone else's leave as staff.","operationId":"end_loa","parameters":[{"name":"loaId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Optional","content":{"application/json":{"schema":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ActionRequest"}]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Loa"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Already ended, or pending when ended by staff","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/log-types":{"get":{"tags":["logs"],"summary":"List Log Types","description":"Lists the log types you can create: the five built-in types, then your server's custom\ntypes. Use this to build a punishment picker in your bot.","operationId":"log_types","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Vec_LogType"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/logs":{"get":{"tags":["logs"],"summary":"List Logs","description":"Lists your server's logs, newest first. Use `type` to get one kind of log, such as only\nbans.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_logs","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}},{"name":"type","in":"query","description":"Only logs of this type (0-5).","required":false,"schema":{"type":"integer","format":"int32","maximum":5,"minimum":0}},{"name":"typeId","in":"query","description":"Only custom logs of this custom type ID.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Log"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["logs"],"summary":"Create a Log","description":"Creates a log as `createdBy`, who needs permission to create that type of log. If your\nserver requires staff to be on shift to log, they need to be on shift too.\n\nThe player's Roblox ID is looked up from their username. A ban also completes the player's\nactive ban BOLO.\n\nTo make a ban temporary, send `type: 2`, `tempBan: true` and an `unbanAt` up to a year away:\n\n```json\n{ \"type\": 2, \"username\": \"Builderman\", \"text\": \"flew a tractor (with exploits)\", \"createdBy\": \"7264722635089514496\", \"tempBan\": true, \"unbanAt\": 1795381659830 }\n```","operationId":"create_log","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateLogRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CreatedLog"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Premium is required, or `createdBy` lacks permission","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/logs/roblox/{robloxId}":{"get":{"tags":["logs"],"summary":"List Logs by Roblox ID","description":"Lists the logs for a Roblox user ID. This finds a player's logs even after they change their\nusername.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"roblox_logs","parameters":[{"name":"robloxId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}},{"name":"type","in":"query","description":"Only logs of this type (0-5).","required":false,"schema":{"type":"integer","format":"int32","maximum":5,"minimum":0}},{"name":"typeId","in":"query","description":"Only custom logs of this custom type ID.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Log"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/logs/staff/{staffId}":{"get":{"tags":["logs"],"summary":"List a Staff Member's Logs","description":"Lists the logs a staff member created. `staffId` is their member ID.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"staff_logs","parameters":[{"name":"staffId","in":"path","description":"Member ID","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}},{"name":"type","in":"query","description":"Only logs of this type (0-5).","required":false,"schema":{"type":"integer","format":"int32","maximum":5,"minimum":0}},{"name":"typeId","in":"query","description":"Only custom logs of this custom type ID.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Log"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/logs/user/{username}":{"get":{"tags":["logs"],"summary":"List a Player's Logs","description":"Lists the logs for a Roblox username. The username has to match how it was logged, so if a\nplayer may have changed their name, use their Roblox ID instead.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"username_logs","parameters":[{"name":"username","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}},{"name":"type","in":"query","description":"Only logs of this type (0-5).","required":false,"schema":{"type":"integer","format":"int32","maximum":5,"minimum":0}},{"name":"typeId","in":"query","description":"Only custom logs of this custom type ID.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Log"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/logs/{logId}":{"get":{"tags":["logs"],"summary":"Get a Log","description":"Gets one log.","operationId":"get_log","parameters":[{"name":"logId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Log"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["logs"],"summary":"Delete a Log","description":"Deletes a log as `performedBy`, who needs the Delete Logs permission. This can't be undone.","operationId":"delete_log","parameters":[{"name":"logId","in":"path","required":true,"schema":{"type":"string"}},{"name":"performedBy","in":"query","description":"Member ID of the staff member performing the delete, with their permissions.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Log"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["logs"],"summary":"Edit a Log","description":"Changes a log as `performedBy`. Send only the fields you want to change. Editing someone\nelse's log needs the Edit Logs permission.","operationId":"edit_log","parameters":[{"name":"logId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditLogRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Log"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/logs/{logId}/complete":{"post":{"tags":["logs"],"summary":"Complete a Ban BOLO","description":"Completes an active ban BOLO as `performedBy`. This creates the ban log, and bans the player\nin game if your server has in-game ban BOLOs turned on.","operationId":"complete_ban_bolo","parameters":[{"name":"logId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Log"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Not a ban BOLO, or already resolved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/logs/{logId}/deny":{"post":{"tags":["logs"],"summary":"Deny a Ban BOLO","description":"Denies an active ban BOLO as `performedBy`, so the player won't be banned.","operationId":"deny_ban_bolo","parameters":[{"name":"logId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ActorRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Log"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Not a ban BOLO, or already resolved","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/members":{"get":{"tags":["members"],"summary":"List Members","description":"Lists the members of your server.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_members","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Member"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/members/discord/{discordId}":{"get":{"tags":["members"],"summary":"Get a Member by Discord ID","description":"Finds a member from their Discord user ID. They need to have signed in to Melonly with that\nDiscord account.","operationId":"member_by_discord","parameters":[{"name":"discordId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Member"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/members/{memberId}":{"get":{"tags":["members"],"summary":"Get a Member","description":"Gets one member by their member ID.","operationId":"get_member","parameters":[{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Member"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/members/{memberId}/discord":{"get":{"tags":["members"],"summary":"Get a Member's Discord ID","description":"Gets the Discord user ID of a member, so you can mention or DM them from your bot.","operationId":"discord_by_member","parameters":[{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_DiscordIdResponse"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/members/{memberId}/terminate":{"post":{"tags":["infractions"],"summary":"Terminate a Member","description":"Removes a member from your server and records a terminating infraction. This works exactly\nlike terminating them in the dashboard.","operationId":"terminate_member","parameters":[{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReasonRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CreatedInfraction"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/members/{memberId}/unsuspend":{"post":{"tags":["infractions"],"summary":"End a Suspension Early","description":"Ends a member's current suspension.","operationId":"unsuspend_member","parameters":[{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReasonRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Suspension"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The member is not suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/rate-limit":{"get":{"tags":["server"],"summary":"Get Your Rate Limit","description":"Gets your monthly request count. This request doesn't count towards the limit.","operationId":"rate_limit","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_RateLimitStatus"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/roles":{"get":{"tags":["roles"],"summary":"List Roles","description":"Lists the roles in your server.\n\nYou can order by `createdAt` (default), `priority` or `id`.","operationId":"list_roles","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Role"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/roles/{roleId}":{"get":{"tags":["roles"],"summary":"Get a Role","description":"Gets one role.","operationId":"get_role","parameters":[{"name":"roleId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Role"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/shift-types":{"get":{"tags":["shifts"],"summary":"List Shift Types","description":"Lists your server's shift types.\n\nYou can order by `createdAt` (default) or `id`.","operationId":"list_shift_types","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_ShiftType"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/shift-types/{typeId}":{"get":{"tags":["shifts"],"summary":"Get a Shift Type","description":"Gets one shift type.","operationId":"get_shift_type","parameters":[{"name":"typeId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_ShiftType"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/shifts":{"get":{"tags":["shifts"],"summary":"List Shifts","description":"Lists your server's shifts, newest first. Use `active=true` to see who's on shift right now.\n\nYou can order by `createdAt` (default), `endedAt` or `id`.","operationId":"list_shifts","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}},{"name":"active","in":"query","description":"`true` for shifts in progress, `false` for ended shifts.","required":false,"schema":{"type":"boolean"}},{"name":"type","in":"query","description":"Only shifts of this shift type ID.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["shifts"],"summary":"Start a Shift","description":"Starts a shift as `memberId`, exactly as if they clicked Start Shift. Your server's shift\nrules apply, such as the most members on shift at once, shift type role requirements and\nin-game requirements.","operationId":"start_shift","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartShiftRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"The member cannot start this shift type","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The member already has an active shift","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/shifts/completed":{"post":{"tags":["shifts"],"summary":"Record a Past Shift","description":"Adds a shift that already happened, such as one a member forgot to start. `performedBy`\nneeds the Manage Shifts permission. The shift counts towards the current activity wave.","operationId":"record_shift","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordShiftRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/shifts/user/{memberId}":{"get":{"tags":["shifts"],"summary":"List a Member's Shifts","description":"Lists one member's shifts. Add `active=true` to check whether they're on shift.\n\nYou can order by `createdAt` (default), `endedAt` or `id`.","operationId":"member_shifts","parameters":[{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}},{"name":"active","in":"query","description":"`true` for shifts in progress, `false` for ended shifts.","required":false,"schema":{"type":"boolean"}},{"name":"type","in":"query","description":"Only shifts of this shift type ID.","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/shifts/{shiftId}":{"get":{"tags":["shifts"],"summary":"Get a Shift","description":"Gets one shift.","operationId":"get_shift","parameters":[{"name":"shiftId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"delete":{"tags":["shifts"],"summary":"Delete a Shift","description":"Deletes a shift as `performedBy`, who needs the Manage Shifts permission. This can't be\nundone.","operationId":"delete_shift","parameters":[{"name":"shiftId","in":"path","required":true,"schema":{"type":"string"}},{"name":"performedBy","in":"query","description":"Member ID of the staff member performing the delete, with their permissions.","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"patch":{"tags":["shifts"],"summary":"Edit a Shift","description":"Changes an ended shift's start, end or type. Send only what you want to change. Active\nshifts can't be edited, so end them first.","operationId":"edit_shift","parameters":[{"name":"shiftId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EditShiftRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The shift is still active","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/shifts/{shiftId}/breaks":{"post":{"tags":["shifts"],"summary":"Start a Break","description":"Starts a break on an active shift. Only the member on shift can start their own break, so\nsend no body.","operationId":"start_break","parameters":[{"name":"shiftId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Optional","content":{"application/json":{"schema":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ActionRequest"}]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Shift ended or already on break","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/shifts/{shiftId}/breaks/end":{"post":{"tags":["shifts"],"summary":"End a Break","description":"Ends the break in progress. Send `performedBy` to end someone else's break.","operationId":"end_break","parameters":[{"name":"shiftId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Optional","content":{"application/json":{"schema":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ActionRequest"}]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Shift ended or not on break","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/shifts/{shiftId}/end":{"post":{"tags":["shifts"],"summary":"End a Shift","description":"Ends an active shift, along with any break in progress.\n\nWith no body, the member ends their own shift. To end someone else's shift, send\n`performedBy`. They need the Manage Shifts permission and must outrank the member.","operationId":"end_shift","parameters":[{"name":"shiftId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"description":"Optional","content":{"application/json":{"schema":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/ActionRequest"}]}}}},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Shift"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Shift already ended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/suspensions":{"get":{"tags":["infractions"],"summary":"List Suspensions","description":"Lists your server's suspensions, newest first.\n\nYou can order by `startedAt` (default), `endAt` or `id`.","operationId":"list_suspensions","parameters":[{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Suspension"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["infractions"],"summary":"Suspend a Member","description":"Suspends a member as `issuedBy`. Leave out `endAt` for a suspension with no end date.","operationId":"suspend_member","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateSuspensionRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CreatedSuspension"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"The member is already suspended","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/suspensions/user/{memberId}":{"get":{"tags":["infractions"],"summary":"List a Member's Suspensions","description":"Lists one member's suspensions.\n\nYou can order by `startedAt` (default), `endAt` or `id`.","operationId":"member_suspensions","parameters":[{"name":"memberId","in":"path","required":true,"schema":{"type":"string"}},{"name":"page","in":"query","description":"1-based page number. Defaults to 1.","required":false,"schema":{"type":"integer","format":"int64","default":1,"minimum":1}},{"name":"pageSize","in":"query","description":"Items per page, clamped to 1-100. Defaults to 10.","required":false,"schema":{"type":"integer","format":"int64","default":10,"maximum":100,"minimum":1}},{"name":"orderBy","in":"query","description":"Field to sort by. See the endpoint description for the accepted values.","required":false,"schema":{"type":"string"}},{"name":"sort","in":"query","description":"Sort direction. Defaults to `desc`.","required":false,"schema":{"type":"string","description":"Sort direction.","enum":["asc","desc"]}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_Suspension"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/suspensions/{suspensionId}":{"get":{"tags":["infractions"],"summary":"Get a Suspension","description":"Gets one suspension.","operationId":"get_suspension","parameters":[{"name":"suspensionId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Suspension"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/server/suspensions/{suspensionId}/void":{"post":{"tags":["infractions"],"summary":"Void a Suspension","description":"Voids a suspension so its points no longer count.","operationId":"void_suspension","parameters":[{"name":"suspensionId","in":"path","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReasonRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Suspension"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Already voided","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"next did not confirm the write. Check whether it applied before retrying.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Write endpoints are not configured on this deployment","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/tokens":{"get":{"tags":["tokens"],"summary":"List Tokens","description":"Lists all of your server's tokens.","operationId":"list_tokens","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Vec_ServerToken"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"post":{"tags":["tokens"],"summary":"Create a Token","description":"Creates a token. A new token can never outlive the token used to create it, and a server can\nhave up to 25 active tokens.\n\nTreat tokens like passwords. Anyone with one can act as your server's staff through the API.","operationId":"create_token","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateTokenRequest"}}},"required":true},"responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_CreatedToken"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Name taken or active token limit reached","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/tokens/current":{"get":{"tags":["tokens"],"summary":"Get the Current Token","description":"Gets the token making the request.","operationId":"current_token","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_TokenInfo"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/tokens/{tokenId}":{"delete":{"tags":["tokens"],"summary":"Deactivate a Token","description":"Deactivates a token so it stops working straight away. You can deactivate the token making\nthe request.","operationId":"deactivate_token","parameters":[{"name":"tokenId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_ServerToken"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/verification/discord/{discordId}/roblox":{"get":{"tags":["verification"],"summary":"Get a Roblox Account From Discord","description":"Gets the Roblox account linked to a Discord user.","operationId":"roblox_by_discord","parameters":[{"name":"discordId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_RobloxConnection"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/v1/verification/roblox/{robloxId}/discord":{"get":{"tags":["verification"],"summary":"Get a Discord Account From Roblox","description":"Gets the Discord account linked to a Roblox user. If several Melonly users have linked the\nsame Roblox account, you get the one linked most recently.","operationId":"discord_by_roblox","parameters":[{"name":"robloxId","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Data_Account"}}}},"400":{"description":"Invalid request. `validation_failed` lists each invalid field in `details.fields`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"401":{"description":"Missing, invalid or expired token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limited. See `Retry-After` and `details`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"500":{"description":"Internal server error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/health":{"get":{"tags":["health"],"summary":"Plain-text health check of the database and Redis.","operationId":"health","responses":{"200":{"description":"Success","content":{"text/plain":{"schema":{"type":"string"}}}},"503":{"description":"Success","content":{"text/plain":{"schema":{"type":"string"}}}}},"security":[{}]}},"/livez":{"get":{"tags":["health"],"summary":"Liveness probe.","operationId":"livez","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LiveStatus"}}}}},"security":[{}]}},"/metrics":{"get":{"tags":["health"],"summary":"Basic runtime metrics.","operationId":"metrics","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Metrics"}}}}},"security":[{}]}},"/readyz":{"get":{"tags":["health"],"summary":"Readiness probe.","operationId":"readyz","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadyStatus"}}}},"503":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReadyStatus"}}}}},"security":[{}]}}},"components":{"schemas":{"Account":{"type":"object","required":["providerAccountId"],"properties":{"providerAccountId":{"type":"string","description":"Discord user ID."},"userId":{"type":["string","null"],"description":"Melonly user ID."}},"example":{"providerAccountId":"1043254628961792060","userId":"7308965405773533184"}},"ActionRequest":{"type":"object","properties":{"performedBy":{"type":["string","null"],"description":"Member ID of a staff member acting on someone else's shift or LOA. Leave it out to act\nas the owner."}},"additionalProperties":false,"example":{"performedBy":"7264722635089514496"}},"ActorRequest":{"type":"object","required":["performedBy"],"properties":{"performedBy":{"type":"string","description":"Member ID of the staff member doing this."}},"additionalProperties":false,"example":{"performedBy":"7264722635089514496"}},"Application":{"type":"object","required":["id","serverId","title","createdAt","acceptingResponses","questions","description","sections","banAppealNote"],"properties":{"acceptanceRemoveRoles":{"type":["object","null"],"description":"Discord roles removed when approved."},"acceptingResponses":{"type":"boolean","description":"Whether the form is open."},"allowMultipleSubmissions":{"type":["boolean","null"],"description":"Whether people can submit more than once."},"appealCooldown":{"type":["integer","null"],"format":"int32","description":"Days between ban appeals."},"approvalRoles":{"type":["object","null"],"description":"Discord roles given when approved."},"banAppealNote":{"type":"boolean","description":"Whether ban appeals show the ban log to reviewers."},"bannerKey":{"type":["string","null"],"description":"Banner image key."},"blockedDiscordRoles":{"type":["object","null"],"description":"Discord roles that can't apply."},"closedMessage":{"type":["string","null"],"description":"Message shown while the form is closed."},"collectRobloxAccount":{"type":["boolean","null"],"description":"Whether the applicant's Roblox account is collected."},"color":{"type":["string","null"],"description":"Hex colour."},"cooldown":{"type":["integer","null"],"format":"int32","description":"Hours before someone can apply again."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"defaultQuestionPointValue":{"type":["integer","null"],"format":"int32","description":"Default points per quiz question."},"denialRemoveRoles":{"type":["object","null"],"description":"Discord roles removed when denied."},"denialRoles":{"type":["object","null"],"description":"Discord roles given when denied."},"description":{"type":"string","description":"Form description."},"eventsChannelId":{"type":["string","null"],"description":"Discord channel for new submissions."},"folderId":{"type":["string","null"],"description":"Folder the form is in."},"giveRolesOnApproval":{"type":["object","null"],"description":"Melonly roles given when approved."},"guildMemberAge":{"type":["integer","null"],"format":"int32","description":"Days applicants must have been in your Discord server."},"id":{"type":"string","description":"Unique ID."},"inviteOnApproval":{"type":["boolean","null"],"description":"Whether approved applicants are invited to the server."},"lastUpdated":{"type":["integer","null"],"format":"int64","description":"When the form was last edited."},"maxLogs":{"type":["integer","null"],"format":"int32","description":"Most punishment logs an applicant can have."},"orgType":{"type":["string","null"],"description":"Whether it belongs to a server or a department."},"presets":{"type":["object","null"],"description":"Saved reviewer reasons."},"questions":{"type":"object","description":"The form's questions."},"quiz":{"type":["boolean","null"],"description":"Whether the form is a quiz."},"quizAutoAcceptThreshold":{"type":["integer","null"],"format":"int32","description":"Quiz score that approves automatically."},"quizAutoDenyThreshold":{"type":["integer","null"],"format":"int32","description":"Quiz score that denies automatically."},"quizReleaseType":{"type":["integer","null"],"format":"int32","description":"When quiz scores are released."},"requireApprovedReason":{"type":["boolean","null"],"description":"Whether reviewers must give a reason to approve."},"requireDiscordMember":{"type":["boolean","null"],"description":"Whether applicants must be in your Discord server."},"requiredDenialReason":{"type":["boolean","null"],"description":"Whether reviewers must give a reason to deny."},"requiredDiscordRoles":{"type":["object","null"],"description":"Discord roles applicants must have."},"resultsChannelId":{"type":["string","null"],"description":"Discord channel for results."},"resultsMentionUser":{"type":["boolean","null"],"description":"Whether results mention the applicant."},"revealReviewer":{"type":["boolean","null"],"description":"Whether applicants see who reviewed them."},"reviewOnlyRoles":{"type":["object","null"],"description":"Roles that can review but not edit the form."},"reviewerRoles":{"type":["object","null"],"description":"Roles that can review responses."},"robloxGroupId":{"type":["string","null"],"description":"Roblox group applicants must be in."},"sections":{"type":"object","description":"The form's sections."},"sendResponses":{"type":["boolean","null"],"description":"Whether applicants get a copy of their answers."},"serverId":{"type":"string","description":"Server ID, or department ID for department forms."},"sharing":{"type":["string","null"],"description":"Who else the form is shared with."},"slug":{"type":["string","null"],"description":"Short link slug."},"stageResponses":{"type":["boolean","null"],"description":"Whether decisions are staged before they're finalized."},"submissionMessage":{"type":["string","null"],"description":"Message shown after submitting."},"submitMentionRoles":{"type":["object","null"],"description":"Discord roles mentioned on new submissions."},"title":{"type":"string","description":"Form title."},"type":{"type":["integer","null"],"format":"int32","description":"Form type."}},"example":{"acceptingResponses":true,"banAppealNote":false,"createdAt":1794776859830,"description":"please read the rules before applying","id":"7400100000000000000","questions":{},"sections":[],"serverId":"7294057520392310784","title":"Game Moderator Application","type":0}},"ApplicationResponse":{"type":"object","required":["id","applicationId","createdAt","answers","userId","status"],"properties":{"answers":{"type":"object","description":"The applicant's answers."},"applicationId":{"type":"string","description":"Application ID."},"comments":{"type":["object","null"],"description":"Reviewer comments."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"finalizedAt":{"type":["integer","null"],"format":"int64","description":"When a staged decision was finalized."},"finalizedBy":{"type":["string","null"],"description":"Member ID of who finalized it."},"flagged":{"type":["object","null"],"description":"Flag details, if a reviewer flagged it."},"id":{"type":"string","description":"Unique ID."},"reason":{"type":["string","null"],"description":"The reviewer's reason."},"reviewedAt":{"type":["integer","null"],"format":"int64","description":"When it was reviewed."},"reviewedBy":{"type":["string","null"],"description":"Member ID of the reviewer."},"robloxId":{"type":["string","null"],"description":"Roblox user ID of the applicant."},"scoreReleased":{"type":["object","null"],"description":"Whether quiz scores have been released."},"scoring":{"type":["object","null"],"description":"Quiz scores."},"sectionsSorted":{"type":["object","null"],"description":"Section order the applicant saw."},"stagingStatus":{"type":["integer","null"],"format":"int32","description":"Staged decision, before it's finalized."},"status":{"type":"integer","format":"int32","description":"0 Pending, 1 Staged, 2 Approved, 3 Denied."},"userId":{"type":"string","description":"Melonly user ID of the applicant."}},"example":{"answers":{"q1":"i have 4 years of experience moderating my little brother"},"applicationId":"7400100000000000000","comments":{},"createdAt":1794776859830,"finalizedAt":0,"flagged":{},"id":"7400200000000000000","reason":"missed briefing, said his wifi died","reviewedAt":0,"reviewedBy":"7264722635089514496","robloxId":"156","scoreReleased":{},"scoring":{},"sectionsSorted":{},"stagingStatus":0,"status":0,"userId":"7308965405773533184"}},"AuditLogEvent":{"type":"object","required":["id","serverId","timestamp","userId"],"properties":{"applicationId":{"type":["string","null"],"description":"Application the event relates to."},"description":{"type":["object","null"],"description":"What happened, as `{ label, further }`."},"id":{"type":"string","description":"Unique ID."},"serverId":{"type":"string","description":"Server ID, or department ID for department events."},"timestamp":{"type":"integer","format":"int64","description":"When it happened."},"type":{"type":["integer","null"],"format":"int32","description":"Event type."},"userId":{"type":"string","description":"Member ID of who did it, or `SYSTEM`."}},"example":{"description":{"further":["For a duration of 1 hour"],"label":"Created shift for Builderman"},"id":"7527833441069436928","serverId":"7294057520392310784","timestamp":1794776859830,"type":8,"userId":"7308965405773533184"}},"CadCall":{"type":"object","required":["id","serverId","type","createdByUserId","createdAt","status","units","title","description","records","panels","unitHistory"],"properties":{"address":{"type":["string","null"],"description":"Address."},"apiId":{"type":["string","null"],"description":"ID set by an integration that created the call."},"closedAt":{"type":["integer","null"],"format":"int64","description":"When the call was closed."},"code":{"type":["string","null"],"description":"Call code."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdByUnit":{"type":["object","null"],"description":"Unit that created the call."},"createdByUserId":{"type":"string","description":"Melonly user ID of who created the call."},"description":{"type":"string","description":"Longer description."},"id":{"type":"string","description":"Unique ID."},"loc":{"type":["object","null"],"description":"Map position."},"origin":{"type":["string","null"],"description":"Where the call came from."},"panels":{"type":"object","description":"Panels the call is shown on."},"postal":{"type":["string","null"],"description":"Postal code."},"primaryUnit":{"type":["object","null"],"description":"Unit leading the call."},"priority":{"type":["string","null"],"description":"Call priority."},"records":{"type":"object","description":"Records attached."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"title":{"type":"string","description":"Title."},"type":{"type":"integer","format":"int32","description":"Type code."},"unitHistory":{"type":"object","description":"Units that have been on the call."},"units":{"type":"object","description":"Units attached."}},"example":{"address":"Highway 1","closedAt":0,"code":"10-80","createdAt":1794776859830,"createdByUnit":{},"createdByUserId":"7308965405773533184","description":"red prancer fled a traffic stop. driver waved at us","id":"7527000000000000000","loc":{},"origin":"911","panels":[],"postal":"214","primaryUnit":{},"priority":"2","records":[],"serverId":"7294057520392310784","status":0,"title":"10-80 on a Bullhorn Prancer","type":0,"unitHistory":[],"units":[]}},"CadCallNote":{"type":"object","required":["id","serverId","callId","createdByUserId","createdByUnit","createdAt","type","data"],"properties":{"callId":{"type":"string","description":"Call ID."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdByUnit":{"type":"object","description":"Unit that wrote the note."},"createdByUserId":{"type":"string","description":"Melonly user ID of who wrote the note."},"data":{"type":"object","description":"Note contents."},"id":{"type":"string","description":"Unique ID."},"mergedFrom":{"type":["string","null"],"description":"Call the note was merged from."},"serverId":{"type":"string","description":"Server ID."},"type":{"type":"integer","format":"int32","description":"Type code."}},"example":{"callId":"7527000000000000000","createdAt":1794776859830,"createdByUnit":{},"createdByUserId":"7308965405773533184","data":{"text":"suspect bailed. prancer is still rolling"},"id":"7527000000000000001","serverId":"7294057520392310784","type":0}},"CadCourtHearing":{"type":"object","required":["serverId","id","status","type","recordId","civId","createdAt"],"properties":{"civId":{"type":"string","description":"Civilian the hearing is for."},"closedAt":{"type":["integer","null"],"format":"int64","description":"When the hearing closed."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"id":{"type":"string","description":"Unique ID."},"processedBy":{"type":["string","null"],"description":"Who processed it."},"recordId":{"type":"string","description":"Record the hearing is for."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"type":{"type":"integer","format":"int32","description":"Type code."}},"example":{"civId":"7527000000000000004","closedAt":0,"createdAt":1794776859830,"id":"7527000000000000003","recordId":"7527000000000000002","serverId":"7294057520392310784","status":0,"type":0}},"CadRecord":{"type":"object","required":["id","serverId","createdByUserId","createdAt","type","label","data","templateId","previewData","flags","meta","status","objects"],"properties":{"agency":{"type":["object","null"],"description":"Agency that created it."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdByUnit":{"type":["object","null"],"description":"Unit that created the record."},"createdByUserId":{"type":"string","description":"Melonly user ID of who created the record."},"data":{"type":"object","description":"Record contents."},"flags":{"type":"object","description":"Flags set on the record."},"id":{"type":"string","description":"Unique ID."},"label":{"type":"string","description":"Record label."},"meta":{"type":"object","description":"Extra record metadata."},"noCharge":{"type":["boolean","null"],"description":"Whether charges were dropped."},"objects":{"type":"object","description":"People, vehicles and other objects in the record."},"previewData":{"type":"object","description":"Summary shown in lists."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"templateId":{"type":"integer","format":"int32","description":"Record template ID."},"type":{"type":"integer","format":"int32","description":"Type code."}},"example":{"agency":{},"createdAt":1794776859830,"createdByUnit":{},"createdByUserId":"7308965405773533184","data":{},"flags":[],"id":"7527000000000000002","label":"Citation","meta":{},"noCharge":false,"objects":[],"previewData":{},"serverId":"7294057520392310784","status":0,"templateId":1,"type":0}},"CadUnit":{"type":"object","required":["id","serverId","userId","status","panic","number","agency","loc","items"],"properties":{"agency":{"type":"string","description":"Agency."},"customStatusId":{"type":["string","null"],"description":"Custom status, when one is set."},"id":{"type":"integer","format":"int32","description":"Unit ID."},"items":{"type":"object","description":"Equipment carried."},"loc":{"type":"object","description":"Map position."},"location":{"type":["string","null"],"description":"Location text."},"name":{"type":["string","null"],"description":"Callsign name."},"number":{"type":"string","description":"Unit number, such as `1A-12`."},"panic":{"type":"boolean","description":"Whether panic is active."},"rank":{"type":["string","null"],"description":"Rank."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"subdivision":{"type":["string","null"],"description":"Subdivision."},"userId":{"type":"string","description":"Melonly user ID of who's on the unit."}},"example":{"agency":"LSSD","id":12,"items":[],"loc":{},"location":"Postal 214","name":"Builderman","number":"1A-12","panic":false,"rank":"Deputy","serverId":"7294057520392310784","status":1,"subdivision":"Patrol","userId":"7308965405773533184"}},"CadUnitGroup":{"type":"object","required":["id","serverId","name","units","status","panic","premade"],"properties":{"customStatusId":{"type":["string","null"],"description":"Custom status, when one is set."},"id":{"type":"integer","format":"int32","description":"Unit group ID."},"maxUnits":{"type":["integer","null"],"format":"int32","description":"Most units that can join."},"name":{"type":"string","description":"Display name."},"panic":{"type":"boolean","description":"Whether panic is active."},"premade":{"type":"boolean","description":"Whether it's a premade group."},"restrictAgency":{"type":["string","null"],"description":"Only this agency's units can join."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"units":{"type":"object","description":"Units attached."}},"example":{"id":3,"maxUnits":4,"name":"Adam 1","panic":false,"premade":true,"serverId":"7294057520392310784","status":1,"units":[]}},"CreateInfractionRequest":{"type":"object","required":["memberId","issuedBy","reason"],"properties":{"forceTerm":{"type":"boolean","description":"Terminate the member whatever their point total."},"guidelineId":{"type":["string","null"],"description":"Guideline to use, from your infraction settings."},"issuedBy":{"type":"string","description":"Member ID of the staff member issuing it."},"memberId":{"type":"string","description":"Member ID of the member receiving it."},"points":{"type":["number","null"],"format":"double","description":"Points, from 0 to 1000. Defaults to the guideline's points. Required without a\nguideline.","maximum":1000,"minimum":0},"reason":{"type":"string","description":"Reason, 4-1024 characters.","maxLength":1024,"minLength":4}},"additionalProperties":false,"example":{"guidelineId":"7375594080912281600","issuedBy":"7264722635089514496","memberId":"7308965405773533184","reason":"afk on shift for 40 minutes. said he was making soup"}},"CreateLoaRequest":{"type":"object","required":["memberId"],"properties":{"endAt":{"type":["integer","null"],"format":"int64","description":"When the leave ends."},"memberId":{"type":"string","description":"Member ID of the member taking leave."},"reason":{"type":["string","null"],"description":"Reason, up to 1024 characters. Some servers require one.","maxLength":1024},"startAt":{"type":["integer","null"],"format":"int64","description":"When the leave starts. Leave it out to start once approved."}},"additionalProperties":false,"example":{"endAt":1795400000000,"memberId":"7308965405773533184","reason":"my mom took my phone"}},"CreateLogRequest":{"type":"object","required":["type","username","text","createdBy"],"properties":{"createdBy":{"type":"string","description":"Member ID of the staff member creating the log."},"description":{"type":["string","null"],"description":"Extra details, up to 2048 characters. Needs premium.","maxLength":2048},"dontCount":{"type":"boolean","description":"Leave the log out of punishment counts."},"resetPunishmentsCount":{"type":"boolean","description":"Reset the player's punishment count. Notes only."},"tempBan":{"type":"boolean","description":"Make a ban temporary. Needs `unbanAt`."},"text":{"type":"string","description":"Reason, up to 2048 characters.","maxLength":2048,"minLength":1},"type":{"type":"integer","format":"int32","description":"Log type: `0` Warning, `1` Kick, `2` Ban, `3` Ban BOLO, `4` Note or `5` Custom. Your\ncustom types are listed by List Log Types.","maximum":5,"minimum":0},"typeId":{"type":["string","null"],"description":"Custom log type ID. Required when `type` is `5`."},"unbanAt":{"type":["integer","null"],"format":"int64","description":"When a temporary ban ends, up to a year away."},"username":{"type":"string","description":"Roblox username of the player, 3-20 letters, numbers or underscores.","maxLength":20,"minLength":3,"pattern":"^[A-Za-z0-9_]+$"}},"additionalProperties":false,"example":{"createdBy":"7264722635089514496","text":"vdm at gas station (again)","type":0,"username":"Builderman"}},"CreateSuspensionRequest":{"type":"object","required":["memberId","issuedBy","reason"],"properties":{"endAt":{"type":["integer","null"],"format":"int64","description":"When it ends, at least a day away. Leave it out for no end date."},"issuedBy":{"type":"string","description":"Member ID of the staff member suspending them."},"memberId":{"type":"string","description":"Member ID of the member being suspended."},"points":{"type":"number","format":"double","description":"Points, from 0 to 1000. Defaults to 0.","maximum":1000,"minimum":0},"reason":{"type":"string","description":"Reason, 4-1024 characters.","maxLength":1024,"minLength":4}},"additionalProperties":false,"example":{"endAt":1795381659830,"issuedBy":"7264722635089514496","memberId":"7308965405773533184","reason":"said \"trust me bro\" during a 10-80"}},"CreateTokenRequest":{"type":"object","required":["name"],"properties":{"expiresInDays":{"type":["integer","null"],"format":"int64","description":"Days until it expires, from 1 to 3650. Leave it out for no expiry.","maximum":3650,"minimum":1},"name":{"type":"string","description":"Token name, 1-50 characters. Must be unique among active tokens.","maxLength":50,"minLength":1}},"additionalProperties":false,"example":{"expiresInDays":90,"name":"shift bot (do not delete)"}},"CreatedInfraction":{"allOf":[{"$ref":"#/components/schemas/Infraction"},{"type":"object","required":["dmDisabled"],"properties":{"dmDisabled":{"type":"boolean","description":"Whether the member turned off infraction DMs."},"suspension":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Suspension","description":"Suspension started automatically because the member crossed a threshold."}]}}}],"example":{"dmDisabled":false,"editedBy":[],"expired":false,"guidelineId":"7375594080912281600","id":"7527833441069436928","issuedBy":"7264722635089514496","memberId":"7308965405773533184","points":2,"proof":[],"serverId":"7294057520392310784","term":false,"text":"afk on shift for 40 minutes. said he was making soup","timestamp":1794776859830,"voided":false}},"CreatedLog":{"allOf":[{"$ref":"#/components/schemas/Log"},{"type":"object","required":["banBoloCreated","dmDisabled"],"properties":{"banBoloCreated":{"type":"boolean","description":"Whether this log pushed the player over the automatic ban BOLO threshold."},"dmDisabled":{"type":"boolean","description":"Whether the player turned off moderation DMs."}}}],"example":{"banBoloCreated":false,"createdAt":1794776859830,"createdBy":"7264722635089514496","dmDisabled":false,"dontCount":false,"editedBy":[],"expired":false,"id":"7527833441069436928","proof":[],"robloxId":"156","serverId":"7294057520392310784","text":"vdm at gas station (again)","type":0,"username":"Builderman"}},"CreatedSuspension":{"allOf":[{"$ref":"#/components/schemas/Suspension"},{"type":"object","required":["dmDisabled"],"properties":{"dmDisabled":{"type":"boolean","description":"Whether the member turned off infraction DMs."}}}],"example":{"dmDisabled":false,"endAt":1795381659830,"expired":false,"id":"7527700000000000000","memberId":"7308965405773533184","points":0,"reason":"said \"trust me bro\" during a 10-80","serverId":"7294057520392310784","startedAt":1794776859830,"startedBy":"7264722635089514496","voided":false}},"CreatedToken":{"allOf":[{"$ref":"#/components/schemas/ServerToken"},{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"The bearer secret. Store it now; it cannot be retrieved again."}}}],"example":{"createdAt":1794700000000,"id":"7527840000000004096","isActive":true,"lastUsedAt":1794776859830,"name":"shift bot (do not delete)","serverId":"7294057520392310784","token":"9f2c4e7a1b3d5f60718293a4b5c6d7e8f9a0b1c2d3e4f5061728394a5b6c7d8e"}},"Data_Account":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["providerAccountId"],"properties":{"providerAccountId":{"type":"string","description":"Discord user ID."},"userId":{"type":["string","null"],"description":"Melonly user ID."}},"example":{"providerAccountId":"1043254628961792060","userId":"7308965405773533184"}}}},"Data_Application":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","title","createdAt","acceptingResponses","questions","description","sections","banAppealNote"],"properties":{"acceptanceRemoveRoles":{"type":["object","null"],"description":"Discord roles removed when approved."},"acceptingResponses":{"type":"boolean","description":"Whether the form is open."},"allowMultipleSubmissions":{"type":["boolean","null"],"description":"Whether people can submit more than once."},"appealCooldown":{"type":["integer","null"],"format":"int32","description":"Days between ban appeals."},"approvalRoles":{"type":["object","null"],"description":"Discord roles given when approved."},"banAppealNote":{"type":"boolean","description":"Whether ban appeals show the ban log to reviewers."},"bannerKey":{"type":["string","null"],"description":"Banner image key."},"blockedDiscordRoles":{"type":["object","null"],"description":"Discord roles that can't apply."},"closedMessage":{"type":["string","null"],"description":"Message shown while the form is closed."},"collectRobloxAccount":{"type":["boolean","null"],"description":"Whether the applicant's Roblox account is collected."},"color":{"type":["string","null"],"description":"Hex colour."},"cooldown":{"type":["integer","null"],"format":"int32","description":"Hours before someone can apply again."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"defaultQuestionPointValue":{"type":["integer","null"],"format":"int32","description":"Default points per quiz question."},"denialRemoveRoles":{"type":["object","null"],"description":"Discord roles removed when denied."},"denialRoles":{"type":["object","null"],"description":"Discord roles given when denied."},"description":{"type":"string","description":"Form description."},"eventsChannelId":{"type":["string","null"],"description":"Discord channel for new submissions."},"folderId":{"type":["string","null"],"description":"Folder the form is in."},"giveRolesOnApproval":{"type":["object","null"],"description":"Melonly roles given when approved."},"guildMemberAge":{"type":["integer","null"],"format":"int32","description":"Days applicants must have been in your Discord server."},"id":{"type":"string","description":"Unique ID."},"inviteOnApproval":{"type":["boolean","null"],"description":"Whether approved applicants are invited to the server."},"lastUpdated":{"type":["integer","null"],"format":"int64","description":"When the form was last edited."},"maxLogs":{"type":["integer","null"],"format":"int32","description":"Most punishment logs an applicant can have."},"orgType":{"type":["string","null"],"description":"Whether it belongs to a server or a department."},"presets":{"type":["object","null"],"description":"Saved reviewer reasons."},"questions":{"type":"object","description":"The form's questions."},"quiz":{"type":["boolean","null"],"description":"Whether the form is a quiz."},"quizAutoAcceptThreshold":{"type":["integer","null"],"format":"int32","description":"Quiz score that approves automatically."},"quizAutoDenyThreshold":{"type":["integer","null"],"format":"int32","description":"Quiz score that denies automatically."},"quizReleaseType":{"type":["integer","null"],"format":"int32","description":"When quiz scores are released."},"requireApprovedReason":{"type":["boolean","null"],"description":"Whether reviewers must give a reason to approve."},"requireDiscordMember":{"type":["boolean","null"],"description":"Whether applicants must be in your Discord server."},"requiredDenialReason":{"type":["boolean","null"],"description":"Whether reviewers must give a reason to deny."},"requiredDiscordRoles":{"type":["object","null"],"description":"Discord roles applicants must have."},"resultsChannelId":{"type":["string","null"],"description":"Discord channel for results."},"resultsMentionUser":{"type":["boolean","null"],"description":"Whether results mention the applicant."},"revealReviewer":{"type":["boolean","null"],"description":"Whether applicants see who reviewed them."},"reviewOnlyRoles":{"type":["object","null"],"description":"Roles that can review but not edit the form."},"reviewerRoles":{"type":["object","null"],"description":"Roles that can review responses."},"robloxGroupId":{"type":["string","null"],"description":"Roblox group applicants must be in."},"sections":{"type":"object","description":"The form's sections."},"sendResponses":{"type":["boolean","null"],"description":"Whether applicants get a copy of their answers."},"serverId":{"type":"string","description":"Server ID, or department ID for department forms."},"sharing":{"type":["string","null"],"description":"Who else the form is shared with."},"slug":{"type":["string","null"],"description":"Short link slug."},"stageResponses":{"type":["boolean","null"],"description":"Whether decisions are staged before they're finalized."},"submissionMessage":{"type":["string","null"],"description":"Message shown after submitting."},"submitMentionRoles":{"type":["object","null"],"description":"Discord roles mentioned on new submissions."},"title":{"type":"string","description":"Form title."},"type":{"type":["integer","null"],"format":"int32","description":"Form type."}},"example":{"acceptingResponses":true,"banAppealNote":false,"createdAt":1794776859830,"description":"please read the rules before applying","id":"7400100000000000000","questions":{},"sections":[],"serverId":"7294057520392310784","title":"Game Moderator Application","type":0}}}},"Data_ApplicationResponse":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","applicationId","createdAt","answers","userId","status"],"properties":{"answers":{"type":"object","description":"The applicant's answers."},"applicationId":{"type":"string","description":"Application ID."},"comments":{"type":["object","null"],"description":"Reviewer comments."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"finalizedAt":{"type":["integer","null"],"format":"int64","description":"When a staged decision was finalized."},"finalizedBy":{"type":["string","null"],"description":"Member ID of who finalized it."},"flagged":{"type":["object","null"],"description":"Flag details, if a reviewer flagged it."},"id":{"type":"string","description":"Unique ID."},"reason":{"type":["string","null"],"description":"The reviewer's reason."},"reviewedAt":{"type":["integer","null"],"format":"int64","description":"When it was reviewed."},"reviewedBy":{"type":["string","null"],"description":"Member ID of the reviewer."},"robloxId":{"type":["string","null"],"description":"Roblox user ID of the applicant."},"scoreReleased":{"type":["object","null"],"description":"Whether quiz scores have been released."},"scoring":{"type":["object","null"],"description":"Quiz scores."},"sectionsSorted":{"type":["object","null"],"description":"Section order the applicant saw."},"stagingStatus":{"type":["integer","null"],"format":"int32","description":"Staged decision, before it's finalized."},"status":{"type":"integer","format":"int32","description":"0 Pending, 1 Staged, 2 Approved, 3 Denied."},"userId":{"type":"string","description":"Melonly user ID of the applicant."}},"example":{"answers":{"q1":"i have 4 years of experience moderating my little brother"},"applicationId":"7400100000000000000","comments":{},"createdAt":1794776859830,"finalizedAt":0,"flagged":{},"id":"7400200000000000000","reason":"missed briefing, said his wifi died","reviewedAt":0,"reviewedBy":"7264722635089514496","robloxId":"156","scoreReleased":{},"scoring":{},"sectionsSorted":{},"stagingStatus":0,"status":0,"userId":"7308965405773533184"}}}},"Data_CadCall":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","type","createdByUserId","createdAt","status","units","title","description","records","panels","unitHistory"],"properties":{"address":{"type":["string","null"],"description":"Address."},"apiId":{"type":["string","null"],"description":"ID set by an integration that created the call."},"closedAt":{"type":["integer","null"],"format":"int64","description":"When the call was closed."},"code":{"type":["string","null"],"description":"Call code."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdByUnit":{"type":["object","null"],"description":"Unit that created the call."},"createdByUserId":{"type":"string","description":"Melonly user ID of who created the call."},"description":{"type":"string","description":"Longer description."},"id":{"type":"string","description":"Unique ID."},"loc":{"type":["object","null"],"description":"Map position."},"origin":{"type":["string","null"],"description":"Where the call came from."},"panels":{"type":"object","description":"Panels the call is shown on."},"postal":{"type":["string","null"],"description":"Postal code."},"primaryUnit":{"type":["object","null"],"description":"Unit leading the call."},"priority":{"type":["string","null"],"description":"Call priority."},"records":{"type":"object","description":"Records attached."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"title":{"type":"string","description":"Title."},"type":{"type":"integer","format":"int32","description":"Type code."},"unitHistory":{"type":"object","description":"Units that have been on the call."},"units":{"type":"object","description":"Units attached."}},"example":{"address":"Highway 1","closedAt":0,"code":"10-80","createdAt":1794776859830,"createdByUnit":{},"createdByUserId":"7308965405773533184","description":"red prancer fled a traffic stop. driver waved at us","id":"7527000000000000000","loc":{},"origin":"911","panels":[],"postal":"214","primaryUnit":{},"priority":"2","records":[],"serverId":"7294057520392310784","status":0,"title":"10-80 on a Bullhorn Prancer","type":0,"unitHistory":[],"units":[]}}}},"Data_CadCallNote":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","callId","createdByUserId","createdByUnit","createdAt","type","data"],"properties":{"callId":{"type":"string","description":"Call ID."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdByUnit":{"type":"object","description":"Unit that wrote the note."},"createdByUserId":{"type":"string","description":"Melonly user ID of who wrote the note."},"data":{"type":"object","description":"Note contents."},"id":{"type":"string","description":"Unique ID."},"mergedFrom":{"type":["string","null"],"description":"Call the note was merged from."},"serverId":{"type":"string","description":"Server ID."},"type":{"type":"integer","format":"int32","description":"Type code."}},"example":{"callId":"7527000000000000000","createdAt":1794776859830,"createdByUnit":{},"createdByUserId":"7308965405773533184","data":{"text":"suspect bailed. prancer is still rolling"},"id":"7527000000000000001","serverId":"7294057520392310784","type":0}}}},"Data_CadCourtHearing":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["serverId","id","status","type","recordId","civId","createdAt"],"properties":{"civId":{"type":"string","description":"Civilian the hearing is for."},"closedAt":{"type":["integer","null"],"format":"int64","description":"When the hearing closed."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"id":{"type":"string","description":"Unique ID."},"processedBy":{"type":["string","null"],"description":"Who processed it."},"recordId":{"type":"string","description":"Record the hearing is for."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"type":{"type":"integer","format":"int32","description":"Type code."}},"example":{"civId":"7527000000000000004","closedAt":0,"createdAt":1794776859830,"id":"7527000000000000003","recordId":"7527000000000000002","serverId":"7294057520392310784","status":0,"type":0}}}},"Data_CadRecord":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","createdByUserId","createdAt","type","label","data","templateId","previewData","flags","meta","status","objects"],"properties":{"agency":{"type":["object","null"],"description":"Agency that created it."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdByUnit":{"type":["object","null"],"description":"Unit that created the record."},"createdByUserId":{"type":"string","description":"Melonly user ID of who created the record."},"data":{"type":"object","description":"Record contents."},"flags":{"type":"object","description":"Flags set on the record."},"id":{"type":"string","description":"Unique ID."},"label":{"type":"string","description":"Record label."},"meta":{"type":"object","description":"Extra record metadata."},"noCharge":{"type":["boolean","null"],"description":"Whether charges were dropped."},"objects":{"type":"object","description":"People, vehicles and other objects in the record."},"previewData":{"type":"object","description":"Summary shown in lists."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"templateId":{"type":"integer","format":"int32","description":"Record template ID."},"type":{"type":"integer","format":"int32","description":"Type code."}},"example":{"agency":{},"createdAt":1794776859830,"createdByUnit":{},"createdByUserId":"7308965405773533184","data":{},"flags":[],"id":"7527000000000000002","label":"Citation","meta":{},"noCharge":false,"objects":[],"previewData":{},"serverId":"7294057520392310784","status":0,"templateId":1,"type":0}}}},"Data_CadUnit":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","userId","status","panic","number","agency","loc","items"],"properties":{"agency":{"type":"string","description":"Agency."},"customStatusId":{"type":["string","null"],"description":"Custom status, when one is set."},"id":{"type":"integer","format":"int32","description":"Unit ID."},"items":{"type":"object","description":"Equipment carried."},"loc":{"type":"object","description":"Map position."},"location":{"type":["string","null"],"description":"Location text."},"name":{"type":["string","null"],"description":"Callsign name."},"number":{"type":"string","description":"Unit number, such as `1A-12`."},"panic":{"type":"boolean","description":"Whether panic is active."},"rank":{"type":["string","null"],"description":"Rank."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"subdivision":{"type":["string","null"],"description":"Subdivision."},"userId":{"type":"string","description":"Melonly user ID of who's on the unit."}},"example":{"agency":"LSSD","id":12,"items":[],"loc":{},"location":"Postal 214","name":"Builderman","number":"1A-12","panic":false,"rank":"Deputy","serverId":"7294057520392310784","status":1,"subdivision":"Patrol","userId":"7308965405773533184"}}}},"Data_CadUnitGroup":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","name","units","status","panic","premade"],"properties":{"customStatusId":{"type":["string","null"],"description":"Custom status, when one is set."},"id":{"type":"integer","format":"int32","description":"Unit group ID."},"maxUnits":{"type":["integer","null"],"format":"int32","description":"Most units that can join."},"name":{"type":"string","description":"Display name."},"panic":{"type":"boolean","description":"Whether panic is active."},"premade":{"type":"boolean","description":"Whether it's a premade group."},"restrictAgency":{"type":["string","null"],"description":"Only this agency's units can join."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"units":{"type":"object","description":"Units attached."}},"example":{"id":3,"maxUnits":4,"name":"Adam 1","panic":false,"premade":true,"serverId":"7294057520392310784","status":1,"units":[]}}}},"Data_CreatedInfraction":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"allOf":[{"$ref":"#/components/schemas/Infraction"},{"type":"object","required":["dmDisabled"],"properties":{"dmDisabled":{"type":"boolean","description":"Whether the member turned off infraction DMs."},"suspension":{"oneOf":[{"type":"null"},{"$ref":"#/components/schemas/Suspension","description":"Suspension started automatically because the member crossed a threshold."}]}}}],"example":{"dmDisabled":false,"editedBy":[],"expired":false,"guidelineId":"7375594080912281600","id":"7527833441069436928","issuedBy":"7264722635089514496","memberId":"7308965405773533184","points":2,"proof":[],"serverId":"7294057520392310784","term":false,"text":"afk on shift for 40 minutes. said he was making soup","timestamp":1794776859830,"voided":false}}}},"Data_CreatedLog":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"allOf":[{"$ref":"#/components/schemas/Log"},{"type":"object","required":["banBoloCreated","dmDisabled"],"properties":{"banBoloCreated":{"type":"boolean","description":"Whether this log pushed the player over the automatic ban BOLO threshold."},"dmDisabled":{"type":"boolean","description":"Whether the player turned off moderation DMs."}}}],"example":{"banBoloCreated":false,"createdAt":1794776859830,"createdBy":"7264722635089514496","dmDisabled":false,"dontCount":false,"editedBy":[],"expired":false,"id":"7527833441069436928","proof":[],"robloxId":"156","serverId":"7294057520392310784","text":"vdm at gas station (again)","type":0,"username":"Builderman"}}}},"Data_CreatedSuspension":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"allOf":[{"$ref":"#/components/schemas/Suspension"},{"type":"object","required":["dmDisabled"],"properties":{"dmDisabled":{"type":"boolean","description":"Whether the member turned off infraction DMs."}}}],"example":{"dmDisabled":false,"endAt":1795381659830,"expired":false,"id":"7527700000000000000","memberId":"7308965405773533184","points":0,"reason":"said \"trust me bro\" during a 10-80","serverId":"7294057520392310784","startedAt":1794776859830,"startedBy":"7264722635089514496","voided":false}}}},"Data_CreatedToken":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"allOf":[{"$ref":"#/components/schemas/ServerToken"},{"type":"object","required":["token"],"properties":{"token":{"type":"string","description":"The bearer secret. Store it now; it cannot be retrieved again."}}}],"example":{"createdAt":1794700000000,"id":"7527840000000004096","isActive":true,"lastUsedAt":1794776859830,"name":"shift bot (do not delete)","serverId":"7294057520392310784","token":"9f2c4e7a1b3d5f60718293a4b5c6d7e8f9a0b1c2d3e4f5061728394a5b6c7d8e"}}}},"Data_Department":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","name","icon"],"properties":{"activated":{"type":["boolean","null"],"description":"Whether the department is active."},"discordGuildId":{"type":["string","null"],"description":"Discord server linked to the department."},"icon":{"type":"string","description":"Icon image URL."},"id":{"type":"string","description":"Unique ID."},"joinCode":{"type":["string","null"],"description":"Code members use to join."},"name":{"type":"string","description":"Department name."},"serverId":{"type":"string","description":"Server the department belongs to."},"type":{"type":["integer","null"],"format":"int32","description":"Department type."}},"example":{"activated":true,"icon":"https://cdn.melonly.com/icons/sheriff.png","id":"7392336585590575104","name":"Sheriff's Office (2 deputies)","serverId":"7294057520392310784","type":1}}}},"Data_DepartmentMember":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","departmentId","rankId","createdAt","rankPosition","customColumnValues","supportFlags","roles"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When they joined the department."},"customColumnValues":{"type":"array","items":{"type":"object"},"description":"Values for the department's custom roster columns."},"departmentId":{"type":"string","description":"Department ID."},"id":{"type":"string","description":"Unique ID."},"inactive":{"type":["boolean","null"],"description":"Whether they're currently flagged inactive."},"inactiveLastShift":{"type":["integer","null"],"format":"int64","description":"When their last shift ended, at the time they were flagged."},"inactiveSince":{"type":["integer","null"],"format":"int64","description":"When they were flagged inactive."},"rankId":{"type":"string","description":"ID of the member's rank."},"rankPosition":{"type":"integer","format":"int32","description":"Member's position within their rank."},"roles":{"type":"array","items":{"type":"string"},"description":"IDs of the department roles held."},"supportFlags":{"type":"array","items":{"type":"string"},"description":"Roster flags set on the member."}},"example":{"createdAt":1794776859830,"customColumnValues":[],"departmentId":"7392336585590575104","id":"7527833441069436928","inactive":false,"inactiveLastShift":0,"inactiveSince":0,"rankId":"7392336600000000000","rankPosition":2,"roles":[],"supportFlags":[]}}}},"Data_DepartmentRank":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","departmentId","name","permissions","position"],"properties":{"colour":{"type":["string","null"],"description":"Hex colour."},"departmentId":{"type":"string","description":"Department ID."},"id":{"type":"string","description":"Unique ID."},"linkedDiscordRoleId":{"type":["string","null"],"description":"Discord role kept in sync with this one."},"name":{"type":"string","description":"Rank name."},"permissions":{"type":"string","description":"Rank permission bitfield as a decimal string."},"position":{"type":"integer","format":"int32","description":"Order in the list. Lower comes first."}},"example":{"colour":"#11d982","departmentId":"7392336585590575104","id":"7392336600000000000","name":"Deputy Deputy","permissions":"0","position":3}}}},"Data_DiscordIdResponse":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["discordId"],"properties":{"discordId":{"type":"string","description":"Discord user ID."}},"example":{"discordId":"1043254628961792060"}}}},"Data_Infraction":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","memberId","timestamp","points","issuedBy","text","voided","expired","editedBy","proof"],"properties":{"editedBy":{"type":"array","items":{"type":"string"},"description":"Member IDs of everyone who edited it."},"expired":{"type":"boolean","description":"Whether it has expired."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"guidelineId":{"type":["string","null"],"description":"Guideline it was issued under."},"id":{"type":"string","description":"Unique ID."},"issuedBy":{"type":"string","description":"Member ID of who issued it."},"memberId":{"type":"string","description":"Member ID of the member who received it."},"points":{"type":"integer","format":"int64","description":"Points it carries."},"proof":{"type":"array","items":{"type":"string"},"description":"Proof file keys."},"serverId":{"type":"string","description":"Server ID."},"term":{"type":["boolean","null"],"description":"Whether it terminated the member."},"text":{"type":"string","description":"Reason."},"timestamp":{"type":"integer","format":"int64","description":"When it was issued."},"voidReason":{"type":["string","null"],"description":"Why it was voided."},"voided":{"type":"boolean","description":"Whether it has been voided."},"voidedBy":{"type":["string","null"],"description":"Member ID of who voided it."}},"example":{"editedBy":[],"expired":false,"guidelineId":"7375594080912281600","id":"7527833441069436928","issuedBy":"7264722635089514496","memberId":"7308965405773533184","points":2,"proof":[],"serverId":"7294057520392310784","term":false,"text":"afk on shift for 40 minutes. said he was making soup","timestamp":1794776859830,"voided":false}}}},"Data_InfractionSettings":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["guidelines","flowData","autoTerm"],"properties":{"autoTerm":{"type":"boolean","description":"Whether reaching the termination threshold removes the member automatically."},"expire":{"type":["boolean","null"],"description":"Whether infractions expire."},"expireDuration":{"type":["integer","null"],"format":"int32","description":"Days until infractions expire."},"flowData":{"type":"array","items":{"type":"array","items":{"type":"object"}},"description":"Point thresholds as `[action, points, label]`."},"guidelines":{"type":"object","description":"Guidelines by ID. Each has `name`, `shortDescription`, `description` and `points`."},"suspensionDuration":{"type":["integer","null"],"format":"int32","description":"Default suspension length in days."}},"example":{"autoTerm":false,"expire":true,"expireDuration":90,"flowData":[[0,2,"Warning"],[1,4,"Suspension"],[2,8,"Termination"]],"guidelines":{"7375594080912281600":{"id":"7375594080912281600","name":"Being AFK","points":2,"shortDescription":"Standing still for too long."}},"suspensionDuration":7}}}},"Data_JoinRequest":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["userId","serverId","joinCode","createdAt"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"joinCode":{"type":"string","description":"The join code they used."},"serverId":{"type":"string","description":"Server ID, or department ID for department join requests."},"userId":{"type":"string","description":"Melonly user ID of who asked to join."}},"example":{"createdAt":1794776859830,"joinCode":"liberty","serverId":"7294057520392310784","userId":"7308965405773533184"}}}},"Data_Loa":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","memberId","createdAt","status","startType","extensionRequests","reasonHistory"],"properties":{"approveReason":{"type":["string","null"],"description":"The reviewer's reason for approving it."},"cancelledAt":{"type":["integer","null"],"format":"int64","description":"When the member cancelled it."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"denyReason":{"type":["string","null"],"description":"The reviewer's reason for denying it."},"endAt":{"type":["integer","null"],"format":"int64","description":"When the leave is scheduled to end."},"endedAt":{"type":["integer","null"],"format":"int64","description":"When the leave actually ended."},"endedBy":{"type":["string","null"],"description":"Member ID of who ended it early."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"extensionRequests":{"type":"array","items":{"type":"object"},"description":"Requests to extend the leave."},"id":{"type":"string","description":"Unique ID."},"memberId":{"type":"string","description":"Member ID of the member on leave."},"reason":{"type":["string","null"],"description":"The member's reason."},"reasonHistory":{"type":"array","items":{"type":"object"},"description":"Earlier versions of the reason."},"reviewedAt":{"type":["integer","null"],"format":"int64","description":"When it was reviewed."},"reviewedBy":{"type":["string","null"],"description":"Member ID of the reviewer."},"serverId":{"type":"string","description":"Server ID, or department ID for department LOAs."},"startAt":{"type":["integer","null"],"format":"int64","description":"When it's scheduled to start."},"startType":{"type":"integer","format":"int32","description":"0 starts when approved, 1 starts at `startAt`."},"startedAt":{"type":["integer","null"],"format":"int64","description":"When the leave actually started."},"status":{"type":"integer","format":"int32","description":"`0` Active, `1` Denied, `2` Ended, `3` Pending review, `4` Expired, `5` Approved and\nwaiting to start, `6` Cancelled."}},"example":{"cancelledAt":0,"createdAt":1794776859830,"endAt":1795400000000,"endedAt":0,"expiredAt":0,"extensionRequests":[],"id":"7527833441069436928","memberId":"7308965405773533184","reason":"my mom took my phone","reasonHistory":[],"reviewedAt":1794780000000,"reviewedBy":"7264722635089514496","serverId":"7294057520392310784","startAt":1794800000000,"startType":1,"startedAt":1794800000000,"status":0}}}},"Data_Log":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","type","text","createdAt","createdBy","editedBy","username","proof"],"properties":{"completedBy":{"type":["string","null"],"description":"For ban BOLOs, member ID of who completed it."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdBy":{"type":"string","description":"Member ID of the staff member who created it, or `SYSTEM`."},"deniedBy":{"type":["string","null"],"description":"For ban BOLOs, member ID of who denied it."},"description":{"type":["string","null"],"description":"Extra details."},"dontCount":{"type":["boolean","null"],"description":"Whether it's left out of punishment counts."},"editedBy":{"type":"array","items":{"type":"string"},"description":"Member IDs of everyone who edited it."},"expired":{"type":["boolean","null"],"description":"Whether it has expired."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"expiredBy":{"type":["string","null"],"description":"Member ID of who expired it."},"hidden":{"type":["boolean","null"],"description":"Whether it's hidden from the player."},"hiddenBy":{"type":["string","null"],"description":"Member ID of who hid it."},"id":{"type":"string","description":"Unique ID."},"proof":{"type":"array","items":{"type":"string"},"description":"Proof file keys."},"robloxId":{"type":["string","null"],"description":"Roblox user ID of the player."},"serverId":{"type":"string","description":"Server ID."},"tempBan":{"type":["boolean","null"],"description":"Whether the ban is temporary."},"text":{"type":"string","description":"Reason."},"type":{"type":"integer","format":"int32","description":"Log type: `0` Warning, `1` Kick, `2` Ban, `3` Ban BOLO, `4` Note or `5` Custom."},"typeId":{"type":["string","null"],"description":"Custom log type ID, when `type` is 5."},"unbanAt":{"type":["integer","null"],"format":"int64","description":"When a temporary ban ends."},"username":{"type":"string","description":"Roblox username of the player."}},"example":{"createdAt":1794776859830,"createdBy":"7264722635089514496","dontCount":false,"editedBy":[],"expired":false,"id":"7527833441069436928","proof":[],"robloxId":"156","serverId":"7294057520392310784","text":"vdm at gas station (again)","type":0,"username":"Builderman"}}}},"Data_Member":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","roles","createdAt","inactive"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When they joined the server."},"id":{"type":"string","description":"Member ID. This is the member's Melonly user ID."},"inactive":{"type":"boolean","description":"Whether they're currently flagged inactive."},"inactiveLastShift":{"type":["integer","null"],"format":"int64","description":"When their last shift ended, at the time they were flagged."},"inactiveSince":{"type":["integer","null"],"format":"int64","description":"When they were flagged inactive."},"roles":{"type":"array","items":{"type":"string"},"description":"Role IDs held by the member."},"serverId":{"type":"string","description":"Server ID."}},"example":{"createdAt":1712000000000,"id":"7308965405773533184","inactive":false,"inactiveLastShift":0,"inactiveSince":0,"roles":["7314779729419046912"],"serverId":"7294057520392310784"}}}},"Data_RateLimitStatus":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["serverId","unlimited","currentCount","limit","remaining","timeToResetMin","timeToResetHrs"],"properties":{"currentCount":{"type":"integer","format":"int64","description":"Requests counted this month."},"limit":{"type":"integer","format":"int64","description":"Monthly limit without premium."},"remaining":{"type":"integer","format":"int64","description":"Requests left this month."},"serverId":{"type":"string","description":"Server ID."},"timeToResetHrs":{"type":"number","format":"double","description":"Hours until the count resets."},"timeToResetMin":{"type":"integer","format":"int64","description":"Minutes until the count resets."},"unlimited":{"type":"boolean","description":"Whether the server has no monthly limit, because it has premium."}},"example":{"currentCount":42,"limit":100,"remaining":58,"serverId":"7294057520392310784","timeToResetHrs":24.0,"timeToResetMin":1440,"unlimited":false}}}},"Data_RobloxConnection":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["userId","createdAt","lastUpdatedAt","robloxId"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When the accounts were linked."},"headShotImage":{"type":["string","null"],"description":"Roblox avatar headshot URL."},"lastUpdatedAt":{"type":"integer","format":"int64","description":"When the link was last refreshed."},"name":{"type":["string","null"],"description":"Roblox username."},"nickname":{"type":["string","null"],"description":"Roblox display name."},"preferredUsername":{"type":["string","null"],"description":"Roblox preferred username."},"profile":{"type":["string","null"],"description":"Roblox profile URL."},"robloxCreatedAt":{"type":["integer","null"],"format":"int64","description":"When the Roblox account was created, in Unix seconds."},"robloxId":{"type":"string","description":"Roblox user ID."},"userId":{"type":"string","description":"Melonly user ID."}},"example":{"createdAt":1712000000000,"headShotImage":"https://tr.rbxcdn.com/avatar-headshot.png","lastUpdatedAt":1794000000000,"name":"Builderman","nickname":"Builderman","preferredUsername":"Builderman","profile":"https://www.roblox.com/users/156/profile","robloxCreatedAt":1154000000,"robloxId":"156","userId":"7308965405773533184"}}}},"Data_Role":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","name","permissions","createdAt","priority","extraPermissions"],"properties":{"colour":{"type":["string","null"],"description":"Hex colour."},"createdAt":{"type":"integer","format":"int64","description":"When the role was created."},"extraPermissions":{"type":"string","description":"Extra permission bitfield as a decimal string."},"id":{"type":"string","description":"Unique ID."},"linkedDiscordRoleId":{"type":["string","null"],"description":"Discord role kept in sync with this one."},"name":{"type":"string","description":"Role name."},"permissions":{"type":"string","description":"Permission bitfield as a decimal string."},"priority":{"type":"integer","format":"int32","description":"Rank in the role hierarchy. Higher outranks lower."},"serverId":{"type":"string","description":"Server ID."}},"example":{"colour":"#11d982","createdAt":1700000000000,"extraPermissions":"0","id":"7314779729419046912","linkedDiscordRoleId":"1100000000000000000","name":"WE DEM MODZ!!!!!!","permissions":"6","priority":4,"serverId":"7294057520392310784"}}}},"Data_Server":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","ownerId","name","roles","createdAt","premium"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"discordGuildId":{"type":["string","null"],"description":"Linked Discord server ID."},"id":{"type":"string","description":"Unique ID."},"joinCode":{"type":["string","null"],"description":"Code members use to join."},"name":{"type":"string","description":"Server name."},"ownerId":{"type":"string","description":"Member ID of the server owner."},"premium":{"type":"boolean","description":"Whether the server has premium."},"roles":{"type":"array","items":{"type":"string"},"description":"IDs of the server's roles."}},"example":{"createdAt":1689000000000,"discordGuildId":"1043254628961792060","id":"7294057520392310784","joinCode":"liberty","name":"Nelly's Liberty County","ownerId":"7264722635089514496","premium":true,"roles":["7314779729419046912"]}}}},"Data_ServerToken":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","description":"An API token. The secret is only returned once, on creation.","required":["id","serverId","name","isActive","createdAt"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When the token was created."},"expiresAt":{"type":["integer","null"],"format":"int64","description":"When the token expires."},"id":{"type":"string","description":"Token ID."},"isActive":{"type":"boolean","description":"Whether the token works."},"lastUsedAt":{"type":["integer","null"],"format":"int64","description":"When the token was last used, to the nearest minute."},"name":{"type":"string","description":"Token name."},"serverId":{"type":"string","description":"Server the token belongs to."}},"example":{"createdAt":1794700000000,"id":"7527840000000004096","isActive":true,"lastUsedAt":1794776859830,"name":"shift bot (do not delete)","serverId":"7294057520392310784"}}}},"Data_Shift":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","memberId","breakTimestamps","createdAt","wave"],"properties":{"autoEnd":{"type":["boolean","null"],"description":"Whether the shift ends automatically."},"breakTimestamps":{"type":"array","items":{"$ref":"#/components/schemas/ShiftBreak"},"description":"Breaks taken, oldest first. See the break object."},"createdAt":{"type":"integer","format":"int64","description":"When the shift started."},"endedAt":{"type":["integer","null"],"format":"int64","description":"When the shift ended. Missing while it's active."},"endedBy":{"type":["string","null"],"description":"Member ID of who ended it, if not the member."},"id":{"type":"string","description":"Shift ID."},"memberId":{"type":"string","description":"Member ID of the member on shift."},"serverId":{"type":"string","description":"Server ID, or department ID for department shifts."},"type":{"type":["string","null"],"description":"Shift type ID. Missing for the default type."},"wave":{"type":"integer","format":"int32","description":"Activity wave the shift counts towards."}},"example":{"breakTimestamps":[{"endedAt":1794777600000,"startedAt":1794777000000}],"createdAt":1794776859830,"endedAt":1794790000000,"id":"7527830759214682112","memberId":"7308965405773533184","serverId":"7294057520392310784","type":"7400000000000000000","wave":12}}}},"Data_ShiftType":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","name","createdAt","requiredRoles"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"discordRoleId":{"type":["string","null"],"description":"Discord role given while on this type of shift."},"id":{"type":"string","description":"Unique ID."},"name":{"type":"string","description":"Shift type name."},"nicknamePrefix":{"type":["string","null"],"description":"Nickname prefix added while on this type of shift."},"requiredRoles":{"type":"array","items":{"type":"string"},"description":"Role IDs allowed to start this type of shift. Empty means anyone."},"serverId":{"type":"string","description":"Server ID, or department ID for department shift types."}},"example":{"createdAt":1794776859830,"discordRoleId":"1100000000000000001","id":"7400000000000000000","name":"Highway Patrol","nicknamePrefix":"[HP] ","requiredRoles":["7314779729419046912"],"serverId":"7294057520392310784"}}}},"Data_Suspension":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","required":["id","serverId","memberId","reason","points","startedAt","startedBy","voided","expired"],"properties":{"endAt":{"type":["integer","null"],"format":"int64","description":"When it's scheduled to end. Missing for indefinite suspensions."},"endedAt":{"type":["integer","null"],"format":"int64","description":"When it ended early."},"endedBy":{"type":["string","null"],"description":"Member ID of who ended it early."},"endedReason":{"type":["string","null"],"description":"Why it ended early."},"expired":{"type":"boolean","description":"Whether it has expired."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"id":{"type":"string","description":"Unique ID."},"memberId":{"type":"string","description":"Member ID of the suspended member."},"points":{"type":"integer","format":"int32","description":"Points it carries."},"reason":{"type":"string","description":"Why they were suspended."},"serverId":{"type":"string","description":"Server ID."},"startedAt":{"type":"integer","format":"int64","description":"When it started."},"startedBy":{"type":"string","description":"Member ID of who suspended them."},"voidReason":{"type":["string","null"],"description":"Why it was voided."},"voided":{"type":"boolean","description":"Whether it has been voided."},"voidedBy":{"type":["string","null"],"description":"Member ID of who voided it."}},"example":{"endAt":1795381659830,"expired":false,"id":"7527700000000000000","memberId":"7308965405773533184","points":0,"reason":"said \"trust me bro\" during a 10-80","serverId":"7294057520392310784","startedAt":1794776859830,"startedBy":"7264722635089514496","voided":false}}}},"Data_TokenInfo":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"object","description":"The token used for the current request.","required":["serverId","tokenId","tokenName"],"properties":{"expiresAt":{"type":["integer","null"],"format":"int64","description":"When the token expires."},"serverId":{"type":"string","description":"Server the token belongs to."},"tokenId":{"type":"string","description":"Token ID."},"tokenName":{"type":"string","description":"Token name."}},"example":{"serverId":"7294057520392310784","tokenId":"7527840000000004096","tokenName":"shift bot (do not delete)"}}}},"Data_Vec_LogType":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","description":"A log type that can be used when creating logs.","required":["type","name","custom","dontCount","premium"],"properties":{"custom":{"type":"boolean","description":"Whether it's one of the server's custom types."},"dontCount":{"type":"boolean","description":"Whether logs of this type are left out of punishment counts."},"name":{"type":"string","description":"Display name."},"premium":{"type":"boolean","description":"Whether creating this type needs premium."},"type":{"type":"integer","format":"int32","description":"Value for a log's `type`.","minimum":0},"typeId":{"type":["string","null"],"description":"Value for a log's `typeId`. Custom types only."},"verb":{"type":["string","null"],"description":"Past tense action, such as `Warned`. Missing for notes and ban BOLOs."}},"example":{"custom":true,"dontCount":true,"name":"Strongly Worded Warning","premium":true,"type":5,"typeId":"7334638128784740352","verb":"Strongly Worded"}}}}},"Data_Vec_ServerToken":{"type":"object","description":"Success envelope for single resources.","required":["data"],"properties":{"data":{"type":"array","items":{"type":"object","description":"An API token. The secret is only returned once, on creation.","required":["id","serverId","name","isActive","createdAt"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When the token was created."},"expiresAt":{"type":["integer","null"],"format":"int64","description":"When the token expires."},"id":{"type":"string","description":"Token ID."},"isActive":{"type":"boolean","description":"Whether the token works."},"lastUsedAt":{"type":["integer","null"],"format":"int64","description":"When the token was last used, to the nearest minute."},"name":{"type":"string","description":"Token name."},"serverId":{"type":"string","description":"Server the token belongs to."}},"example":{"createdAt":1794700000000,"id":"7527840000000004096","isActive":true,"lastUsedAt":1794776859830,"name":"shift bot (do not delete)","serverId":"7294057520392310784"}}}}},"Department":{"type":"object","required":["id","serverId","name","icon"],"properties":{"activated":{"type":["boolean","null"],"description":"Whether the department is active."},"discordGuildId":{"type":["string","null"],"description":"Discord server linked to the department."},"icon":{"type":"string","description":"Icon image URL."},"id":{"type":"string","description":"Unique ID."},"joinCode":{"type":["string","null"],"description":"Code members use to join."},"name":{"type":"string","description":"Department name."},"serverId":{"type":"string","description":"Server the department belongs to."},"type":{"type":["integer","null"],"format":"int32","description":"Department type."}},"example":{"activated":true,"icon":"https://cdn.melonly.com/icons/sheriff.png","id":"7392336585590575104","name":"Sheriff's Office (2 deputies)","serverId":"7294057520392310784","type":1}},"DepartmentMember":{"type":"object","required":["id","departmentId","rankId","createdAt","rankPosition","customColumnValues","supportFlags","roles"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When they joined the department."},"customColumnValues":{"type":"array","items":{"type":"object"},"description":"Values for the department's custom roster columns."},"departmentId":{"type":"string","description":"Department ID."},"id":{"type":"string","description":"Unique ID."},"inactive":{"type":["boolean","null"],"description":"Whether they're currently flagged inactive."},"inactiveLastShift":{"type":["integer","null"],"format":"int64","description":"When their last shift ended, at the time they were flagged."},"inactiveSince":{"type":["integer","null"],"format":"int64","description":"When they were flagged inactive."},"rankId":{"type":"string","description":"ID of the member's rank."},"rankPosition":{"type":"integer","format":"int32","description":"Member's position within their rank."},"roles":{"type":"array","items":{"type":"string"},"description":"IDs of the department roles held."},"supportFlags":{"type":"array","items":{"type":"string"},"description":"Roster flags set on the member."}},"example":{"createdAt":1794776859830,"customColumnValues":[],"departmentId":"7392336585590575104","id":"7527833441069436928","inactive":false,"inactiveLastShift":0,"inactiveSince":0,"rankId":"7392336600000000000","rankPosition":2,"roles":[],"supportFlags":[]}},"DepartmentRank":{"type":"object","required":["id","departmentId","name","permissions","position"],"properties":{"colour":{"type":["string","null"],"description":"Hex colour."},"departmentId":{"type":"string","description":"Department ID."},"id":{"type":"string","description":"Unique ID."},"linkedDiscordRoleId":{"type":["string","null"],"description":"Discord role kept in sync with this one."},"name":{"type":"string","description":"Rank name."},"permissions":{"type":"string","description":"Rank permission bitfield as a decimal string."},"position":{"type":"integer","format":"int32","description":"Order in the list. Lower comes first."}},"example":{"colour":"#11d982","departmentId":"7392336585590575104","id":"7392336600000000000","name":"Deputy Deputy","permissions":"0","position":3}},"DiscordIdResponse":{"type":"object","required":["discordId"],"properties":{"discordId":{"type":"string","description":"Discord user ID."}},"example":{"discordId":"1043254628961792060"}},"EditLogRequest":{"type":"object","description":"Fields to change. Omitted fields keep their current value.","required":["performedBy"],"properties":{"description":{"type":["string","null"],"description":"Extra details. Needs premium.","maxLength":2048},"performedBy":{"type":"string","description":"Member ID of the staff member editing the log."},"resetPunishmentsCount":{"type":["boolean","null"],"description":"Reset the player's punishment count. Notes only."},"tempBan":{"type":["boolean","null"],"description":"Make the ban temporary, or permanent with `false`. Bans only."},"text":{"type":["string","null"],"description":"Reason.","maxLength":2048,"minLength":1},"type":{"type":["integer","null"],"format":"int32","description":"New log type.","maximum":5,"minimum":0},"typeId":{"type":["string","null"],"description":"Custom log type ID. Required when changing `type` to `5`."},"unbanAt":{"type":["integer","null"],"format":"int64","description":"When a temporary ban ends, up to a year away."},"username":{"type":["string","null"],"description":"Roblox username of the player.","maxLength":20,"minLength":3,"pattern":"^[A-Za-z0-9_]+$"}},"additionalProperties":false,"example":{"performedBy":"7264722635089514496","text":"vdm at gas station (again) (third time)"}},"EditShiftRequest":{"type":"object","description":"Fields to change. Omitted fields keep their current value.","required":["performedBy"],"properties":{"endedAt":{"type":["integer","null"],"format":"int64","description":"New end time. Must be after the start and not in the future."},"performedBy":{"type":"string","description":"Member ID of the staff member editing it."},"startedAt":{"type":["integer","null"],"format":"int64","description":"New start time."},"type":{"type":["string","null"],"description":"New shift type ID."}},"additionalProperties":false,"example":{"endedAt":1794778000000,"performedBy":"7264722635089514496"}},"ErrorBody":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","description":"Stable machine-readable code, e.g. `not_found` or `validation_failed`."},"details":{"description":"Extra context, such as invalid fields or rate limit counters."},"message":{"type":"string","description":"Human-readable explanation."}}},"ErrorResponse":{"type":"object","description":"Every error response uses this envelope.","required":["error"],"properties":{"error":{"$ref":"#/components/schemas/ErrorBody"}}},"FieldError":{"type":"object","description":"One invalid request field.","required":["field","message"],"properties":{"field":{"type":"string","description":"JSON field name, e.g. `unbanAt`."},"message":{"type":"string"}}},"Infraction":{"type":"object","required":["id","serverId","memberId","timestamp","points","issuedBy","text","voided","expired","editedBy","proof"],"properties":{"editedBy":{"type":"array","items":{"type":"string"},"description":"Member IDs of everyone who edited it."},"expired":{"type":"boolean","description":"Whether it has expired."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"guidelineId":{"type":["string","null"],"description":"Guideline it was issued under."},"id":{"type":"string","description":"Unique ID."},"issuedBy":{"type":"string","description":"Member ID of who issued it."},"memberId":{"type":"string","description":"Member ID of the member who received it."},"points":{"type":"integer","format":"int64","description":"Points it carries."},"proof":{"type":"array","items":{"type":"string"},"description":"Proof file keys."},"serverId":{"type":"string","description":"Server ID."},"term":{"type":["boolean","null"],"description":"Whether it terminated the member."},"text":{"type":"string","description":"Reason."},"timestamp":{"type":"integer","format":"int64","description":"When it was issued."},"voidReason":{"type":["string","null"],"description":"Why it was voided."},"voided":{"type":"boolean","description":"Whether it has been voided."},"voidedBy":{"type":["string","null"],"description":"Member ID of who voided it."}},"example":{"editedBy":[],"expired":false,"guidelineId":"7375594080912281600","id":"7527833441069436928","issuedBy":"7264722635089514496","memberId":"7308965405773533184","points":2,"proof":[],"serverId":"7294057520392310784","term":false,"text":"afk on shift for 40 minutes. said he was making soup","timestamp":1794776859830,"voided":false}},"InfractionSettings":{"type":"object","required":["guidelines","flowData","autoTerm"],"properties":{"autoTerm":{"type":"boolean","description":"Whether reaching the termination threshold removes the member automatically."},"expire":{"type":["boolean","null"],"description":"Whether infractions expire."},"expireDuration":{"type":["integer","null"],"format":"int32","description":"Days until infractions expire."},"flowData":{"type":"array","items":{"type":"array","items":{"type":"object"}},"description":"Point thresholds as `[action, points, label]`."},"guidelines":{"type":"object","description":"Guidelines by ID. Each has `name`, `shortDescription`, `description` and `points`."},"suspensionDuration":{"type":["integer","null"],"format":"int32","description":"Default suspension length in days."}},"example":{"autoTerm":false,"expire":true,"expireDuration":90,"flowData":[[0,2,"Warning"],[1,4,"Suspension"],[2,8,"Termination"]],"guidelines":{"7375594080912281600":{"id":"7375594080912281600","name":"Being AFK","points":2,"shortDescription":"Standing still for too long."}},"suspensionDuration":7}},"JoinRequest":{"type":"object","required":["userId","serverId","joinCode","createdAt"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"joinCode":{"type":"string","description":"The join code they used."},"serverId":{"type":"string","description":"Server ID, or department ID for department join requests."},"userId":{"type":"string","description":"Melonly user ID of who asked to join."}},"example":{"createdAt":1794776859830,"joinCode":"liberty","serverId":"7294057520392310784","userId":"7308965405773533184"}},"LiveStatus":{"type":"object","required":["status"],"properties":{"status":{"type":"string"}}},"Loa":{"type":"object","required":["id","serverId","memberId","createdAt","status","startType","extensionRequests","reasonHistory"],"properties":{"approveReason":{"type":["string","null"],"description":"The reviewer's reason for approving it."},"cancelledAt":{"type":["integer","null"],"format":"int64","description":"When the member cancelled it."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"denyReason":{"type":["string","null"],"description":"The reviewer's reason for denying it."},"endAt":{"type":["integer","null"],"format":"int64","description":"When the leave is scheduled to end."},"endedAt":{"type":["integer","null"],"format":"int64","description":"When the leave actually ended."},"endedBy":{"type":["string","null"],"description":"Member ID of who ended it early."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"extensionRequests":{"type":"array","items":{"type":"object"},"description":"Requests to extend the leave."},"id":{"type":"string","description":"Unique ID."},"memberId":{"type":"string","description":"Member ID of the member on leave."},"reason":{"type":["string","null"],"description":"The member's reason."},"reasonHistory":{"type":"array","items":{"type":"object"},"description":"Earlier versions of the reason."},"reviewedAt":{"type":["integer","null"],"format":"int64","description":"When it was reviewed."},"reviewedBy":{"type":["string","null"],"description":"Member ID of the reviewer."},"serverId":{"type":"string","description":"Server ID, or department ID for department LOAs."},"startAt":{"type":["integer","null"],"format":"int64","description":"When it's scheduled to start."},"startType":{"type":"integer","format":"int32","description":"0 starts when approved, 1 starts at `startAt`."},"startedAt":{"type":["integer","null"],"format":"int64","description":"When the leave actually started."},"status":{"type":"integer","format":"int32","description":"`0` Active, `1` Denied, `2` Ended, `3` Pending review, `4` Expired, `5` Approved and\nwaiting to start, `6` Cancelled."}},"example":{"cancelledAt":0,"createdAt":1794776859830,"endAt":1795400000000,"endedAt":0,"expiredAt":0,"extensionRequests":[],"id":"7527833441069436928","memberId":"7308965405773533184","reason":"my mom took my phone","reasonHistory":[],"reviewedAt":1794780000000,"reviewedBy":"7264722635089514496","serverId":"7294057520392310784","startAt":1794800000000,"startType":1,"startedAt":1794800000000,"status":0}},"Log":{"type":"object","required":["id","serverId","type","text","createdAt","createdBy","editedBy","username","proof"],"properties":{"completedBy":{"type":["string","null"],"description":"For ban BOLOs, member ID of who completed it."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdBy":{"type":"string","description":"Member ID of the staff member who created it, or `SYSTEM`."},"deniedBy":{"type":["string","null"],"description":"For ban BOLOs, member ID of who denied it."},"description":{"type":["string","null"],"description":"Extra details."},"dontCount":{"type":["boolean","null"],"description":"Whether it's left out of punishment counts."},"editedBy":{"type":"array","items":{"type":"string"},"description":"Member IDs of everyone who edited it."},"expired":{"type":["boolean","null"],"description":"Whether it has expired."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"expiredBy":{"type":["string","null"],"description":"Member ID of who expired it."},"hidden":{"type":["boolean","null"],"description":"Whether it's hidden from the player."},"hiddenBy":{"type":["string","null"],"description":"Member ID of who hid it."},"id":{"type":"string","description":"Unique ID."},"proof":{"type":"array","items":{"type":"string"},"description":"Proof file keys."},"robloxId":{"type":["string","null"],"description":"Roblox user ID of the player."},"serverId":{"type":"string","description":"Server ID."},"tempBan":{"type":["boolean","null"],"description":"Whether the ban is temporary."},"text":{"type":"string","description":"Reason."},"type":{"type":"integer","format":"int32","description":"Log type: `0` Warning, `1` Kick, `2` Ban, `3` Ban BOLO, `4` Note or `5` Custom."},"typeId":{"type":["string","null"],"description":"Custom log type ID, when `type` is 5."},"unbanAt":{"type":["integer","null"],"format":"int64","description":"When a temporary ban ends."},"username":{"type":"string","description":"Roblox username of the player."}},"example":{"createdAt":1794776859830,"createdBy":"7264722635089514496","dontCount":false,"editedBy":[],"expired":false,"id":"7527833441069436928","proof":[],"robloxId":"156","serverId":"7294057520392310784","text":"vdm at gas station (again)","type":0,"username":"Builderman"}},"LogType":{"type":"object","description":"A log type that can be used when creating logs.","required":["type","name","custom","dontCount","premium"],"properties":{"custom":{"type":"boolean","description":"Whether it's one of the server's custom types."},"dontCount":{"type":"boolean","description":"Whether logs of this type are left out of punishment counts."},"name":{"type":"string","description":"Display name."},"premium":{"type":"boolean","description":"Whether creating this type needs premium."},"type":{"type":"integer","format":"int32","description":"Value for a log's `type`.","minimum":0},"typeId":{"type":["string","null"],"description":"Value for a log's `typeId`. Custom types only."},"verb":{"type":["string","null"],"description":"Past tense action, such as `Warned`. Missing for notes and ban BOLOs."}},"example":{"custom":true,"dontCount":true,"name":"Strongly Worded Warning","premium":true,"type":5,"typeId":"7334638128784740352","verb":"Strongly Worded"}},"Member":{"type":"object","required":["id","serverId","roles","createdAt","inactive"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When they joined the server."},"id":{"type":"string","description":"Member ID. This is the member's Melonly user ID."},"inactive":{"type":"boolean","description":"Whether they're currently flagged inactive."},"inactiveLastShift":{"type":["integer","null"],"format":"int64","description":"When their last shift ended, at the time they were flagged."},"inactiveSince":{"type":["integer","null"],"format":"int64","description":"When they were flagged inactive."},"roles":{"type":"array","items":{"type":"string"},"description":"Role IDs held by the member."},"serverId":{"type":"string","description":"Server ID."}},"example":{"createdAt":1712000000000,"id":"7308965405773533184","inactive":false,"inactiveLastShift":0,"inactiveSince":0,"roles":["7314779729419046912"],"serverId":"7294057520392310784"}},"Metrics":{"type":"object","required":["status","databasePoolSize"],"properties":{"databasePoolSize":{"type":"integer","format":"int32","minimum":0},"status":{"type":"string"}}},"Page_Application":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","title","createdAt","acceptingResponses","questions","description","sections","banAppealNote"],"properties":{"acceptanceRemoveRoles":{"type":["object","null"],"description":"Discord roles removed when approved."},"acceptingResponses":{"type":"boolean","description":"Whether the form is open."},"allowMultipleSubmissions":{"type":["boolean","null"],"description":"Whether people can submit more than once."},"appealCooldown":{"type":["integer","null"],"format":"int32","description":"Days between ban appeals."},"approvalRoles":{"type":["object","null"],"description":"Discord roles given when approved."},"banAppealNote":{"type":"boolean","description":"Whether ban appeals show the ban log to reviewers."},"bannerKey":{"type":["string","null"],"description":"Banner image key."},"blockedDiscordRoles":{"type":["object","null"],"description":"Discord roles that can't apply."},"closedMessage":{"type":["string","null"],"description":"Message shown while the form is closed."},"collectRobloxAccount":{"type":["boolean","null"],"description":"Whether the applicant's Roblox account is collected."},"color":{"type":["string","null"],"description":"Hex colour."},"cooldown":{"type":["integer","null"],"format":"int32","description":"Hours before someone can apply again."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"defaultQuestionPointValue":{"type":["integer","null"],"format":"int32","description":"Default points per quiz question."},"denialRemoveRoles":{"type":["object","null"],"description":"Discord roles removed when denied."},"denialRoles":{"type":["object","null"],"description":"Discord roles given when denied."},"description":{"type":"string","description":"Form description."},"eventsChannelId":{"type":["string","null"],"description":"Discord channel for new submissions."},"folderId":{"type":["string","null"],"description":"Folder the form is in."},"giveRolesOnApproval":{"type":["object","null"],"description":"Melonly roles given when approved."},"guildMemberAge":{"type":["integer","null"],"format":"int32","description":"Days applicants must have been in your Discord server."},"id":{"type":"string","description":"Unique ID."},"inviteOnApproval":{"type":["boolean","null"],"description":"Whether approved applicants are invited to the server."},"lastUpdated":{"type":["integer","null"],"format":"int64","description":"When the form was last edited."},"maxLogs":{"type":["integer","null"],"format":"int32","description":"Most punishment logs an applicant can have."},"orgType":{"type":["string","null"],"description":"Whether it belongs to a server or a department."},"presets":{"type":["object","null"],"description":"Saved reviewer reasons."},"questions":{"type":"object","description":"The form's questions."},"quiz":{"type":["boolean","null"],"description":"Whether the form is a quiz."},"quizAutoAcceptThreshold":{"type":["integer","null"],"format":"int32","description":"Quiz score that approves automatically."},"quizAutoDenyThreshold":{"type":["integer","null"],"format":"int32","description":"Quiz score that denies automatically."},"quizReleaseType":{"type":["integer","null"],"format":"int32","description":"When quiz scores are released."},"requireApprovedReason":{"type":["boolean","null"],"description":"Whether reviewers must give a reason to approve."},"requireDiscordMember":{"type":["boolean","null"],"description":"Whether applicants must be in your Discord server."},"requiredDenialReason":{"type":["boolean","null"],"description":"Whether reviewers must give a reason to deny."},"requiredDiscordRoles":{"type":["object","null"],"description":"Discord roles applicants must have."},"resultsChannelId":{"type":["string","null"],"description":"Discord channel for results."},"resultsMentionUser":{"type":["boolean","null"],"description":"Whether results mention the applicant."},"revealReviewer":{"type":["boolean","null"],"description":"Whether applicants see who reviewed them."},"reviewOnlyRoles":{"type":["object","null"],"description":"Roles that can review but not edit the form."},"reviewerRoles":{"type":["object","null"],"description":"Roles that can review responses."},"robloxGroupId":{"type":["string","null"],"description":"Roblox group applicants must be in."},"sections":{"type":"object","description":"The form's sections."},"sendResponses":{"type":["boolean","null"],"description":"Whether applicants get a copy of their answers."},"serverId":{"type":"string","description":"Server ID, or department ID for department forms."},"sharing":{"type":["string","null"],"description":"Who else the form is shared with."},"slug":{"type":["string","null"],"description":"Short link slug."},"stageResponses":{"type":["boolean","null"],"description":"Whether decisions are staged before they're finalized."},"submissionMessage":{"type":["string","null"],"description":"Message shown after submitting."},"submitMentionRoles":{"type":["object","null"],"description":"Discord roles mentioned on new submissions."},"title":{"type":"string","description":"Form title."},"type":{"type":["integer","null"],"format":"int32","description":"Form type."}},"example":{"acceptingResponses":true,"banAppealNote":false,"createdAt":1794776859830,"description":"please read the rules before applying","id":"7400100000000000000","questions":{},"sections":[],"serverId":"7294057520392310784","title":"Game Moderator Application","type":0}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_ApplicationResponse":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","applicationId","createdAt","answers","userId","status"],"properties":{"answers":{"type":"object","description":"The applicant's answers."},"applicationId":{"type":"string","description":"Application ID."},"comments":{"type":["object","null"],"description":"Reviewer comments."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"finalizedAt":{"type":["integer","null"],"format":"int64","description":"When a staged decision was finalized."},"finalizedBy":{"type":["string","null"],"description":"Member ID of who finalized it."},"flagged":{"type":["object","null"],"description":"Flag details, if a reviewer flagged it."},"id":{"type":"string","description":"Unique ID."},"reason":{"type":["string","null"],"description":"The reviewer's reason."},"reviewedAt":{"type":["integer","null"],"format":"int64","description":"When it was reviewed."},"reviewedBy":{"type":["string","null"],"description":"Member ID of the reviewer."},"robloxId":{"type":["string","null"],"description":"Roblox user ID of the applicant."},"scoreReleased":{"type":["object","null"],"description":"Whether quiz scores have been released."},"scoring":{"type":["object","null"],"description":"Quiz scores."},"sectionsSorted":{"type":["object","null"],"description":"Section order the applicant saw."},"stagingStatus":{"type":["integer","null"],"format":"int32","description":"Staged decision, before it's finalized."},"status":{"type":"integer","format":"int32","description":"0 Pending, 1 Staged, 2 Approved, 3 Denied."},"userId":{"type":"string","description":"Melonly user ID of the applicant."}},"example":{"answers":{"q1":"i have 4 years of experience moderating my little brother"},"applicationId":"7400100000000000000","comments":{},"createdAt":1794776859830,"finalizedAt":0,"flagged":{},"id":"7400200000000000000","reason":"missed briefing, said his wifi died","reviewedAt":0,"reviewedBy":"7264722635089514496","robloxId":"156","scoreReleased":{},"scoring":{},"sectionsSorted":{},"stagingStatus":0,"status":0,"userId":"7308965405773533184"}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_AuditLogEvent":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","timestamp","userId"],"properties":{"applicationId":{"type":["string","null"],"description":"Application the event relates to."},"description":{"type":["object","null"],"description":"What happened, as `{ label, further }`."},"id":{"type":"string","description":"Unique ID."},"serverId":{"type":"string","description":"Server ID, or department ID for department events."},"timestamp":{"type":"integer","format":"int64","description":"When it happened."},"type":{"type":["integer","null"],"format":"int32","description":"Event type."},"userId":{"type":"string","description":"Member ID of who did it, or `SYSTEM`."}},"example":{"description":{"further":["For a duration of 1 hour"],"label":"Created shift for Builderman"},"id":"7527833441069436928","serverId":"7294057520392310784","timestamp":1794776859830,"type":8,"userId":"7308965405773533184"}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_CadCall":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","type","createdByUserId","createdAt","status","units","title","description","records","panels","unitHistory"],"properties":{"address":{"type":["string","null"],"description":"Address."},"apiId":{"type":["string","null"],"description":"ID set by an integration that created the call."},"closedAt":{"type":["integer","null"],"format":"int64","description":"When the call was closed."},"code":{"type":["string","null"],"description":"Call code."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdByUnit":{"type":["object","null"],"description":"Unit that created the call."},"createdByUserId":{"type":"string","description":"Melonly user ID of who created the call."},"description":{"type":"string","description":"Longer description."},"id":{"type":"string","description":"Unique ID."},"loc":{"type":["object","null"],"description":"Map position."},"origin":{"type":["string","null"],"description":"Where the call came from."},"panels":{"type":"object","description":"Panels the call is shown on."},"postal":{"type":["string","null"],"description":"Postal code."},"primaryUnit":{"type":["object","null"],"description":"Unit leading the call."},"priority":{"type":["string","null"],"description":"Call priority."},"records":{"type":"object","description":"Records attached."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"title":{"type":"string","description":"Title."},"type":{"type":"integer","format":"int32","description":"Type code."},"unitHistory":{"type":"object","description":"Units that have been on the call."},"units":{"type":"object","description":"Units attached."}},"example":{"address":"Highway 1","closedAt":0,"code":"10-80","createdAt":1794776859830,"createdByUnit":{},"createdByUserId":"7308965405773533184","description":"red prancer fled a traffic stop. driver waved at us","id":"7527000000000000000","loc":{},"origin":"911","panels":[],"postal":"214","primaryUnit":{},"priority":"2","records":[],"serverId":"7294057520392310784","status":0,"title":"10-80 on a Bullhorn Prancer","type":0,"unitHistory":[],"units":[]}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_CadCallNote":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","callId","createdByUserId","createdByUnit","createdAt","type","data"],"properties":{"callId":{"type":"string","description":"Call ID."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdByUnit":{"type":"object","description":"Unit that wrote the note."},"createdByUserId":{"type":"string","description":"Melonly user ID of who wrote the note."},"data":{"type":"object","description":"Note contents."},"id":{"type":"string","description":"Unique ID."},"mergedFrom":{"type":["string","null"],"description":"Call the note was merged from."},"serverId":{"type":"string","description":"Server ID."},"type":{"type":"integer","format":"int32","description":"Type code."}},"example":{"callId":"7527000000000000000","createdAt":1794776859830,"createdByUnit":{},"createdByUserId":"7308965405773533184","data":{"text":"suspect bailed. prancer is still rolling"},"id":"7527000000000000001","serverId":"7294057520392310784","type":0}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_CadCourtHearing":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["serverId","id","status","type","recordId","civId","createdAt"],"properties":{"civId":{"type":"string","description":"Civilian the hearing is for."},"closedAt":{"type":["integer","null"],"format":"int64","description":"When the hearing closed."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"id":{"type":"string","description":"Unique ID."},"processedBy":{"type":["string","null"],"description":"Who processed it."},"recordId":{"type":"string","description":"Record the hearing is for."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"type":{"type":"integer","format":"int32","description":"Type code."}},"example":{"civId":"7527000000000000004","closedAt":0,"createdAt":1794776859830,"id":"7527000000000000003","recordId":"7527000000000000002","serverId":"7294057520392310784","status":0,"type":0}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_CadRecord":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","createdByUserId","createdAt","type","label","data","templateId","previewData","flags","meta","status","objects"],"properties":{"agency":{"type":["object","null"],"description":"Agency that created it."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdByUnit":{"type":["object","null"],"description":"Unit that created the record."},"createdByUserId":{"type":"string","description":"Melonly user ID of who created the record."},"data":{"type":"object","description":"Record contents."},"flags":{"type":"object","description":"Flags set on the record."},"id":{"type":"string","description":"Unique ID."},"label":{"type":"string","description":"Record label."},"meta":{"type":"object","description":"Extra record metadata."},"noCharge":{"type":["boolean","null"],"description":"Whether charges were dropped."},"objects":{"type":"object","description":"People, vehicles and other objects in the record."},"previewData":{"type":"object","description":"Summary shown in lists."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"templateId":{"type":"integer","format":"int32","description":"Record template ID."},"type":{"type":"integer","format":"int32","description":"Type code."}},"example":{"agency":{},"createdAt":1794776859830,"createdByUnit":{},"createdByUserId":"7308965405773533184","data":{},"flags":[],"id":"7527000000000000002","label":"Citation","meta":{},"noCharge":false,"objects":[],"previewData":{},"serverId":"7294057520392310784","status":0,"templateId":1,"type":0}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_CadUnit":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","userId","status","panic","number","agency","loc","items"],"properties":{"agency":{"type":"string","description":"Agency."},"customStatusId":{"type":["string","null"],"description":"Custom status, when one is set."},"id":{"type":"integer","format":"int32","description":"Unit ID."},"items":{"type":"object","description":"Equipment carried."},"loc":{"type":"object","description":"Map position."},"location":{"type":["string","null"],"description":"Location text."},"name":{"type":["string","null"],"description":"Callsign name."},"number":{"type":"string","description":"Unit number, such as `1A-12`."},"panic":{"type":"boolean","description":"Whether panic is active."},"rank":{"type":["string","null"],"description":"Rank."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"subdivision":{"type":["string","null"],"description":"Subdivision."},"userId":{"type":"string","description":"Melonly user ID of who's on the unit."}},"example":{"agency":"LSSD","id":12,"items":[],"loc":{},"location":"Postal 214","name":"Builderman","number":"1A-12","panic":false,"rank":"Deputy","serverId":"7294057520392310784","status":1,"subdivision":"Patrol","userId":"7308965405773533184"}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_CadUnitGroup":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","name","units","status","panic","premade"],"properties":{"customStatusId":{"type":["string","null"],"description":"Custom status, when one is set."},"id":{"type":"integer","format":"int32","description":"Unit group ID."},"maxUnits":{"type":["integer","null"],"format":"int32","description":"Most units that can join."},"name":{"type":"string","description":"Display name."},"panic":{"type":"boolean","description":"Whether panic is active."},"premade":{"type":"boolean","description":"Whether it's a premade group."},"restrictAgency":{"type":["string","null"],"description":"Only this agency's units can join."},"serverId":{"type":"string","description":"Server ID."},"status":{"type":"integer","format":"int32","description":"Status code."},"units":{"type":"object","description":"Units attached."}},"example":{"id":3,"maxUnits":4,"name":"Adam 1","panic":false,"premade":true,"serverId":"7294057520392310784","status":1,"units":[]}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_Department":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","name","icon"],"properties":{"activated":{"type":["boolean","null"],"description":"Whether the department is active."},"discordGuildId":{"type":["string","null"],"description":"Discord server linked to the department."},"icon":{"type":"string","description":"Icon image URL."},"id":{"type":"string","description":"Unique ID."},"joinCode":{"type":["string","null"],"description":"Code members use to join."},"name":{"type":"string","description":"Department name."},"serverId":{"type":"string","description":"Server the department belongs to."},"type":{"type":["integer","null"],"format":"int32","description":"Department type."}},"example":{"activated":true,"icon":"https://cdn.melonly.com/icons/sheriff.png","id":"7392336585590575104","name":"Sheriff's Office (2 deputies)","serverId":"7294057520392310784","type":1}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_DepartmentMember":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","departmentId","rankId","createdAt","rankPosition","customColumnValues","supportFlags","roles"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When they joined the department."},"customColumnValues":{"type":"array","items":{"type":"object"},"description":"Values for the department's custom roster columns."},"departmentId":{"type":"string","description":"Department ID."},"id":{"type":"string","description":"Unique ID."},"inactive":{"type":["boolean","null"],"description":"Whether they're currently flagged inactive."},"inactiveLastShift":{"type":["integer","null"],"format":"int64","description":"When their last shift ended, at the time they were flagged."},"inactiveSince":{"type":["integer","null"],"format":"int64","description":"When they were flagged inactive."},"rankId":{"type":"string","description":"ID of the member's rank."},"rankPosition":{"type":"integer","format":"int32","description":"Member's position within their rank."},"roles":{"type":"array","items":{"type":"string"},"description":"IDs of the department roles held."},"supportFlags":{"type":"array","items":{"type":"string"},"description":"Roster flags set on the member."}},"example":{"createdAt":1794776859830,"customColumnValues":[],"departmentId":"7392336585590575104","id":"7527833441069436928","inactive":false,"inactiveLastShift":0,"inactiveSince":0,"rankId":"7392336600000000000","rankPosition":2,"roles":[],"supportFlags":[]}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_DepartmentRank":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","departmentId","name","permissions","position"],"properties":{"colour":{"type":["string","null"],"description":"Hex colour."},"departmentId":{"type":"string","description":"Department ID."},"id":{"type":"string","description":"Unique ID."},"linkedDiscordRoleId":{"type":["string","null"],"description":"Discord role kept in sync with this one."},"name":{"type":"string","description":"Rank name."},"permissions":{"type":"string","description":"Rank permission bitfield as a decimal string."},"position":{"type":"integer","format":"int32","description":"Order in the list. Lower comes first."}},"example":{"colour":"#11d982","departmentId":"7392336585590575104","id":"7392336600000000000","name":"Deputy Deputy","permissions":"0","position":3}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_Infraction":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","memberId","timestamp","points","issuedBy","text","voided","expired","editedBy","proof"],"properties":{"editedBy":{"type":"array","items":{"type":"string"},"description":"Member IDs of everyone who edited it."},"expired":{"type":"boolean","description":"Whether it has expired."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"guidelineId":{"type":["string","null"],"description":"Guideline it was issued under."},"id":{"type":"string","description":"Unique ID."},"issuedBy":{"type":"string","description":"Member ID of who issued it."},"memberId":{"type":"string","description":"Member ID of the member who received it."},"points":{"type":"integer","format":"int64","description":"Points it carries."},"proof":{"type":"array","items":{"type":"string"},"description":"Proof file keys."},"serverId":{"type":"string","description":"Server ID."},"term":{"type":["boolean","null"],"description":"Whether it terminated the member."},"text":{"type":"string","description":"Reason."},"timestamp":{"type":"integer","format":"int64","description":"When it was issued."},"voidReason":{"type":["string","null"],"description":"Why it was voided."},"voided":{"type":"boolean","description":"Whether it has been voided."},"voidedBy":{"type":["string","null"],"description":"Member ID of who voided it."}},"example":{"editedBy":[],"expired":false,"guidelineId":"7375594080912281600","id":"7527833441069436928","issuedBy":"7264722635089514496","memberId":"7308965405773533184","points":2,"proof":[],"serverId":"7294057520392310784","term":false,"text":"afk on shift for 40 minutes. said he was making soup","timestamp":1794776859830,"voided":false}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_JoinRequest":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["userId","serverId","joinCode","createdAt"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"joinCode":{"type":"string","description":"The join code they used."},"serverId":{"type":"string","description":"Server ID, or department ID for department join requests."},"userId":{"type":"string","description":"Melonly user ID of who asked to join."}},"example":{"createdAt":1794776859830,"joinCode":"liberty","serverId":"7294057520392310784","userId":"7308965405773533184"}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_Loa":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","memberId","createdAt","status","startType","extensionRequests","reasonHistory"],"properties":{"approveReason":{"type":["string","null"],"description":"The reviewer's reason for approving it."},"cancelledAt":{"type":["integer","null"],"format":"int64","description":"When the member cancelled it."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"denyReason":{"type":["string","null"],"description":"The reviewer's reason for denying it."},"endAt":{"type":["integer","null"],"format":"int64","description":"When the leave is scheduled to end."},"endedAt":{"type":["integer","null"],"format":"int64","description":"When the leave actually ended."},"endedBy":{"type":["string","null"],"description":"Member ID of who ended it early."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"extensionRequests":{"type":"array","items":{"type":"object"},"description":"Requests to extend the leave."},"id":{"type":"string","description":"Unique ID."},"memberId":{"type":"string","description":"Member ID of the member on leave."},"reason":{"type":["string","null"],"description":"The member's reason."},"reasonHistory":{"type":"array","items":{"type":"object"},"description":"Earlier versions of the reason."},"reviewedAt":{"type":["integer","null"],"format":"int64","description":"When it was reviewed."},"reviewedBy":{"type":["string","null"],"description":"Member ID of the reviewer."},"serverId":{"type":"string","description":"Server ID, or department ID for department LOAs."},"startAt":{"type":["integer","null"],"format":"int64","description":"When it's scheduled to start."},"startType":{"type":"integer","format":"int32","description":"0 starts when approved, 1 starts at `startAt`."},"startedAt":{"type":["integer","null"],"format":"int64","description":"When the leave actually started."},"status":{"type":"integer","format":"int32","description":"`0` Active, `1` Denied, `2` Ended, `3` Pending review, `4` Expired, `5` Approved and\nwaiting to start, `6` Cancelled."}},"example":{"cancelledAt":0,"createdAt":1794776859830,"endAt":1795400000000,"endedAt":0,"expiredAt":0,"extensionRequests":[],"id":"7527833441069436928","memberId":"7308965405773533184","reason":"my mom took my phone","reasonHistory":[],"reviewedAt":1794780000000,"reviewedBy":"7264722635089514496","serverId":"7294057520392310784","startAt":1794800000000,"startType":1,"startedAt":1794800000000,"status":0}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_Log":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","type","text","createdAt","createdBy","editedBy","username","proof"],"properties":{"completedBy":{"type":["string","null"],"description":"For ban BOLOs, member ID of who completed it."},"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"createdBy":{"type":"string","description":"Member ID of the staff member who created it, or `SYSTEM`."},"deniedBy":{"type":["string","null"],"description":"For ban BOLOs, member ID of who denied it."},"description":{"type":["string","null"],"description":"Extra details."},"dontCount":{"type":["boolean","null"],"description":"Whether it's left out of punishment counts."},"editedBy":{"type":"array","items":{"type":"string"},"description":"Member IDs of everyone who edited it."},"expired":{"type":["boolean","null"],"description":"Whether it has expired."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"expiredBy":{"type":["string","null"],"description":"Member ID of who expired it."},"hidden":{"type":["boolean","null"],"description":"Whether it's hidden from the player."},"hiddenBy":{"type":["string","null"],"description":"Member ID of who hid it."},"id":{"type":"string","description":"Unique ID."},"proof":{"type":"array","items":{"type":"string"},"description":"Proof file keys."},"robloxId":{"type":["string","null"],"description":"Roblox user ID of the player."},"serverId":{"type":"string","description":"Server ID."},"tempBan":{"type":["boolean","null"],"description":"Whether the ban is temporary."},"text":{"type":"string","description":"Reason."},"type":{"type":"integer","format":"int32","description":"Log type: `0` Warning, `1` Kick, `2` Ban, `3` Ban BOLO, `4` Note or `5` Custom."},"typeId":{"type":["string","null"],"description":"Custom log type ID, when `type` is 5."},"unbanAt":{"type":["integer","null"],"format":"int64","description":"When a temporary ban ends."},"username":{"type":"string","description":"Roblox username of the player."}},"example":{"createdAt":1794776859830,"createdBy":"7264722635089514496","dontCount":false,"editedBy":[],"expired":false,"id":"7527833441069436928","proof":[],"robloxId":"156","serverId":"7294057520392310784","text":"vdm at gas station (again)","type":0,"username":"Builderman"}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_Member":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","roles","createdAt","inactive"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When they joined the server."},"id":{"type":"string","description":"Member ID. This is the member's Melonly user ID."},"inactive":{"type":"boolean","description":"Whether they're currently flagged inactive."},"inactiveLastShift":{"type":["integer","null"],"format":"int64","description":"When their last shift ended, at the time they were flagged."},"inactiveSince":{"type":["integer","null"],"format":"int64","description":"When they were flagged inactive."},"roles":{"type":"array","items":{"type":"string"},"description":"Role IDs held by the member."},"serverId":{"type":"string","description":"Server ID."}},"example":{"createdAt":1712000000000,"id":"7308965405773533184","inactive":false,"inactiveLastShift":0,"inactiveSince":0,"roles":["7314779729419046912"],"serverId":"7294057520392310784"}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_Role":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","name","permissions","createdAt","priority","extraPermissions"],"properties":{"colour":{"type":["string","null"],"description":"Hex colour."},"createdAt":{"type":"integer","format":"int64","description":"When the role was created."},"extraPermissions":{"type":"string","description":"Extra permission bitfield as a decimal string."},"id":{"type":"string","description":"Unique ID."},"linkedDiscordRoleId":{"type":["string","null"],"description":"Discord role kept in sync with this one."},"name":{"type":"string","description":"Role name."},"permissions":{"type":"string","description":"Permission bitfield as a decimal string."},"priority":{"type":"integer","format":"int32","description":"Rank in the role hierarchy. Higher outranks lower."},"serverId":{"type":"string","description":"Server ID."}},"example":{"colour":"#11d982","createdAt":1700000000000,"extraPermissions":"0","id":"7314779729419046912","linkedDiscordRoleId":"1100000000000000000","name":"WE DEM MODZ!!!!!!","permissions":"6","priority":4,"serverId":"7294057520392310784"}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_Shift":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","memberId","breakTimestamps","createdAt","wave"],"properties":{"autoEnd":{"type":["boolean","null"],"description":"Whether the shift ends automatically."},"breakTimestamps":{"type":"array","items":{"$ref":"#/components/schemas/ShiftBreak"},"description":"Breaks taken, oldest first. See the break object."},"createdAt":{"type":"integer","format":"int64","description":"When the shift started."},"endedAt":{"type":["integer","null"],"format":"int64","description":"When the shift ended. Missing while it's active."},"endedBy":{"type":["string","null"],"description":"Member ID of who ended it, if not the member."},"id":{"type":"string","description":"Shift ID."},"memberId":{"type":"string","description":"Member ID of the member on shift."},"serverId":{"type":"string","description":"Server ID, or department ID for department shifts."},"type":{"type":["string","null"],"description":"Shift type ID. Missing for the default type."},"wave":{"type":"integer","format":"int32","description":"Activity wave the shift counts towards."}},"example":{"breakTimestamps":[{"endedAt":1794777600000,"startedAt":1794777000000}],"createdAt":1794776859830,"endedAt":1794790000000,"id":"7527830759214682112","memberId":"7308965405773533184","serverId":"7294057520392310784","type":"7400000000000000000","wave":12}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_ShiftType":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","name","createdAt","requiredRoles"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"discordRoleId":{"type":["string","null"],"description":"Discord role given while on this type of shift."},"id":{"type":"string","description":"Unique ID."},"name":{"type":"string","description":"Shift type name."},"nicknamePrefix":{"type":["string","null"],"description":"Nickname prefix added while on this type of shift."},"requiredRoles":{"type":"array","items":{"type":"string"},"description":"Role IDs allowed to start this type of shift. Empty means anyone."},"serverId":{"type":"string","description":"Server ID, or department ID for department shift types."}},"example":{"createdAt":1794776859830,"discordRoleId":"1100000000000000001","id":"7400000000000000000","name":"Highway Patrol","nicknamePrefix":"[HP] ","requiredRoles":["7314779729419046912"],"serverId":"7294057520392310784"}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"Page_Suspension":{"type":"object","description":"A page of results.","required":["data","page","pageSize","total","totalPages"],"properties":{"data":{"type":"array","items":{"type":"object","required":["id","serverId","memberId","reason","points","startedAt","startedBy","voided","expired"],"properties":{"endAt":{"type":["integer","null"],"format":"int64","description":"When it's scheduled to end. Missing for indefinite suspensions."},"endedAt":{"type":["integer","null"],"format":"int64","description":"When it ended early."},"endedBy":{"type":["string","null"],"description":"Member ID of who ended it early."},"endedReason":{"type":["string","null"],"description":"Why it ended early."},"expired":{"type":"boolean","description":"Whether it has expired."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"id":{"type":"string","description":"Unique ID."},"memberId":{"type":"string","description":"Member ID of the suspended member."},"points":{"type":"integer","format":"int32","description":"Points it carries."},"reason":{"type":"string","description":"Why they were suspended."},"serverId":{"type":"string","description":"Server ID."},"startedAt":{"type":"integer","format":"int64","description":"When it started."},"startedBy":{"type":"string","description":"Member ID of who suspended them."},"voidReason":{"type":["string","null"],"description":"Why it was voided."},"voided":{"type":"boolean","description":"Whether it has been voided."},"voidedBy":{"type":["string","null"],"description":"Member ID of who voided it."}},"example":{"endAt":1795381659830,"expired":false,"id":"7527700000000000000","memberId":"7308965405773533184","points":0,"reason":"said \"trust me bro\" during a 10-80","serverId":"7294057520392310784","startedAt":1794776859830,"startedBy":"7264722635089514496","voided":false}}},"page":{"type":"integer","format":"int64","description":"Current 1-based page number."},"pageSize":{"type":"integer","format":"int64"},"total":{"type":"integer","format":"int64","description":"Total number of matching items across all pages."},"totalPages":{"type":"integer","format":"int64"}}},"RateLimitStatus":{"type":"object","required":["serverId","unlimited","currentCount","limit","remaining","timeToResetMin","timeToResetHrs"],"properties":{"currentCount":{"type":"integer","format":"int64","description":"Requests counted this month."},"limit":{"type":"integer","format":"int64","description":"Monthly limit without premium."},"remaining":{"type":"integer","format":"int64","description":"Requests left this month."},"serverId":{"type":"string","description":"Server ID."},"timeToResetHrs":{"type":"number","format":"double","description":"Hours until the count resets."},"timeToResetMin":{"type":"integer","format":"int64","description":"Minutes until the count resets."},"unlimited":{"type":"boolean","description":"Whether the server has no monthly limit, because it has premium."}},"example":{"currentCount":42,"limit":100,"remaining":58,"serverId":"7294057520392310784","timeToResetHrs":24.0,"timeToResetMin":1440,"unlimited":false}},"ReadyStatus":{"type":"object","required":["database","redis"],"properties":{"database":{"type":"boolean"},"redis":{"type":"boolean"}}},"ReasonRequest":{"type":"object","required":["performedBy","reason"],"properties":{"performedBy":{"type":"string","description":"Member ID of the staff member doing this."},"reason":{"type":"string","description":"Reason, 4-1024 characters.","maxLength":1024,"minLength":4}},"additionalProperties":false,"example":{"performedBy":"7264722635089514496","reason":"wrong builderman"}},"RecordShiftRequest":{"type":"object","required":["memberId","performedBy","startedAt","endedAt"],"properties":{"endedAt":{"type":"integer","format":"int64","description":"When the shift ended. Must be after `startedAt` and not in the future."},"memberId":{"type":"string","description":"Member ID of the member the shift belongs to."},"performedBy":{"type":"string","description":"Member ID of the staff member adding it."},"startedAt":{"type":"integer","format":"int64","description":"When the shift started."},"type":{"type":["string","null"],"description":"Shift type ID. Leave it out for the default type."}},"additionalProperties":false,"example":{"endedAt":1794777200000,"memberId":"7308965405773533184","performedBy":"7264722635089514496","startedAt":1794770000000}},"ReviewRequest":{"type":"object","required":["performedBy"],"properties":{"performedBy":{"type":"string","description":"Member ID of the reviewer."},"reason":{"type":["string","null"],"description":"Reason, up to 1024 characters.","maxLength":1024}},"additionalProperties":false,"example":{"performedBy":"7264722635089514496","reason":"tell her we said hi"}},"RobloxConnection":{"type":"object","required":["userId","createdAt","lastUpdatedAt","robloxId"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When the accounts were linked."},"headShotImage":{"type":["string","null"],"description":"Roblox avatar headshot URL."},"lastUpdatedAt":{"type":"integer","format":"int64","description":"When the link was last refreshed."},"name":{"type":["string","null"],"description":"Roblox username."},"nickname":{"type":["string","null"],"description":"Roblox display name."},"preferredUsername":{"type":["string","null"],"description":"Roblox preferred username."},"profile":{"type":["string","null"],"description":"Roblox profile URL."},"robloxCreatedAt":{"type":["integer","null"],"format":"int64","description":"When the Roblox account was created, in Unix seconds."},"robloxId":{"type":"string","description":"Roblox user ID."},"userId":{"type":"string","description":"Melonly user ID."}},"example":{"createdAt":1712000000000,"headShotImage":"https://tr.rbxcdn.com/avatar-headshot.png","lastUpdatedAt":1794000000000,"name":"Builderman","nickname":"Builderman","preferredUsername":"Builderman","profile":"https://www.roblox.com/users/156/profile","robloxCreatedAt":1154000000,"robloxId":"156","userId":"7308965405773533184"}},"Role":{"type":"object","required":["id","serverId","name","permissions","createdAt","priority","extraPermissions"],"properties":{"colour":{"type":["string","null"],"description":"Hex colour."},"createdAt":{"type":"integer","format":"int64","description":"When the role was created."},"extraPermissions":{"type":"string","description":"Extra permission bitfield as a decimal string."},"id":{"type":"string","description":"Unique ID."},"linkedDiscordRoleId":{"type":["string","null"],"description":"Discord role kept in sync with this one."},"name":{"type":"string","description":"Role name."},"permissions":{"type":"string","description":"Permission bitfield as a decimal string."},"priority":{"type":"integer","format":"int32","description":"Rank in the role hierarchy. Higher outranks lower."},"serverId":{"type":"string","description":"Server ID."}},"example":{"colour":"#11d982","createdAt":1700000000000,"extraPermissions":"0","id":"7314779729419046912","linkedDiscordRoleId":"1100000000000000000","name":"WE DEM MODZ!!!!!!","permissions":"6","priority":4,"serverId":"7294057520392310784"}},"Server":{"type":"object","required":["id","ownerId","name","roles","createdAt","premium"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"discordGuildId":{"type":["string","null"],"description":"Linked Discord server ID."},"id":{"type":"string","description":"Unique ID."},"joinCode":{"type":["string","null"],"description":"Code members use to join."},"name":{"type":"string","description":"Server name."},"ownerId":{"type":"string","description":"Member ID of the server owner."},"premium":{"type":"boolean","description":"Whether the server has premium."},"roles":{"type":"array","items":{"type":"string"},"description":"IDs of the server's roles."}},"example":{"createdAt":1689000000000,"discordGuildId":"1043254628961792060","id":"7294057520392310784","joinCode":"liberty","name":"Nelly's Liberty County","ownerId":"7264722635089514496","premium":true,"roles":["7314779729419046912"]}},"ServerToken":{"type":"object","description":"An API token. The secret is only returned once, on creation.","required":["id","serverId","name","isActive","createdAt"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When the token was created."},"expiresAt":{"type":["integer","null"],"format":"int64","description":"When the token expires."},"id":{"type":"string","description":"Token ID."},"isActive":{"type":"boolean","description":"Whether the token works."},"lastUsedAt":{"type":["integer","null"],"format":"int64","description":"When the token was last used, to the nearest minute."},"name":{"type":"string","description":"Token name."},"serverId":{"type":"string","description":"Server the token belongs to."}},"example":{"createdAt":1794700000000,"id":"7527840000000004096","isActive":true,"lastUsedAt":1794776859830,"name":"shift bot (do not delete)","serverId":"7294057520392310784"}},"Shift":{"type":"object","required":["id","serverId","memberId","breakTimestamps","createdAt","wave"],"properties":{"autoEnd":{"type":["boolean","null"],"description":"Whether the shift ends automatically."},"breakTimestamps":{"type":"array","items":{"$ref":"#/components/schemas/ShiftBreak"},"description":"Breaks taken, oldest first. See the break object."},"createdAt":{"type":"integer","format":"int64","description":"When the shift started."},"endedAt":{"type":["integer","null"],"format":"int64","description":"When the shift ended. Missing while it's active."},"endedBy":{"type":["string","null"],"description":"Member ID of who ended it, if not the member."},"id":{"type":"string","description":"Shift ID."},"memberId":{"type":"string","description":"Member ID of the member on shift."},"serverId":{"type":"string","description":"Server ID, or department ID for department shifts."},"type":{"type":["string","null"],"description":"Shift type ID. Missing for the default type."},"wave":{"type":"integer","format":"int32","description":"Activity wave the shift counts towards."}},"example":{"breakTimestamps":[{"endedAt":1794777600000,"startedAt":1794777000000}],"createdAt":1794776859830,"endedAt":1794790000000,"id":"7527830759214682112","memberId":"7308965405773533184","serverId":"7294057520392310784","type":"7400000000000000000","wave":12}},"ShiftBreak":{"type":"object","description":"One break inside a shift. Times are Unix epoch milliseconds.","required":["startedAt"],"properties":{"endedAt":{"type":["integer","null"],"format":"int64","description":"When the break ended. Missing while it's in progress."},"endedBy":{"type":["string","null"],"description":"Member ID of who ended it, if not the member."},"startedAt":{"type":"integer","format":"int64","description":"When the break started."}},"example":{"endedAt":1794777600000,"startedAt":1794777000000}},"ShiftType":{"type":"object","required":["id","serverId","name","createdAt","requiredRoles"],"properties":{"createdAt":{"type":"integer","format":"int64","description":"When it was created."},"discordRoleId":{"type":["string","null"],"description":"Discord role given while on this type of shift."},"id":{"type":"string","description":"Unique ID."},"name":{"type":"string","description":"Shift type name."},"nicknamePrefix":{"type":["string","null"],"description":"Nickname prefix added while on this type of shift."},"requiredRoles":{"type":"array","items":{"type":"string"},"description":"Role IDs allowed to start this type of shift. Empty means anyone."},"serverId":{"type":"string","description":"Server ID, or department ID for department shift types."}},"example":{"createdAt":1794776859830,"discordRoleId":"1100000000000000001","id":"7400000000000000000","name":"Highway Patrol","nicknamePrefix":"[HP] ","requiredRoles":["7314779729419046912"],"serverId":"7294057520392310784"}},"StartShiftRequest":{"type":"object","required":["memberId"],"properties":{"memberId":{"type":"string","description":"Member ID of the member starting the shift."},"type":{"type":["string","null"],"description":"Shift type ID. Leave it out for the default type. Needs premium."}},"additionalProperties":false,"example":{"memberId":"7308965405773533184"}},"Suspension":{"type":"object","required":["id","serverId","memberId","reason","points","startedAt","startedBy","voided","expired"],"properties":{"endAt":{"type":["integer","null"],"format":"int64","description":"When it's scheduled to end. Missing for indefinite suspensions."},"endedAt":{"type":["integer","null"],"format":"int64","description":"When it ended early."},"endedBy":{"type":["string","null"],"description":"Member ID of who ended it early."},"endedReason":{"type":["string","null"],"description":"Why it ended early."},"expired":{"type":"boolean","description":"Whether it has expired."},"expiredAt":{"type":["integer","null"],"format":"int64","description":"When it expired."},"id":{"type":"string","description":"Unique ID."},"memberId":{"type":"string","description":"Member ID of the suspended member."},"points":{"type":"integer","format":"int32","description":"Points it carries."},"reason":{"type":"string","description":"Why they were suspended."},"serverId":{"type":"string","description":"Server ID."},"startedAt":{"type":"integer","format":"int64","description":"When it started."},"startedBy":{"type":"string","description":"Member ID of who suspended them."},"voidReason":{"type":["string","null"],"description":"Why it was voided."},"voided":{"type":"boolean","description":"Whether it has been voided."},"voidedBy":{"type":["string","null"],"description":"Member ID of who voided it."}},"example":{"endAt":1795381659830,"expired":false,"id":"7527700000000000000","memberId":"7308965405773533184","points":0,"reason":"said \"trust me bro\" during a 10-80","serverId":"7294057520392310784","startedAt":1794776859830,"startedBy":"7264722635089514496","voided":false}},"TokenInfo":{"type":"object","description":"The token used for the current request.","required":["serverId","tokenId","tokenName"],"properties":{"expiresAt":{"type":["integer","null"],"format":"int64","description":"When the token expires."},"serverId":{"type":"string","description":"Server the token belongs to."},"tokenId":{"type":"string","description":"Token ID."},"tokenName":{"type":"string","description":"Token name."}},"example":{"serverId":"7294057520392310784","tokenId":"7527840000000004096","tokenName":"shift bot (do not delete)"}}},"securitySchemes":{"bearer_auth":{"type":"http","scheme":"bearer","bearerFormat":"API token"}}},"security":[{"bearer_auth":[]}],"tags":[{"name":"server","description":"The authenticated server"},{"name":"shifts","description":"Shifts and shift types"},{"name":"logs","description":"Moderation logs and log types"},{"name":"infractions","description":"Staff infractions and suspensions"},{"name":"members","description":"Server members"},{"name":"roles","description":"Server roles"},{"name":"loas","description":"Leaves of absence"},{"name":"applications","description":"Applications and responses"},{"name":"join-requests","description":"Join requests"},{"name":"audit-logs","description":"Audit log events"},{"name":"departments","description":"Departments of the authenticated server"},{"name":"cad","description":"CAD resources of the authenticated server"},{"name":"tokens","description":"API token management"},{"name":"verification","description":"Discord and Roblox account links"},{"name":"health","description":"Health and readiness"}]}