Skip to main content

API Authentication

All API requests require a Bearer token in the Authorization header:

Authorization: Bearer srvly_09475e0504e0695b22fc2decdd8e63db

The token is generated in the srvly dashboard under Settings → API Token.

Where to Find Your Token​

  1. Open the srvly dashboard (console.srvly.app)
  2. Go to Settings
  3. Copy the token from the API Token section

Usage Examples​

# List installations on a server
curl -H "Authorization: Bearer srvly_your_token" \
  "https://console.srvly.app/api/agent/install?serverId=YOUR_SERVER_ID"

# List containers on a server
curl -H "Authorization: Bearer srvly_your_token" \
  "https://console.srvly.app/api/agent/servers/YOUR_SERVER_ID/containers"

Public vs Authenticated Endpoints​

EndpointAuth Required
GET /api/deployNo (returns a public shell script)
GET /api/agent/openapi.jsonNo (returns the API spec)
All other API endpointsYes (Bearer token)

Token Security​

  • Treat your token like a password — never share it publicly or commit it to Git
  • Tokens can be regenerated from Settings if compromised
  • Each token is tied to your user account and grants full API access