---
title: "POST /v1/probe-tasks"
method: POST
path: "/v1/probe-tasks"
tags: ["ProbeTask"]
---

# POST /v1/probe-tasks

`POST /v1/probe-tasks`

## Request

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

## Request body

- JadeTreeApiV1CreateProbeTaskRequest
  - `type` string
  - `host` string
  - `port` string
  - `url` string
  - `name` string
  - `status` integer
  - `timeoutSeconds` integer

## Response `200`

OK

- JadeTreeApiV1ProbeTaskItem
  - `uid` string
  - `type` string
  - `host` string
  - `port` string
  - `url` string
  - `name` string
  - `status` integer
  - `timeoutSeconds` integer
  - `createdAt` string
  - `updatedAt` string

## Changes

- **2026-04-01** `831adf6dc894`: 2 warning, 2 info
  - removed the request property `enabled`
  - removed the optional property `enabled` from the response with the `200` status
  - added the new optional request property `status`
  - added the optional property `status` to the response with the `200` status
- **2026-04-01** `c3464d41fb3e`: 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-tasks/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)