Ingestion Warnings

For instructions on how to authenticate to use this endpoint, see API overview.

Endpoints

GET

List all ingestion warnings v2

Lists this project's ingestion warnings — events or person/group updates that were ingested with problems (oversized messages, rejected person merges, invalid data) — grouped by warning type. Each entry carries the warning's category and severity, the total count and a sparkline over the requested time range, and the most recent sample warnings with the affected event/person/group. Filter by category, type, severity or time range to drill into a specific problem.

Required API key scopes

ingestion_warning:read

Query parameters

  • category
    string
  • limit
    integer
  • order_by
    string
    One of: "count""last_seen"
  • q
    string
  • samples
    integer
  • severity
    string
    One of: "info""warning""error"
  • since
    string
  • type
    string
  • until
    string

Example request

GET /api/projects/:project_id/ingestion_warnings_v2
export POSTHOG_PERSONAL_API_KEY=[your personal api key]
curl \
    -H "Authorization: Bearer $POSTHOG_PERSONAL_API_KEY" \
    <ph_app_host>/api/projects/:project_id/ingestion_warnings_v2/

Example response

Status 200
RESPONSE
{
  "type": "string",
  "category": "string",
  "severity": "string",
  "count": 0,
  "last_seen": "2019-08-24T14:15:22Z",
  "sparkline": [
    {
      "timestamp": "2019-08-24T14:15:22Z",
      "count": 0
    }
  ],
  "samples": [
    {
      "timestamp": "2019-08-24T14:15:22Z",
      "source": "string",
      "pipeline_step": "string",
      "event_uuid": "edeeb604-9b4c-4f9d-8619-8d1d70caf94c",
      "distinct_id": "string",
      "person_id": "087e858e-473c-4f50-b5b0-c1df6c021550",
      "group_key": "string",
      "details": {}
    }
  ]
}

Community questions