---
title: "Send device debug logs"
method: POST
path: "/v1/device/send-debug"
tags: ["DEVICE"]
---

# Send device debug logs

`POST /v1/device/send-debug`

Allows a developer to remotely trigger a Clover device to send its debug logs to Clover's servers. The `message` in the request body is logged to the device log, allowing developers to mark specific sequences for easier troubleshooting. 

**Note:** This endpoint is rate-limited to one successful request every 30 minutes per device to prevent server overload. It is intended for REST API integrations like Cloud Pay Display.

## Headers

- `User-Agent` string, required
- `X-Clover-Device-Id` string, required
- `X-POS-Id` string, required

## Request body

- object
  - `message` string, required — A custom string that is logged to the device log. Use this to mark a specific event or sequence in the logs for easier identification during troubleshooting.

## Response `200`

The request to send debug logs was successfully accepted by the server.

- object

## Other responses

- `400` — The request is invalid, and subsequent calls will continue to fail; do not repeat the call.
- `401` — An invalid bearer token has been provided. The call may be repeated if the provided bearer token is updated.
- `500` — The request processing failed with an unknown error, and the processing state of the operation is indeterminate. Do not repeat the call without additional analysis.
- `503` — The device is not available because it is currently servicing another call. This can be repeated at a later time, or cancel may be called to end the current operation.

---

[API](https://skmtc.net/clover/apis/platform-api.md) · [All operations](https://skmtc.net/clover/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clover/platform-api/versions/08da265101a3/schema)