Skip to content

Applications API

Groups multiple sources under a single application (e.g. payments-api) with an environment and a host allow-list.

Endpoint Summary

Method Path Description
GET /api/applications List applications (with enrichment)
GET /api/applications/{app_id} Get a single application
POST /api/applications Create an application
DELETE /api/applications/{app_id} Delete application + linked sources/data

List Applications

GET /api/applications

Returns applications ordered by name, enriched with:

Enrichment Description
sources Names of linked sources
unique_events Count of unique events across those sources 
[
  {
    "id": "3f3d2d5a-…",
    "name": "payments-api",
    "environment": "prod",
    "hosts": ["payments-01", "payments-02"],
    "sources": ["prom-prod"],
    "unique_events": 482113
  }
]

Get Application

GET /api/applications/{app_id}

Same enrichment as the list endpoint for a single UUID.

Errors

Code HTTP When
— 404 Application not found

Create Application

POST /api/applications
Field Type Required Description
name string yes Unique name
environment string no dev, staging, prod, …
hosts string[] no Host allow-list

Errors

Code HTTP When
application_name_conflict 409 Same name already exists

Delete Application

DELETE /api/applications/{app_id}

Cascades:

  1. Events for all linked sources
  2. Alerts for all linked sources
  3. The sources themselves
  4. The application row