Is possible to create an alert via http request?

[liyujun-dev]

Hey guys!
I want to create an alert event via http request. How should I do for this?

[dosubot[bot]]

Hi @liyujun-dev! I'm Dosu and I’m helping the keep team.

Yes, you can create an alert event in Keep via an HTTP POST request to the /event endpoint. The payload should be in the format of an AlertDto object (or a list of them), which represents the alert details. This endpoint requires authentication with an entity that has the write:alert permission. The authentication method depends on your deployment (JWT, API key, or no authentication in dev mode) — see the authentication overview for details.

Here’s the relevant endpoint and requirements:

• Endpoint: POST /event
• Payload: JSON body matching the AlertDto schema (fields like name, status, severity, etc.)
• Authentication: Bearer token (JWT) or API key, depending on your setup. In NOAUTH mode, any API key is accepted — see no-auth docs.
• Response: JSON with a task_name and HTTP 202 status on success

You can also use /event/{provider_type} if you want to specify a provider. The system supports both single and bulk alert ingestion citation.

If you need the exact JSON schema for AlertDto or an example payload, let me know!

To reply, just mention @dosu.

---

^{How did I do? Good | Irrelevant | Incorrect | Verbose | Hallucination | Report 🐛 | Other}