---
title: "Report"
method: POST
path: "/api/platform/auth/risk/report"
tags: ["Auth - Risk"]
---

# Report

`POST /api/platform/auth/risk/report`

## Request

- Base URL: `https://api.ascendkit.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ascendkit.dev/api/platform/auth/risk/report`
- Auth: API key in header `X-Platform-Secret`

## Request body

- AuthRiskReportRequest
  - `action` 'sign_in_email' | 'sign_up_email' | 'request_password_reset' | 'sign_in_magic_link' | 'verify_two_factor', required
  - `email` string, nullable: Optional end-user email when the auth flow is email-address based.
  - `ipAddress` string, nullable: Original client IP forwarded by the trusted auth server.
  - `userAgent` string, nullable: Original client user agent forwarded by the trusted auth server.
  - `success` boolean, required: Whether the auth step completed successfully.
  - `reason` string, nullable: Optional normalized failure reason for auditability.

## Response `200`

Successful Response

- ApiResponse
  - `data` unknown
  - `error` string, nullable
  - `meta` object, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ascendkit/apis/ascendkit-api.md) · [All operations](https://skmtc.dev/ascendkit/apis/ascendkit-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ascendkit/apis/ascendkit-api/revisions/0a41c122c44f?raw)