API Reference

Logs

Send a log message from the client to be stored or forwarded to a configured webhook.

Endpoint

POST /api/v2/logs https://authly.cc

Parameters

FieldDescription
session_id Required Active session ID from a successful Init call.
message Required Log text or data payload to send from the client.

Example Request

{
  "session_id": "dc1ce...a3a75",
  "message": "Hello from the client"
}

Responses

Log stored. If app logging is disabled, still returns 200 but does nothing.

{
  "success": true,
  "message": "Log stored"
}

MISSING_FIELDS — Required fields were not sent.

{
  "success": false,
  "code": "MISSING_FIELDS",
  "message": "Required fields are missing"
}

Session check failed. Codes: INVALID_SESSION, SESSION_EXPIRED.

{
  "success": false,
  "code": "SESSION_EXPIRED",
  "message": "Session has expired"
}

LOGS_LIMIT_REACHED — App has exceeded its log quota for this period.

{
  "success": false,
  "code": "LOGS_LIMIT_REACHED",
  "message": "Log quota exceeded for this period"
}

Internal error or webhook delivery failed. Codes: INTERNAL, WEBHOOK_FAILED.

{
  "success": false,
  "code": "WEBHOOK_FAILED",
  "message": "Forwarding webhook failed"
}