---
title: "Log player join/leave event"
method: POST
path: "/api/v1/login-history"
tags: ["login-history"]
---

# Log player join/leave event

`POST /api/v1/login-history`

## Request

- Base URL: `http://localhost:3000`
- URL: `http://localhost:3000/api/v1/login-history`
- Auth: HTTP bearer

Log player join/leave event

## Request body

- object
  - `serverId` number, required: Server ID
  - `discordId` string, required: Discord user ID
  - `type` 'join' | 'leave' | 'auto-logout', required: Event type
  - `timestamp` number, required: Event timestamp (ms)
  - `activeTime` number: Active time in seconds (for leave events)
  - `idleTime` number: Idle time in seconds (for leave events)

## Response `200`

Default Response

- object
  - `success` true, required
  - `data` object, required
    - `id` string: Login history UUID
    - `message` string
  - `meta` object, required
    - `timestamp` number, required

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/farmersonly/apis/farmersonly-club-api.md) - [All operations](https://skmtc.dev/farmersonly/apis/farmersonly-club-api/llms.txt) - [OpenAPI document](https://skmtc.dev/farmersonly/apis/farmersonly-club-api/revisions/b4fa9123ba90?raw)
