# Agent Ping API

**Canonical:** https://apis.io/apis/agentping-io/agentping-io-api/  
**Provider:** Agent Ping — https://apis.io/providers/agentping-io/  
**Base URL:** https://eu.ingest.agentping.io  
**Documentation:** https://agentping.io/docs/api/auth

Agent Ping API is one of 2 APIs that [Agent Ping](https://apis.io/providers/agentping-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Agent Ping API as documented publicly: 15 operations. Contract generated from the documentation by API Evangelist (2026-11-01); not the provider's own document.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/` | GET / |
| GET | `/v1` | GET /v1 |
| POST | `/v1` | POST /v1 |
| GET | `/v1/agents` | Every agent on the team with rolled-up health. |
| POST | `/v1/heartbeats` | Errors |
| GET | `/v1/ping` | GET /v1/ping |
| POST | `/v1/ping` | POST /v1/ping |
| GET | `/v1/runs` | List runs newest-first. |
| POST | `/v1/runs` | Start a new run. |
| GET | `/v1/runs/{id}` | One run, in full. |
| GET | `/v1/runs/{id}/evaluation` | The run's evaluation in the public shape, with internal stages collapsed to a single evaluation type. |
| GET | `/v1/runs/{id}/events` | The run's events in timestamp order (up to 1000). |
| POST | `/v1/runs/{id}/events` | Append one or more events to an in-flight run. |
| GET | `/v1/runs/{id}/events/{eventid}/payload` | The full event payload, fetched from the payload store when one exists, otherwise the inline copy. |
| POST | `/v1/runs/{id}/finish` | Close out a run with a terminal status. |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/agentping-io/openapi/_ae-authored/agentping-io-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/agentping-io/json-schema/agentping-io-post-v1-runs-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentping-io/json-schema/agentping-io-post-v1-runs-id-events-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentping-io/json-schema/agentping-io-get-v1-runs-id-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentping-io/json-schema/agentping-io-post-v1-runs-id-finish-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentping-io/json-schema/agentping-io-post-v1-runs-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/agentping-io/json-schema/agentping-io-post-v1-ping-request-schema.json

## Other Agent Ping APIs (1)

- [Agent Ping API](https://apis.io/apis/agentping-io/agent-ping-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/agentping-io/agentping-io-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/agentping-io/.