Docs

Logs API

Single endpoint. API key required. Returns a shareable link.

Endpoint

POST /api/logs

Send raw bytes, form data, or JSON. The response includes the shareable URL.

Authentication

Provide the API key via:

Upload tokens

Mint a short-lived, single-use token so clients never store the long-lived key.

curl -X POST \\
  -H \"X-API-Key: $LOGS_API_KEY\" \\
  -H \"Content-Type: application/json\" \\
  -d '{\"ttl_seconds\":600,\"max_bytes\":10485760}' \\
  \"http://logs.yuma-homeserver.online/api/logs/token\"

Use it for a single upload:

curl -X POST \\
  -H \"Authorization: Bearer <upload-token>\" \\
  --data-binary @app.log \\
  \"http://logs.yuma-homeserver.online/api/logs?title=app.log\"

Examples

Binary / plain text

curl -X POST \
  -H "X-API-Key: $LOGS_API_KEY" \
  --data-binary @app.log \
  "http://logs.yuma-homeserver.online/api/logs?title=app.log"

JSON

curl -X POST \
  -H "X-API-Key: $LOGS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"worker.log","content":"hello\nworld"}' \
  "http://logs.yuma-homeserver.online/api/logs"

Response

{
  "id": "b7a3f1e2d7e448a09b9e6a0d3b1a1d2f",
  "url": "https://logs.yuma-homeserver.online/p/b7a3f1e2d7e448a09b9e6a0d3b1a1d2f"
}

Paste links