Record a Past Shift

Adds a shift that already happened, such as one a member forgot to start. performedBy needs the Manage Shifts permission. The shift counts towards the current activity wave.

POST

/api/v1/server/shifts/completed

Request

curl -X POST "https://api.melonly.com/api/v1/server/shifts/completed" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "endedAt": 1794777200000,
  "memberId": "7308965405773533184",
  "performedBy": "7264722635089514496",
  "startedAt": 1794770000000
}'

Response

201

Created

{
  "data": {
    "breakTimestamps": [
      {
        "endedAt": 1794777600000,
        "startedAt": 1794777000000
      }
    ],
    "createdAt": 1794776859830,
    "endedAt": 1794790000000,
    "id": "7527830759214682112",
    "memberId": "7308965405773533184",
    "serverId": "7294057520392310784",
    "type": "7400000000000000000",
    "wave": 12
  }
}

Authorization

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

Body

endedAtintegerrequired
When the shift ended. Must be after startedAt and not in the future.
memberIdstringrequired
Member ID of the member the shift belongs to.
performedBystringrequired
Member ID of the staff member adding it.
startedAtintegerrequired
When the shift started.
typestring | null
Shift type ID. Leave it out for the default type.

Response

201 Created

breakTimestampsobject[]required
Breaks taken, oldest first. See the break object.
createdAtintegerrequired
When the shift started.
idstringrequired
Shift ID.
memberIdstringrequired
Member ID of the member on shift.
serverIdstringrequired
Server ID, or department ID for department shifts.
waveintegerrequired
Activity wave the shift counts towards.
autoEndboolean | null
Whether the shift ends automatically.
endedAtinteger | null
When the shift ended. Missing while it's active.
endedBystring | null
Member ID of who ended it, if not the member.
typestring | null
Shift type ID. Missing for the default type.

Errors

StatusMeaning
400Invalid request. validation_failed lists each invalid field in details.fields.
401Missing, invalid or expired token
403Success
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