API Reference

Authentication

The API uses JWT authentication. Obtain a token pair by posting credentials to the token endpoint:

POST /api/token/
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "your-password"
}

# Response:
{
  "access": "eyJ...",
  "refresh": "eyJ..."
}

Include the access token in subsequent requests:

Authorization: Bearer <access_token>

Organizations

# List organizations
GET /api/org/

# Get organization details
GET /api/org/<slug>/

Nodes

# List nodes
GET /api/org/<slug>/nodes/

# Create a node
POST /api/org/<slug>/nodes/
{
  "name": "web-prod-01",
  "ip_address": "10.42.0.10"
}

# Get node details
GET /api/org/<slug>/nodes/<id>/

# Get node configuration
GET /api/org/<slug>/nodes/<id>/config/

Full API Documentation

Interactive API documentation is available at /api/docs/ (Swagger UI) and /api/redoc/ (ReDoc) for authenticated staff users.