---
title: "Send a test log"
method: POST
path: "/servers/{guild_id}/troubleshoot/test-log"
tags: ["Troubleshooting"]
---

# Send a test log

`POST /servers/{guild_id}/troubleshoot/test-log`

## Request

- Base URL: `https://quark.bot/api`
- URL: `https://quark.bot/api/servers/{guild_id}/troubleshoot/test-log`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/quark-bot-discord/apis/quark-api/docs/servers/:guild_id/troubleshoot/test-log/post.ts> (a function with typed inputs; its response is checked against the schema)

Sends one real, visible test log through the full delivery path and reports whether it arrived. Limited to one per server per minute.

The response is 200 even if the log did not arrive. Check `ok` and `stage`.

## Path parameters

- `guild_id` string, required

## Query parameters

- `bot` 'pro'

## Response `200`

The result of the test.

- TestLogResult
  - `ok` boolean
  - `stage` 'delivered' | 'no_channel' | 'webhook_404' | 'channel_parked' | 'local_rate_limit' | 'forbidden' | 'rate_limited' | 'request_timeout_or_network' | 'unknown': Where the log got to.
  - `channelId` string, nullable
  - `httpStatus` integer, nullable
  - `detail` string, nullable
  - `latencyMs` integer, nullable

## Other responses

- `401`: No token was sent, or the token is not valid: malformed, expired or revoked. A token sent with a scheme other than `Bearer` is refused too.
- `403`: The token belongs to a different server, or is not an Admin token.
- `429`: A test log was sent less than a minute ago, or you are being rate limited.

## Changes

- **2026-10-02** `16860ec3ac6f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/quark-bot-discord/apis/quark-api/changes/servers/:guild_id/troubleshoot/test-log/post.md)

---

[API](https://skmtc.dev/quark-bot-discord/apis/quark-api.md) - [All operations](https://skmtc.dev/quark-bot-discord/apis/quark-api/llms.txt) - [OpenAPI document](https://skmtc.dev/quark-bot-discord/apis/quark-api/revisions/53696c705ecb?raw)