melonly logomelonly logo
melonly logo
Dashboard
Log in

Submit an LOA

Submits an LOA request as memberId. Leave out startAt to start the leave as soon as it's approved. Your server's LOA settings decide whether a reason or end date is required, how long the leave can be and how often members can ask.

POST

/api/v1/server/loas

Request

curl -X POST "https://api.melonly.com/api/v1/server/loas" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "endAt": 1795400000000,
  "memberId": "7308965405773533184",
  "reason": "my mom took my phone"
}'

Response

201

Created

{
  "data": {
    "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
  }
}

Authorization

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

Body

memberIdstringrequired
Member ID of the member taking leave.
endAtinteger | null
When the leave ends.
reasonstring | null
Reason, up to 1024 characters. Some servers require one.
startAtinteger | null
When the leave starts. Leave it out to start once approved.

Response

201 Created

createdAtintegerrequired
When it was created.
extensionRequestsobject[]required
Requests to extend the leave.
idstringrequired
Unique ID.
memberIdstringrequired
Member ID of the member on leave.
reasonHistoryobject[]required
Earlier versions of the reason.
serverIdstringrequired
Server ID, or department ID for department LOAs.
startTypeintegerrequired
0 starts when approved, 1 starts at startAt.
statusintegerrequired
0 Active, 1 Denied, 2 Ended, 3 Pending review, 4 Expired, 5 Approved and waiting to start, 6 Cancelled.
approveReasonstring | null
The reviewer's reason for approving it.
cancelledAtinteger | null
When the member cancelled it.
denyReasonstring | null
The reviewer's reason for denying it.
endAtinteger | null
When the leave is scheduled to end.
endedAtinteger | null
When the leave actually ended.
endedBystring | null
Member ID of who ended it early.
expiredAtinteger | null
When it expired.
reasonstring | null
The member's reason.
reviewedAtinteger | null
When it was reviewed.
reviewedBystring | null
Member ID of the reviewer.
startAtinteger | null
When it's scheduled to start.
startedAtinteger | null
When the leave actually started.

Errors

StatusMeaning
400Invalid request. validation_failed lists each invalid field in details.fields.
401Missing, invalid or expired token
429Rate limited. See Retry-After and details.
500Internal server error
502next did not confirm the write. Check whether it applied before retrying.
503Write endpoints are not configured on this deployment