---
title: "Agent Subscribe"
method: POST
path: "/api/v1/agents/subscribe"
tags: ["Agent Intelligence"]
---

# Agent Subscribe

`POST /api/v1/agents/subscribe`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/agents/subscribe`
- Auth: none declared

Subscribe to real-time alerts for locations and hazard types.

Wraps the existing webhook delivery system. When an event matches,
a signed webhook is sent to your callback_url.

## Query parameters

- `x_api_key` string, nullable

## Request body

- ApiAgentIntelligenceSubscribeRequest: Agent alert subscription.
  - `event_types` string[], required
  - `callback_url` string, required: HTTPS webhook URL
  - `lat` number, nullable
  - `lon` number, nullable
  - `radius_km` number, nullable
  - `min_severity` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)