---
title: "Record Report Failure"
method: POST
path: "/sites/{site_id}/reports/failures"
tags: ["business-reports"]
---

# Record Report Failure

`POST /sites/{site_id}/reports/failures`

## Request

- Base URL: `https://api.xeorank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.xeorank.com/sites/{site_id}/reports/failures`
- Auth: API key in header `X-Agent-Key`

Persist a scheduled generation failure so it remains visible in history.

## Path parameters

- `site_id` string, uuid, required

## Query parameters

- `email` string, nullable

## Request body

- FailedReportRequest
  - `period_type` string, required
  - `period_start` string, date-time, required
  - `period_end` string, date-time, required
  - `error` string, required
  - `timezone` string

## Response `200`

Successful Response

- ReportOut
  - `id` string, uuid, required
  - `site_id` string, uuid, required
  - `period_type` string, required
  - `period_start` string, date-time, required
  - `period_end` string, date-time, required
  - `status` string, required
  - `gsc_data` object, nullable
  - `ga_data` object, nullable
  - `shopify_data` object, nullable
  - `keyword_funnel` object, nullable
  - `traffic_insights` object, nullable
  - `report_metadata` object, nullable
  - `source_status` object, nullable
  - `narrative` string, nullable
  - `highlights` unknown[], nullable
    - unknown
  - `recommendations` unknown[], nullable
    - unknown
  - `email_sent_at` string, date-time, nullable
  - `delivery_status` string, nullable
  - `delivery_error` string, nullable
  - `created_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/xeorank/apis/seo-intelligence-engine.md) · [All operations](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/xeorank/apis/seo-intelligence-engine/revisions/449a3fd73454?raw)