ECM REST API

Alerts, events, entities, and more — reachable over HTTP.

RightITnow ECM features a REST API that exposes alert, event, entity, entity group, user, and maintenance window management operations, and more.

Try it yourself

Test the API against our demo system

The full REST API documentation is available here.

To try out the REST API against the demo system from the documentation itself, use the administrator user's credentials when authorizing:

  administrator / 99f98969172eb1a31c303291c388f6863fff9a1288cfd1cb848f96b4e0aca223

API calls can also be tested using curl, for example:

  curl -i -X GET https://administrator:99f98969172eb1a31c303291c388f6863fff9a1288cfd1cb848f96b4e0aca223@demo.rightitnow.com/rightitnow/restapi/alerts/523
Capabilities

What the API is for

Alert, event, entity, entity group, user, and maintenance window management operations, and more.

Inject custom events

Have a monitoring source ECM doesn't natively connect to — an in-house script, a legacy system, a niche vendor tool? Post events directly and they flow into the same correlation engine as everything else.

Query alerts & entities

Pull alerts, entities, entity groups, and status programmatically — to feed a custom dashboard, a status page, or your own reporting layer.

Manage users & maintenance windows

Automate user provisioning or schedule maintenance windows programmatically, alongside building your own integrations on top of ECM.

Example

More request patterns

Representative examples — see the full reference for authentication, request/response schemas, and rate limits.

  # Push a custom event into ECM
  POST /rightitnow/restapi/events
  Authorization: Basic <credentials>
  Content-Type: application/json

  {
    "source": "custom-monitor",
    "severity": "critical",
    "summary": "DB-PROD-03 connection pool exhausted",
    "entity": "db-prod-03"
  }
  # List entity groups
  GET /rightitnow/restapi/entitygroups
  Authorization: Basic <credentials>

Full endpoint reference, authentication setup, and response schemas are in the live API documentation.

Ready to integrate?

Free for up to 100 managed entities. API access included on every plan, cloud or on-prem.