Skip to main content
The Zerops REST API provides endpoints for managing all aspects of your infrastructure. All endpoints are accessible at the base URL: 
https://api.app-prg1.zerops.io/api/rest/public
For detailed request/response schemas and to test API calls, visit the full Swagger documentation.

​
Resource Groups

​
Authentication & Users

Manage authentication, user accounts, and access tokens.

/auth

Authentication and token management

/user

User account management

/user-token

Personal access tokens management

/user-notification

User notifications management

​
Projects & Services

Manage your projects and services.

/project

Project management operations

/service-stack

Service stack operations and configuration

/app-version

Manage application versions, builds, and deployments
The /service-stack endpoints are used for services management. This naming is non-obvious and important to note.

​
Configuration & Environment

Manage environment variables and configurations.

/user-data

Environment variables management

/project-env

Project environment variables management

/settings

System settings and configurations
The /user-data endpoints handle environment variables management, not user profile data. This naming is non-obvious and important to note.

​
Networking & Routing

Configure HTTP routing, port routing, and firewall rules.

/public-http-routing

HTTP routing configuration

/public-port-routing

Port routing and firewall rules configuration

​
Organization & Access

Manage client accounts and user access.

/client

Client account management

/client-user

User management within client accounts

​
Billing

Manage billing operations and payments.

/billing

Billing operations and payment management

​
Version Control Integration

Connect and manage GitHub and GitLab repositories.

/github

GitHub repository connections and authorization

/gitlab

GitLab repository connections and authorization

​
Common Operations

Here are some common API operations you might need:

​
List Projects

Retrieve all projects you have access to: 
curl -X GET \
  https://api.app-prg1.zerops.io/api/rest/public/project \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Get Project Details

Get detailed information about a specific project: 
curl -X GET \
  https://api.app-prg1.zerops.io/api/rest/public/project/{projectId} \
  -H "Authorization: Bearer YOUR_TOKEN"

​
List Services

List all services in a project: 
curl -X GET \
  https://api.app-prg1.zerops.io/api/rest/public/service-stack \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Manage Environment Variables

Get environment variables for a service: 
curl -X GET \
  https://api.app-prg1.zerops.io/api/rest/public/user-data \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Response Codes

The API uses standard HTTP response codes:
​
200 OK
success
The request was successful
​
201 Created
success
A new resource was successfully created
​
400 Bad Request
error
The request was invalid or cannot be served
​
401 Unauthorized
error
Authentication failed or token is missing
​
403 Forbidden
error
The authenticated user doesn’t have permission
​
404 Not Found
error
The requested resource doesn’t exist
​
429 Too Many Requests
error
Rate limit exceeded
​
500 Internal Server Error
error
An error occurred on the server

​
Interactive Documentation

For interactive API documentation with detailed request/response schemas and the ability to test endpoints:

Swagger Documentation

Explore the complete API reference with interactive examples

​
Need Help?

If you need assistance with the API:

Build docs developers (and LLMs) love

Get started for freeTalk to us