Alerty API

Name: Alerty API API
Brand: Alerty API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentDeveloper ToolsMonitoring Observabilitybearer, apiKey52 EndpointsREST

For Agents

Query logs, metrics, and traces, manage monitors and incidents, and chat with Alerty's AI over your observability data through 52 endpoints.

Quickstart

Get started with Alerty API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"query logs in Alerty"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Alerty API API.

Run a logs, metrics, or traces query against ingested telemetry via /query/logs, /query/metrics, and /query/traces

Create and manage monitors that watch for conditions in observability data

Open, update, and resolve incidents tied to monitor breaches

Manage organisation membership, invitations, and integrations such as Slack

GET STARTED

Start building with Alerty API API

Explore with Jentic

View OpenAPI Document

Use for: I need to query application logs for errors in the last hour, Run a metric query against an Alerty workspace, Create a new monitor that alerts when error rate exceeds a threshold, Open an incident in Alerty when a deploy starts failing

Not supported: Does not handle telemetry ingestion agents, on-call paging escalation, or status page hosting — use for querying Alerty-ingested logs, metrics, traces, and managing incidents and monitors only.

Jentic publishes the only available OpenAPI document for Alerty API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Alerty API, keeping it validated and agent-ready. Alerty is a developer monitoring platform that combines logs, metrics, traces, monitors, and incident management with an AI chat interface. The REST API exposes endpoints for organisation and member management, integrations (such as Slack), monitor and incident lifecycle, telemetry queries against logs/metrics/traces, inventory of detected services, and a chat interface for asking questions about observability data. Authentication uses a bearer token; some endpoints also accept a session cookie.

Use Cases

Patterns agents use Alerty API API for, with concrete tasks.

★ AI-assisted incident triage

An on-call agent receives an alert and immediately POSTs to /chat to start a conversation with the Alerty AI, then sends follow-up messages via /chat/{id}/message asking for a summary of recent error spikes. The chat references underlying logs and metrics, so the engineer gets a contextual triage report without writing query strings by hand.

POST /chat to start a conversation, then POST /chat/{id}/message with a triage prompt describing the alert and the affected service

Programmatic log query for SRE automation

An SRE pipeline runs nightly checks for error log patterns by POSTing to /query/logs with filter expressions and a time range, then writes the result counts to a status board. Because the API returns structured results, the same pipeline can also drive automated rollbacks when error counts cross a threshold.

POST /query/logs with the service filter and timeframe, parse the count, and trigger the rollback workflow when the threshold is exceeded

Incident lifecycle automation

A deploy pipeline opens an incident in Alerty when a release fails health checks, posts updates from the deploy logs, and closes the incident once the rollback succeeds. The integration uses the incident endpoints alongside monitor lookups so the team has a single timeline of every release event without manual ticket entry.

POST to the incident create endpoint with the failing service, PATCH the incident as the rollback progresses, then close it once health checks pass

Agent-driven observability lookup through Jentic

A Jentic agent answers questions like 'what services are deployed in production?' by calling the Alerty inventory endpoint and filtering by environment. The same agent can chain a metrics query if the user asks 'and which one had the highest error rate yesterday?'. The bearer token stays in the Jentic vault.

Search Jentic for 'list services in Alerty inventory', execute the inventory endpoint, then chain POST /query/metrics with an error rate expression for the top services

Key Endpoints

52 endpoints — jentic publishes the only available openapi specification for alerty api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

POST

/query/logs

Query logs

POST

/query/metrics

Query metrics

POST

/chat

Create a chat conversation

POST

/chat/{id}/message

Send a chat message

GET

/integration

List integrations

POST

/integration/{id}/test

Trigger a test for an integration

POST

/organization/{id}/invitation

Invite a member to an organisation

POST

/query/logs

Query logs

POST

/query/metrics

Query metrics

POST

/chat

Create a chat conversation

POST

/chat/{id}/message

Send a chat message

GET

/integration

List integrations

POST

/integration/{id}/test

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The Alerty bearer token is stored encrypted in the Jentic credential vault and injected as the Authorization header at execution time. The agent never sees the raw token in its context.

Intent-based discovery

Agents search Jentic by intent (e.g. 'query logs in Alerty', 'open an incident'), and Jentic returns the matching Alerty operation with its input schema for direct execution.

Time to first call

Direct Alerty integration: 2-3 days to wire auth, query payloads, and incident lifecycle. Through Jentic: under an hour with search, load, and execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Anthropic Messages API

Use Anthropic Messages alongside Alerty's chat API to add custom reasoning or summarisation outside the Alerty workspace

Use Anthropic Messages when the agent needs to reason over multiple data sources at once; use Alerty chat when the question is specifically about Alerty-ingested telemetry

Complementary

OpenAI API

Pair with Alerty when an agent needs to format observability output for users in natural language

Use OpenAI alongside Alerty when transforming raw query results into a user-facing report

Alternative

Hugging Face Inference API

Use Hugging Face hosted models for log classification when an Alerty subscription is not available

Choose Hugging Face inference for ad-hoc telemetry classification; choose Alerty for a managed monitoring workspace with native incident management

FAQs

Specific to using Alerty API API through Jentic.

Why is there no official OpenAPI spec for Alerty API?

Alerty does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Alerty API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Alerty API use?

Alerty uses an HTTP bearer token in the Authorization header for programmatic access; certain endpoints also accept a __lumos_session cookie for browser flows. Jentic stores the bearer token encrypted in its credential vault and injects it at execution time.

Can I run a logs query against Alerty programmatically?

Yes. POST /query/logs with your filter expression, a time range, and any pagination parameters. Alerty returns structured rows you can drive into automation, dashboards, or downstream alerts.

What are the rate limits for the Alerty API?

The OpenAPI spec does not declare rate limits. Alerty enforces them server-side based on workspace plan; throttle long-running query and chat workflows and check for 429 responses.

How do I start an Alerty AI chat conversation through Jentic?

Search Jentic for 'start an alerty chat conversation', execute POST /chat to create the conversation, then POST /chat/{id}/message to send the question. Jentic returns the assistant's response without the bearer token leaving the vault.

Can I open and close incidents with the Alerty API?

Yes. The incident endpoints let you create incidents tied to a monitor or service, post updates as the situation evolves, and resolve the incident when the issue is fixed. This lets a deploy pipeline keep an end-to-end timeline in Alerty automatically.