---
title: "Report execution telemetry for a session."
method: POST
path: "/sessions/{session_id}/report-event"
---

# Report execution telemetry for a session.

`POST /sessions/{session_id}/report-event`

## Request

- Base URL: `https://api.nexalayer.net/v1`
- URL: `https://api.nexalayer.net/v1/sessions/{session_id}/report-event`
- Auth: API key in header `X-API-Key`

## Path parameters

- `session_id` string, required

## Request body

- TelemetryEvent
  - `event_type` 'success' | 'http_error' | 'captcha' | 'timeout' | 'block' | 'rate_limit' | 'custom', required
  - `status_code` integer
  - `target_host` string
  - `latency_ms` integer
  - `error_message` string
  - `metadata` object

## Response `200`

Event recorded.

---

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