Developer Guide

Integrate with ZopNight's REST API to manage cloud resource schedules, discover resources, track costs, and automate start/stop operations across AWS, GCP, and Azure.

Getting Started

Set up authentication and make your first API call

Cloud Accounts

Connect your AWS, GCP, or Azure accounts

Schedules

Create automated start/stop schedules for resources

API Reference

Complete endpoint reference for all APIs

How It Works

ZopNight follows a discover-schedule-execute pattern across your cloud infrastructure.

Connect Cloud Accounts

Provide credentials for your AWS, GCP, or Azure accounts. ZopNight supports multiple authentication methods per provider.

Discover Resources

ZopNight automatically discovers VMs, databases, Kubernetes clusters, serverless functions, and more across all connected accounts.

Create Schedules

Define cron-based schedules to automatically start and stop resources. Attach individual resources or groups for organized management.

Execute & Monitor

The scheduler evaluates crons every minute and executes start/stop actions. Track state history, cost savings, and get optimization recommendations.

Architecture Overview

All API requests go through a gateway that handles authentication and routes to the appropriate backend service.

Client (Your App)
    │
    ▼
┌──────────┐     JWT validation, org context injection
│  Gateway  │─────────────────────────────────────────
└──────────┘
    │
    ├──► Config       Schedules, Groups, Overrides, Cloud Accounts
    ├──► Discoverer   Resource discovery across cloud providers
    ├──► Executor     Start/stop execution, state history
    ├──► Aggregator   Cost reports, trends, budgets
    └──► Recommender  Optimization recommendations, auto-tagging

Key Concepts

Concept	Description
Cloud Account	A connected AWS, GCP, or Azure account with credentials for resource access
Resource	A discovered cloud resource (VM, database, cluster, etc.) that can be managed
Schedule	A set of cron-based rules that define when resources should be started or stopped
Resource Group	A logical collection of resources that can be scheduled together with execution ordering
Override	A temporary force-on or force-off that takes precedence over schedules
Action	A start or stop operation executed against a cloud resource
Recommendation	A cost optimization suggestion based on resource usage analysis

Cloud Provider Support

ZopNight supports resource discovery and scheduling across three major cloud providers.

AWS

64 resource types

16 executable

GCP

36 resource types

6 executable

Azure

53 resource types

8 executable

See the full Cloud Support Matrix for details on supported resource types.