---
title: "Report a lifecycle moment a plugin detected on the site it runs on."
method: POST
path: "/wp-event"
---

# Report a lifecycle moment a plugin detected on the site it runs on.

`POST /wp-event`

## Request

- Base URL: `https://app.seomatic.ai/api/v1`
- URL: `https://app.seomatic.ai/api/v1/wp-event`
- Auth: HTTP bearer

For facts only the site itself can see (for example robots.txt blocking AI crawlers, which is read from the site's own filesystem rather than guessed from outside). The event name is validated against a known set; unlisted events are rejected rather than silently recorded.

## Request body

- object
  - `event` string, required: The lifecycle event name (known set).
  - `agents` string[]: Blocked user-agents, where applicable.
  - `rule` string: The robots.txt rule line, where applicable.

## Response `200`

Recorded

## Other responses

- `400`: Unknown event or invalid payload

---

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