---
title: "Send a test message to every live session of the current user"
method: POST
path: "/v2/live/test-push"
tags: ["Live Api Service"]
---

# Send a test message to every live session of the current user

`POST /v2/live/test-push`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/live/test-push`
- Auth: none declared

## Request body

- LivePushRequestDto: Test message to send to every live session of the current user
  - `text` string: Text to send, up to 1000 characters

## Response `200`

Message sent; how many sessions it reached on the node that answered

- JsonOkResponseLivePushResultDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` LivePushResultDto: How many live sessions the test message reached
    - `deliveredSessions` integer: Sessions of the current user on the node that served the request

## Other responses

- `400`: Blank text or longer than 1000 characters
- `403`: The request is not an interactive user session
- `404`: The live channel is not enabled
- `429`: Too many test pushes

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/aea9d9a8415a?raw)