melonly logomelonly logo
melonly logo
Dashboard
Log in

End an LOA

With no body, the member cancels their pending request or ends their own leave early. Send performedBy to end someone else's leave as staff.

POST

/api/v1/server/loas/{loaId}/end

Request

curl -X POST "https://api.melonly.com/api/v1/server/loas/{loaId}/end" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Response

200

Success

{
  "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.

Path parameters

loaIdstringrequired

Body

performedBystring | null
Member ID of a staff member acting on someone else's shift or LOA. Leave it out to act as the owner.

Response

200 Success

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
403Success
404Not found
409Already ended, or pending when ended by staff
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