Developers

API Documentation Overview

Authentication

Most API endpoints require authentication using a Bearer token. Generate your API token from your account settings.

Incidents API

Manage incidents via the REST API:

• GET /api/v1/incidents — List incidents (params: status, assignee_id, per_page)
• POST /api/v1/incidents — Create incident (body: subject, description, priority_id, status)
• GET /api/v1/incidents/{id} — Get incident
• PUT /api/v1/incidents/{id} — Update incident
• DELETE /api/v1/incidents/{id} — Delete incident

Web interface: Incidents

Monitor Integration Webhook

Receive monitoring alerts to auto-create incidents. Configure your monitoring tool to POST to:

• POST https://itsm.srvdesk.com/api/webhooks/monitor-alerts
• Auth: Bearer token in Authorization header. Use your API token from account settings.
• Payload: event, monitoring_incident_id, resource_type, resource_id, message, status, triggered_at, resolved_at, details, alert_rule.
• On status=open: creates incident. On status=resolved: updates linked incident.

Example API Request

GET https://itsm.srvdesk.com/api/v1/status

{
  "message": "Online.",
  "status": 200
}