/trend"
```
### Response (200)
```json theme={"theme":"monokai"}
{
"points": [
{
"timestamp": "2026-03-31T17:02:08.056090",
"batch_id": "a863a595-5aaf-45d3-89a9-073a73d59671",
"count": 1875,
"cumulative": 1875
}
],
"total_results": 1875,
"last_results": "2026-03-31T17:02:08.056090"
}
```
### Trend Point Fields
| Field | Type | Description |
| - | - | - |
| `timestamp` | datetime | When the batch was processed. |
| `batch_id` | UUID | The media batch that was evaluated. |
| `count` | integer | Number of new items matching the view filters in this batch. |
| `cumulative` | integer | Running total of all matching items across all evaluated batches. |
Returns HTTP 400 if monitoring is not enabled for the view. Returns HTTP 404 if the view does not exist or does not belong to the specified dataset.
***
## Enable or Disable Alerting
Control whether a monitored view sends alert notifications when new matches are detected. Monitoring (trend data collection) continues regardless of this setting.
```http theme={"theme":"monokai"}
POST /api/v1/dataset/{dataset_id}/views/{view_id}/alerting
Authorization: Bearer
Content-Type: application/json
```
### Parameters
| Parameter | Location | Type | Required | Description |
| - | - | - | - | - |
| `dataset_id` | path | UUID | Yes | The dataset the view belongs to. |
| `view_id` | path | UUID | Yes | The view to configure alerting for. |
| `enabled` | body (JSON) | boolean | Yes | `true` to enable alerts, `false` to disable. |
### Request Body
```json theme={"theme":"monokai"}
{
"request": {
"enabled": true
}
}
```
The `enabled` field is nested inside a `request` object in the JSON body.
### Example
```bash theme={"theme":"monokai"}
# Disable alerting
curl -X POST \
-H "Authorization: Bearer " \
-H "Content-Type: application/json" \
-d '{"request": {"enabled": false}}' \
"https://app.visual-layer.com/api/v1/dataset//views//alerting"
```
### Response (200)
```json theme={"theme":"monokai"}
{
"alerting_enabled": false
}
```
***
## Python Example
```python theme={"theme":"monokai"}
import requests
VL_BASE_URL = "https://app.visual-layer.com"
JWT_TOKEN = ""
DATASET_ID = ""
headers = {"Authorization": f"Bearer {JWT_TOKEN}"}
# Create a view
resp = requests.post(
f"{VL_BASE_URL}/api/v1/dataset/{DATASET_ID}/views",
headers=headers,
params={"entity_type": "IMAGES", "threshold": 0},
data={"name": "Damaged windshields"},
)
resp.raise_for_status()
view = resp.json()
view_id = view["id"]
print(f"Created view: {view_id}")
print(f" Monitoring: {view['monitoring_enabled']}")
print(f" Alerting: {view['alerting_enabled']}")
# List views
resp = requests.get(
f"{VL_BASE_URL}/api/v1/dataset/{DATASET_ID}/views",
headers=headers,
)
resp.raise_for_status()
views = resp.json()["views"]
for v in views:
print(f" {v['name']} — {v['total_results']} results, alerting={v['alerting_enabled']}")
# Get trend data
resp = requests.get(
f"{VL_BASE_URL}/api/v1/dataset/{DATASET_ID}/views/{view_id}/trend",
headers=headers,
)
resp.raise_for_status()
trend = resp.json()
print(f"Trend: {len(trend['points'])} data points, {trend['total_results']} total results")
# Disable alerting (keep monitoring active)
resp = requests.post(
f"{VL_BASE_URL}/api/v1/dataset/{DATASET_ID}/views/{view_id}/alerting",
headers=headers,
json={"request": {"enabled": False}},
)
resp.raise_for_status()
print(f"Alerting: {resp.json()['alerting_enabled']}")
# Delete a view
resp = requests.delete(
f"{VL_BASE_URL}/api/v1/dataset/{DATASET_ID}/views/{view_id}",
headers=headers,
)
resp.raise_for_status()
print(f"Deleted view: {view_id}")
```
***
## Response Codes
See [Error Handling](/api-reference/errors) for the error response format and Python handling patterns.
### Views Endpoints
| HTTP Code | Meaning | Common Cause |
| - | - | - |
| **200** | Request successful. | |
| **400** | Bad request. | Monitoring not enabled for the view (trend/alerting endpoints). |
| **401** | Unauthorized. | Invalid or expired JWT token. |
| **404** | Not found. | Dataset or view does not exist, or the view does not belong to the specified dataset. |
| **422** | Validation error. | Missing required fields or malformed request body. |
| **500** | Internal server error. | Contact support if this persists. |
***
## Best Practices
* **Create views before adding media.** Monitoring evaluates only batches that arrive after the view was created. Views created after a media addition do not retroactively evaluate older batches.
* **Use descriptive view names.** View names appear in alert notifications and trend charts. Clear names like "Damaged windshields" or "Mislabeled training data" make alerts immediately actionable.
* **Disable alerting for informational views.** If a view tracks long-term trends but does not require immediate attention, disable alerting to reduce notification noise while keeping trend data collection active.
* **Poll trend data for dashboards.** The trend endpoint returns cumulative counts suitable for building monitoring dashboards. Poll periodically after batch additions to track data quality over time.
* **Delete unused views.** Each view is evaluated on every batch addition. Removing views that are no longer needed reduces processing overhead.
***
## Related Resources
List, read, and manage alert notifications delivered by monitored views.
Create and manage saved views through the Visual Layer UI.
Understand how monitoring and alerting works across your datasets.
Add media to datasets, triggering monitoring evaluation on all views.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.