Quickstart
This guide will get you set up with the ITSM AI Automation Platform. We'll cover deploying the infrastructure stack, authenticating with JWT, and making your first API request to create and triage a ticket.
Before you can make requests to the ITSM API, you need to deploy the platform and obtain JWT credentials. See Authentication for details.
Deploy the platform
The fastest way to get started is with Docker Compose. This brings up PostgreSQL, Redis, Temporal, Qdrant, and the API server.
# Clone the repository
git clone https://github.com/your-org/itsm-automation.git
cd itsm-automation
# Copy environment configuration
cp .env.example .env
# Start all services
docker compose up -d
# Verify services are running
curl http://localhost:3000/health
Authenticate and get a token
After the platform is running, authenticate to get a JWT access token. The API uses RS256-signed JWTs with 15-minute access tokens and 7-day refresh tokens.
curl -X POST http://localhost:3000/v1/auth/login \
-H "Content-Type: application/json" \
-d '{
"email": "admin@your-org.com",
"password": "your-password"
}'
Create your first ticket
Now you're ready to create a ticket. The AI triage pipeline will automatically classify, prioritize, and route it.
curl -X POST http://localhost:3000/v1/tickets \
-H "Authorization: Bearer {access_token}" \
-H "Content-Type: application/json" \
-d '{
"title": "VPN connection dropping intermittently",
"description": "Users in the Warsaw office report VPN disconnections every 30 minutes since Monday morning. Affects approximately 200 users.",
"type": "incident",
"source": "api"
}'
The response includes AI classification results — the triage pipeline automatically determines intent, priority, category, and suggests routing.
What's next?
Great, you're now set up with the ITSM AI Automation Platform. Here are a few links to explore further: