GraphQL API

Authorization: Bearer <%= @sample_token %>

POST https://app.towerops.net/api/graphql

curl -X POST https://app.towerops.net/api/graphql \
  -H "Authorization: Bearer <%= @sample_token %>" \
  -H "Content-Type: application/json" \
  <%= raw(~S|-d '{"query": "{ devices { id name ipAddress status } }"}'|) %>

<%= raw(~S[{
  devices(siteId: "uuid", status: "up") {
    id
    name
    ipAddress
    status
    lastCheckedAt
    monitoringEnabled
    snmpEnabled
    deviceRole
    site {
      id
      name
      location
    }
  }
}]) %>

<%= raw(~S[{
  device(id: "device-uuid") {
    id
    name
    ipAddress
    status
    description
    snmpVersion
    snmpPort
    checkIntervalSeconds
    site { id name }
  }
}]) %>

<%= raw(~S[{
  sites {
    id
    name
    description
    location
    snmpVersion
    snmpCommunity
    insertedAt
  }
}]) %>

<%= raw(~S[{ site(id: "site-uuid") { id name location } }]) %>

<%= raw(~S[{
  alerts(status: "active", limit: 10) {
    id
    alertType
    message
    triggeredAt
    acknowledgedAt
    resolvedAt
    deviceId
    device {
      id
      name
      ipAddress
    }
    acknowledgedByEmail
  }
}]) %>

<%= raw(~S[{
  agents {
    id
    name
    enabled
    lastSeenAt
    lastIp
    isCloudPoller
    deviceCount
    metadata
  }
}

# Single agent
{ agent(id: "agent-uuid") { id name enabled deviceCount } }]) %>

<%= raw(~S[{
  organization {
    id
    name
    slug
    subscriptionPlan
    useSites
    snmpVersion
    snmpCommunity
    snmpPort
    snmpTransport
    mikrotikEnabled
    mikrotikUsername
    mikrotikPort
    mikrotikUseSsl
    defaultAgentTokenId
  }
}]) %>

<%= raw(~S[{
  members {
    id
    email
    role
    insertedAt
  }
}]) %>

<%= raw(~S[{
  integrations {
    id
    provider
    enabled
    syncIntervalMinutes
    lastSyncedAt
    lastSyncStatus
  }
}]) %>

<%= raw(~S[{
  activity(limit: 20) {
    summary
    detail
    timestamp
    severity
    deviceName
    siteName
    link
    type
  }
}]) %>

<%= raw(~S[{
  deviceMetrics(deviceId: "device-uuid", timeRange: "48h") {
    timestamp
    value
    status
    checkName
    checkType
  }
}]) %>

<%= raw(~S[{
  deviceInterfaces(deviceId: "device-uuid") {
    id
    ifIndex
    ifName
    ifDescr
    ifType
    ifSpeed
    ifAdminStatus
    ifOperStatus
    ifAlias
  }
}]) %>

<%= raw(~S[{
  deviceSensors(deviceId: "device-uuid") {
    id
    sensorType
    sensorUnit
    sensorDescr
    currentValue
    lastCheckedAt
    monitored
  }
}]) %>

<%= raw(~S[{
  sensorReadings(sensorId: "sensor-uuid", timeRange: "24h") {
    sensorId
    value
    status
    checkedAt
  }
}]) %>

<%= raw(~S[{
  interfaceTraffic(interfaceId: "interface-uuid", timeRange: "24h") {
    timestamp
    inBps
    outBps
    inErrors
    outErrors
  }
}]) %>

<%= raw(~S[{
  checkResults(checkId: "check-uuid", timeRange: "1h") {
    checkId
    value
    status
    checkedAt
    responseTimeMs
  }
}]) %>

<%= raw(~S[{
  checks(checkType: "http", deviceId: "device-uuid") {
    id
    name
    checkType
    enabled
    intervalSeconds
    currentState
    config
  }
}]) %>

<%= raw(~S[{
  check(id: "check-uuid") {
    id
    name
    checkType
    config
    currentState
    currentStateType
    lastCheckAt
  }
}]) %>

<%= raw(~S[{
  schedules {
    id
    name
    timezone
    description
  }
}]) %>

<%= raw(~S[{
  schedule(id: "schedule-uuid") {
    id
    name
    timezone
    layers {
      id
      name
      position
      rotationType
      members {
        userId
        position
      }
    }
    overrides {
      id
      userId
      startTime
      endTime
    }
  }
}]) %>

<%= raw(~S[{
  onCall(scheduleId: "schedule-uuid") {
    userId
    email
  }
}]) %>

<%= raw(~S[{
  escalationPolicies {
    id
    name
    description
    repeatCount
    repeatIntervalMinutes
  }
}]) %>

<%= raw(~S[{
  escalationPolicy(id: "policy-uuid") {
    id
    name
    rules {
      id
      position
      delayMinutes
      targets {
        id
        targetType
        userId
        scheduleId
      }
    }
  }
}]) %>

<%= raw(~S[{
  maintenanceWindows(filter: "upcoming") {
    id
    name
    startsAt
    endsAt
    suppressAlerts
    siteId
    deviceId
  }
}]) %>

<%= raw(~S[mutation {
  createDevice(input: {
    ipAddress: "192.168.1.1"
    name: "Core Router"
    siteId: "site-uuid"
    snmpEnabled: true
    snmpVersion: "2c"
    snmpCommunity: "public"
  }) {
    id
    name
    ipAddress
    status
  }
}]) %>

<%= raw(~S[mutation {
  updateDevice(id: "device-uuid", input: {
    name: "Updated Router"
    monitoringEnabled: false
  }) {
    id
    name
    monitoringEnabled
  }
}]) %>

<%= raw(~S[mutation {
  deleteDevice(id: "device-uuid") {
    success
    message
  }
}]) %>

<%= raw(~S[mutation {
  createSite(input: {
    name: "Main Office"
    location: "New York, NY"
    snmpCommunity: "public"
  }) {
    id
    name
    location
  }
}]) %>

<%= raw(~S[mutation {
  acknowledgeAlert(id: "alert-uuid") {
    id
    acknowledgedAt
    acknowledgedByEmail
  }
}]) %>

<%= raw(~S[mutation {
  resolveAlert(id: "alert-uuid") {
    id
    resolvedAt
  }
}]) %>

<%= raw(~S[mutation {
  createAgent(name: "DC1 Agent") {
    id
    name
    token
  }
}]) %>

<%= raw(~S[mutation { deleteAgent(id: "agent-uuid") { success message } }]) %>

<%= raw(~S[mutation {
  updateOrganization(input: {
    name: "My Network"
    useSites: true
    snmpVersion: "2c"
    snmpCommunity: "public"
    mikrotikEnabled: true
    mikrotikUsername: "admin"
    mikrotikPort: 8729
    mikrotikUseSsl: true
  }) {
    id
    name
    useSites
    snmpVersion
    mikrotikEnabled
  }
}]) %>

<%= raw(~S[mutation {
  sendInvitation(email: "user@example.com", role: "admin") {
    id
    email
    role
    expiresAt
  }
}]) %>

<%= raw(~S[mutation {
  updateMemberRole(id: "user-uuid", role: "admin") {
    id
    email
    role
  }
}]) %>

<%= raw(~S[mutation { removeMember(id: "user-uuid") { success message } }
mutation { cancelInvitation(id: "invitation-uuid") { success message } }]) %>

<%= raw(~S[mutation {
  createIntegration(input: {
    provider: "preseem"
    enabled: true
    credentials: "{\"api_key\": \"xxx\"}"
    syncIntervalMinutes: 10
  }) {
    id
    provider
    enabled
  }
}]) %>

<%= raw(~S[mutation {
  testIntegration(id: "integration-uuid") {
    success
    message
  }
}]) %>

<%= raw(~S[mutation {
  createCheck(input: {
    name: "API health"
    checkType: "http"
    deviceId: "device-uuid"
    intervalSeconds: 60
    config: {url: "https://api.example.com/health", method: "GET"}
  }) {
    id
    name
    checkType
  }
}]) %>

<%= raw(~S[mutation {
  updateCheck(id: "check-uuid", input: {intervalSeconds: 30}) {
    id
    intervalSeconds
  }
}

mutation {
  deleteCheck(id: "check-uuid") {
    success
  }
}]) %>

<%= raw(~S[mutation {
  createSchedule(input: {
    name: "Primary on-call"
    timezone: "America/Chicago"
  }) {
    id
    name
  }
}

mutation {
  updateSchedule(id: "schedule-uuid", input: {description: "Weekly rotation"}) {
    id
    description
  }
}

mutation {
  deleteSchedule(id: "schedule-uuid") {
    success
  }
}]) %>

<%= raw(~S[mutation {
  createLayer(scheduleId: "schedule-uuid", input: {
    name: "Primary"
    position: 0
    rotationType: "weekly"
    rotationInterval: 1
    handoffTime: "09:00:00"
    startDate: "2026-06-01T00:00:00Z"
  }) {
    id
  }
}

mutation {
  addLayerMember(layerId: "layer-uuid", userId: "user-uuid", position: 0) {
    id
  }
}

mutation {
  removeLayerMember(id: "member-uuid") {
    success
  }
}]) %>

<%= raw(~S[mutation {
  createOverride(scheduleId: "schedule-uuid", input: {
    userId: "user-uuid"
    startTime: "2026-06-07T17:00:00Z"
    endTime:   "2026-06-09T09:00:00Z"
  }) {
    id
  }
}

mutation {
  deleteOverride(id: "override-uuid") {
    success
  }
}]) %>

<%= raw(~S[mutation {
  createEscalationPolicy(input: {
    name: "Critical alerts"
    repeatCount: 3
    repeatIntervalMinutes: 15
  }) {
    id
    name
  }
}

mutation {
  updateEscalationPolicy(id: "policy-uuid", input: {name: "Critical alerts (revised)"}) {
    id
  }
}

mutation {
  deleteEscalationPolicy(id: "policy-uuid") {
    success
  }
}]) %>

<%= raw(~S[mutation {
  createEscalationRule(escalationPolicyId: "policy-uuid", input: {
    position: 0
    delayMinutes: 5
  }) {
    id
  }
}

mutation {
  createEscalationTarget(escalationRuleId: "rule-uuid", input: {
    targetType: "schedule"
    scheduleId: "schedule-uuid"
  }) {
    id
  }
}

mutation {
  deleteEscalationTarget(id: "target-uuid") {
    success
  }
}]) %>

<%= raw(~S[mutation {
  createMaintenanceWindow(input: {
    name: "Quarterly firmware roll"
    startsAt: "2026-06-01T05:00:00Z"
    endsAt:   "2026-06-01T09:00:00Z"
    siteId: "site-uuid"
    suppressAlerts: true
  }) {
    id
    name
  }
}

mutation {
  updateMaintenanceWindow(id: "window-uuid", input: {endsAt: "2026-06-01T10:00:00Z"}) {
    id
    endsAt
  }
}

mutation {
  deleteMaintenanceWindow(id: "window-uuid") {
    success
  }
}]) %>

<%= raw(~S[// JavaScript example using @absinthe/socket
import { Socket as PhoenixSocket } from "phoenix";
import * as AbsintheSocket from "@absinthe/socket";

const phoenixSocket = new PhoenixSocket(
  "wss://app.towerops.net/socket/graphql",
  { params: { token: "your-api-token" } }
);
const absintheSocket = AbsintheSocket.create(phoenixSocket);]) %>

<%= raw(~S[subscription {
  deviceStatusChanged(deviceId: "device-uuid") {
    deviceId
    deviceName
    status
    changedAt
  }
}

# Or subscribe to all devices in your organization:
subscription {
  deviceStatusChanged {
    deviceId
    deviceName
    status
    changedAt
  }
}]) %>

<%= raw(~S[subscription {
  alertEvent {
    alertId
    alertType
    severity
    message
    deviceId
    eventType
    triggeredAt
  }
}]) %>

<%= raw(~S[subscription {
  sensorReadingsUpdated(deviceId: "device-uuid") {
    deviceId
    deviceName
    readings {
      sensorId
      sensorType
      sensorDescr
      sensorUnit
      value
      checkedAt
    }
  }
}]) %>

curl -X POST https://app.towerops.net/api/graphql \
  -H "Authorization: Bearer <%= @sample_token %>" \
  -H "Content-Type: application/json" \
  <%= raw(~S|-d '{"query": "{ devices { id name ipAddress status site { id name location } } }"}'|) %>

curl -X POST https://app.towerops.net/api/graphql \
  -H "Authorization: Bearer <%= @sample_token %>" \
  -H "Content-Type: application/json" \
  <%= raw(~S|-d '{"query": "{ alerts(status: \"active\") { id alertType message triggeredAt device { name ipAddress } } }"}'|) %>

curl -X POST https://app.towerops.net/api/graphql \
  -H "Authorization: Bearer <%= @sample_token %>" \
  -H "Content-Type: application/json" \
  <%= raw(~S|-d '{"query": "mutation { createDevice(input: { ipAddress: \"192.168.1.1\", name: \"Core Router\", snmpEnabled: true }) { id name status } }"}'|) %>

curl -X POST https://app.towerops.net/api/graphql \
  -H "Authorization: Bearer <%= @sample_token %>" \
  -H "Content-Type: application/json" \
  <%= raw(~S|-d '{"query": "mutation { acknowledgeAlert(id: \"alert-uuid\") { id acknowledgedAt } }"}'|) %>

curl -X POST https://app.towerops.net/api/graphql \
  -H "Authorization: Bearer <%= @sample_token %>" \
  -H "Content-Type: application/json" \
  <%= raw(~S|-d '{"query": "query GetDevice($id: ID!) { device(id: $id) { id name ipAddress status site { name } } }", "variables": {"id": "device-uuid"}}'|) %>