Overview
This API provides enterprise change management, ticket tracking, and approval workflows.
All API endpoints are prefixed with /v1 and require authentication unless noted otherwise.
Authentication
Obtain a JWT token via the login endpoint and include it in subsequent requests:
POST
/v1/auth/login
Authenticate with credentials
POST
/v1/auth/login/oauth2/afterdark
OAuth2 via After Dark Central Auth
POST
/v1/auth/refresh
Refresh access token
Include token in header: Authorization: Bearer <token>
Tickets
Create and manage change tickets with full audit trails.
POST
/v1/tickets
Create new ticket
GET
/v1/tickets
List tickets
GET
/v1/tickets/:id
Get ticket details
PATCH
/v1/tickets/:id
Update ticket
POST
/v1/tickets/:id/submit
Submit for approval
Ticket ID Format
Tickets use the format: CHG-YYYY-NNNNN (e.g., CHG-2025-00001)
Approvals
Review and approve/deny submitted change tickets.
GET
/v1/approvals
List pending approvals
POST
/v1/approvals/:id/approve
Approve change
POST
/v1/approvals/:id/deny
Deny change
Token-Based Approval (No Auth Required)
POST
/v1/approvals/token/:token/approve
Approve via email token
Health & Status
GET
/health
Basic health check
GET
/health/ready
Readiness with dependencies
CLI Tool
A command-line interface is available for managing tickets:
$
changes ticket create --type standard --title "Deploy v2.0"
$
changes ticket list --status pending