REST API

Programmatic access to Triage Warden functionality.

Base URL

http://localhost:8080/api

Authentication

See Authentication for details.

API Key

curl -H "Authorization: Bearer tw_abc123_secretkey" \
  http://localhost:8080/api/incidents

Session Cookie

For browser-based access, use session authentication via /login.

Response Format

All responses are JSON:

{
  "data": { ... },
  "meta": {
    "page": 1,
    "per_page": 20,
    "total": 150
  }
}

Error Responses

{
  "error": {
    "code": "not_found",
    "message": "Incident not found",
    "details": { ... }
  }
}

HTTP Status Codes

Endpoints Overview

Incidents

Actions

Playbooks

Webhooks

System

Pagination

List endpoints support pagination:

curl "http://localhost:8080/api/incidents?page=2&per_page=50"

Parameters:

• page - Page number (default: 1)
• per_page - Items per page (default: 20, max: 100)

Filtering

Filter list results:

curl "http://localhost:8080/api/incidents?status=open&severity=high"

Common filters:

• status - Filter by status
• severity - Filter by severity
• type - Filter by incident type
• created_after - Created after date
• created_before - Created before date

Sorting

curl "http://localhost:8080/api/incidents?sort=-created_at"

• Prefix with - for descending order
• Default: -created_at (newest first)

Rate Limiting

API requests are rate limited:

Rate limit headers:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1705320000

Next Steps

• Authentication - API authentication
• Incidents - Incident endpoints
• Actions - Action endpoints
• Playbooks - Playbook endpoints
• Webhooks - Webhook integration