auth/status.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61


GET /auth/status
back to auth /// home
Check if your session is still alive and get details about it.
Request
No body. Token in header:
Authorization: Bearer <token>


Valid Session Response (200)
{
  "success": true,
  "valid": true,
  "user": {
    "id": 1,
    "username": "admin",
    "name": "Full Name",
    "role": "administrators",
    "power": 100
  },
  "session": {
    "created_at": "2026-02-14T10:30:00Z",
    "last_accessed": "2026-02-14T11:45:00Z",
    "timeout_minutes": 120,
    "remaining_seconds": 5400,
    "expires_at": "2026-02-14T13:45:00Z"
  }
}


The session object tells you when the session was created, when it was last used, how long the timeout is, how many seconds are left and when itll expire if nothing happens.
If session refresh on activity is enabled (which it should be by default) then last_accessed gets updated on every request so the session keeps extending as long as youre actively bothering jsonderulo.
Invalid/Expired Session Response (401)
{
  "success": true,
  "valid": false,
  "message": "Session expired or invalid [request_id: 12345678]"
}


Note that success is still true here because the status check itself worked fine, the session is just dead lol. Check the valid field to know if the session is actually alive.
No Token Response (401)
{
  "success": false,
  "valid": false,
  "error": "No authorization token provided [request_id: 12345678]"
}