---
title: "Run capability probes for an agent"
method: POST
path: "/agents/{agentId}/capability-probes/run"
tags: ["Setup · Agent management"]
---

# Run capability probes for an agent

`POST /agents/{agentId}/capability-probes/run`

## Request

- Base URL: `https://api.ziggsai.com`
- URL: `https://api.ziggsai.com/agents/{agentId}/capability-probes/run`
- Auth: HTTP bearer

## Path parameters

- `agentId` string, required

## Request body

- RunCapabilityProbesDto
  - `probeStartUrl` string: Probe harness sidecar URL (the sidecar serves POST /fleet-start/:agentId)
  - `stepDelayMs` number
  - `startDelayMs` number
  - `saveResults` boolean
  - `only` string[]: Run only these capability keys

## Response `201`

Created

- CapabilityProbeRunResponseSchema (unresolved $ref)

---

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