Skip to main content

​
Base URL

https://app.getmuster.io

​
Getting a token

curl -X POST https://app.getmuster.io/auth/login \
  -H "Content-Type: application/json" \
  -d '{"username": "you@company.com", "password": "your-password"}'
Response: 
{
  "access_token": "eyJhbGci...",
  "refresh_token": "Lg1wfd1N...",
  "token_type": "bearer",
  "expires_in": 3600
}

​
Using the token

Include the access token in the Authorization header: 
curl https://app.getmuster.io/api/v1/agents \
  -H "Authorization: Bearer eyJhbGci..."

​
Token lifetime

TokenLifetime
Access token60 minutes
Refresh token30 days

​
Refreshing tokens

curl -X POST https://app.getmuster.io/auth/refresh \
  -H "Content-Type: application/json" \
  -d '{"refresh_token": "Lg1wfd1N..."}'

​
Public endpoints

These endpoints do not require authentication:
EndpointPurpose
POST /auth/loginGet tokens
POST /auth/refreshRefresh access token
POST /auth/signupCreate trial account
POST /api/v1/jobs/{job_id}/qualitySDK quality ingestion
POST /api/v1/costs/eventsSDK cost ingestion
POST /api/v1/agents/beaconSDK agent registration
GET /healthHealth check