---
title: "POST /v1/probe-task-actions/ping"
method: POST
path: "/v1/probe-task-actions/ping"
tags: ["ProbeTask"]
---

# POST /v1/probe-task-actions/ping

`POST /v1/probe-task-actions/ping`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- JadeTreeApiV1CreatePingProbeTasksRequest
  - `sourceMachineUids` string[]
  - `targetMachineUids` string[]
  - `timeoutSeconds` integer

## Response `200`

OK

- JadeTreeApiV1DispatchCreateProbeTasksReply
  - `total` string
  - `success` string
  - `failed` string
  - `createdCount` string
  - `items` JadeTreeApiV1DispatchCreateProbeTaskResultItem[]
    - `machineUid` string
    - `machineUuid` string
    - `hostName` string
    - `localIp` string
    - `endpoint` string
    - `createdCount` string
    - `error` string

## Changes

- **2026-07-17** `7c1198712e80`: 1 info
  - endpoint added
- **2026-03-31** `78c6a8306f65`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/aide-family/apis/aide-family-jade-tree-api/changes/v1/probe-task-actions/ping/post.md)

---

[API](https://skmtc.dev/aide-family/apis/aide-family-jade-tree-api.md) - [All operations](https://skmtc.dev/aide-family/apis/aide-family-jade-tree-api/llms.txt) - [OpenAPI document](https://skmtc.dev/aide-family/apis/aide-family-jade-tree-api/revisions/7c1198712e80?raw)