API Reference — MinusNow Documentation

Quick Start

🔑

Base URL

All API requests use: https://your-instance.minusnow.com/api/v1

1. Get Your API Key

Navigate to Settings → API Keys and create a new API key.

          
# Your API key format
lqx_prod_abc123xyz789...

2. Make Your First Request

          
curl -X GET "https://your-instance.minusnow.com/api/v1/incidents" \
  -H "Authorization: Bearer lqx_prod_abc123xyz789" \
  -H "Content-Type: application/json"

3. Response Format

          
{
  "success": true,
  "data": [...],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 156
  }
}
          
        

Authentication Methods

🔑

API Keys

Long-lived keys for server-to-server integration. Best for automation scripts and backend services.

🛡

OAuth 2.0

Token-based authentication for user contexts. Ideal for web and mobile applications.

🪪

JWT Tokens

JSON Web Tokens for session management. Perfect for microservices architecture.

🏢

SAML SSO

Enterprise single sign-on integration. Seamless access with your identity provider.

Available Endpoints

⚠

Incidents

Create, update, and manage incidents. Track SLAs, assign teams, and resolve issues.

🖥

Assets

CMDB and asset management. Track hardware, software, and configuration items.

🔀

Changes

Change request management. Create, approve, and track implementation.

👥

Users

User and team management. Roles, permissions, and assignment groups.

Incidents API

Method	Endpoint	Description
GET	`/incidents`	List all incidents with pagination and filters
GET	`/incidents/:id`	Get single incident details
POST	`/incidents`	Create a new incident
PATCH	`/incidents/:id`	Update incident fields
DELETE	`/incidents/:id`	Delete an incident
POST	`/incidents/:id/comments`	Add comment to incident
POST	`/incidents/:id/resolve`	Resolve an incident

Example: List Incidents

          
curl -X GET "https://api.minusnow.com/v1/incidents?status=investigating&priority=high" \
  -H "Authorization: Bearer lqx_prod_abc123xyz789"

Response

          
{
  "success": true,
  "data": [
    {
      "id": "INC-2026-4532",
      "title": "Database connection timeout",
      "status": "investigating",
      "priority": "high",
      "assignee": {
        "id": "usr_tech_042",
        "name": "John Doe"
      },
      "createdAt": "2026-01-30T14:30:00Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 20,
    "total": 45
  }
}
          
        

Response Codes

200 Request successful

201 Resource created

400 Bad request

401 Unauthorized

403 Forbidden

404 Not found

429 Rate limit exceeded

500 Server error

Rate Limits

Plan	Requests/Minute	Requests/Day
Free	60	1,000
Professional	300	50,000
Enterprise	1,000	Unlimited

📊

Rate Limit Headers

Every response includes: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

SDK Support

              
# Install
npm install @minusnow/itsm-sdk

# Usage
import { MinusNowClient } from '@minusnow/itsm-sdk';

const client = new MinusNowClient({
  apiKey: 'lqx_prod_abc123xyz789'
});

const incidents = await client.incidents.list({
  status: 'open',
  priority: 'critical'
});
              
            

              
# Install
pip install minusnow-itsm

# Usage
from minusnow import MinusNowClient

client = MinusNowClient(api_key='lqx_prod_abc123xyz789')

incidents = client.incidents.list(
    status='open',
    priority='critical'
)
              
            

              
// Install
go get github.com/minusnow/itsm-go

// Usage
import "github.com/minusnow/itsm-go"

client := minusnow.NewClient("lqx_prod_abc123xyz789")

incidents, err := client.Incidents.List(&minusnow.ListOptions{
    Status:   "open",
    Priority: "critical",
})
              
            

Webhooks

Receive real-time notifications for events in your MinusNow instance.

Webhook Payload

          
{
  "event": "incident.created",
  "timestamp": "2026-01-30T14:32:00Z",
  "data": {
    "id": "INC-2026-4532",
    "title": "Server down",
    "priority": "critical"
  }
}
          
        

Supported Events

Incidents

created, updated, resolved

Assets

created, updated, deleted

Changes

created, approved, deployed

Vulnerabilities

detected, remediated