{"info":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","description":"

Zenith AI API Documentation

This collection provides a comprehensive guide to interacting with the Zenith AI backend services.

Prerequisites

Base URL: Set via the http://localhost:5000/api variable (default: http://localhost:5000/api).
\n
Authentication: Most endpoints require a Bearer Token. Run the Login request to automatically populate the variable.
\n

Workflow Order

Check Health to ensure the server is up.
\n
Register/Login in the Auth folder.
\n
Create and manage cloud architectures in Project Management.
\n
Process architectures in IaC & Security.
\n
Deploy to AWS in Cloud Deployment.
\n
Maintain via Drift Detection.
\n
Use Utilities & AI for decision support.
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Zenith AI API Documentation","slug":"zenith-ai-api-documentation"}],"owner":"39216526","collectionId":"6251497c-8a68-4384-86bc-f4d26e5903c5","publishedId":"2sBXc7Kiys","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-03T07:38:19.000Z"},"item":[{"name":"1. Health Check","item":[{"name":"Health Check","id":"b5fb8d83-b8cc-43ac-9f70-63e68a6cc02a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:5000/api/health","description":"

Checks if the backend server is reachable and running correctly.

Expected Response:

200 OK: Server is healthy.
JSON: { \"success\": true, \"message\": \"Server is running\" }

Basic server health and connectivity diagnostics.

\n","_postman_id":"ac486e6d-a7bb-4658-889d-98bb18061437","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}}},{"name":"2. Authentication","item":[{"name":"Signup","id":"5b0168b0-8147-44df-b63c-f5396ab71911","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"username\": \"testuser\",\n \"email\": \"test@example.com\",\n \"password\": \"password123\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/auth/signup","description":"

Create a new account.

Body Parameters (JSON):

username: (Required) String, 3-30 chars.
email: (Required) Valid email address.
password: (Required) String, min 6 chars.

Response:

201 Created on success.
400 Bad Request if validation fails or user exists.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}},"urlObject":{"path":["auth","signup"],"host":["http://localhost:5000/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"5b0168b0-8147-44df-b63c-f5396ab71911"},{"name":"Login","event":[{"listen":"test","script":{"exec":["var jsonData = pm.response.json();","if (jsonData.token) {"," pm.collectionVariables.set(\"token\", jsonData.token);","}"],"type":"text/javascript","id":"66bef4b7-2dca-4d80-9f18-52231704794b"}}],"id":"09dd7898-1ccc-45c4-bbb5-db210db87481","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"email\": \"test@example.com\",\n \"password\": \"password123\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/auth/login","description":"

Authenticate user and receive a JWT token.

Body Parameters (JSON):

email: Registered email.
password: User password.

Note: This request has a Test Script that automatically saves the returned token to the collection variables for use in subsequent requests.

User registration and session management via JWT tokens.

\n","_postman_id":"63c0df96-a4f0-4f6f-9ae6-8c82c5f0e248","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}}},{"name":"3. Project Management","item":[{"name":"Create Project","id":"75eb1462-e24c-4a7b-aef6-8e1733693510","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"projectName\": \"Enterprise Cloud Stack\",\n \"nodes\": [\n {\n \"id\": \"node_1\",\n \"type\": \"aws_instance\",\n \"data\": { \"label\": \"Web Server\", \"instanceType\": \"t3.micro\" }\n }\n ],\n \"generatedCode\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/projects","description":"

Store a new canvas design.

Body Parameters:

projectName: (String) Name of your architecture.
nodes: (Array) List of visual components and their configurations.
generatedCode: (Optional String) Pre-existing Terraform code if any.

Auth: Requires Bearer Token.

Fetch all projects created by the authenticated user, sorted by most recently updated.

Fetch detailed data for a specific project by its ID.

The MongoDB ID of the project

\n","type":"text/plain"},"type":"any","value":"project_id_here","key":"id"}]}},"response":[],"_postman_id":"ecd50dd0-0346-4ea8-b3a1-930ff0f5c6cd"},{"name":"Update Project","id":"ad26fd55-a342-4ae2-838a-7b96531db7fc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[],"body":{"mode":"raw","raw":"{\n \"projectName\": \"Updated Cloud Stack\",\n \"nodes\": [\n {\n \"id\": \"node_1\",\n \"type\": \"aws_instance\",\n \"data\": { \"label\": \"API Server\", \"instanceType\": \"t3.medium\" }\n }\n ]\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/projects/:id","description":"

Update the nodes or name of an existing project. Partial updates are supported.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}},"urlObject":{"path":["projects",":id"],"host":["http://localhost:5000/api"],"query":[],"variable":[{"id":"cccbbdd5-86f6-4c8f-9894-de0eedfcf724","type":"any","value":"project_id_here","key":"id"}]}},"response":[],"_postman_id":"ad26fd55-a342-4ae2-838a-7b96531db7fc"},{"name":"Delete Project","id":"cbd2fb0a-35e5-49cb-9a46-046075942f5d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"http://localhost:5000/api/projects/:id","description":"

Permanently remove a project. This cannot be undone.

Full CRUD operations for cloud infrastructure projects (canvases).

\n","_postman_id":"60706c40-e29d-42ad-a448-21ef28961fbb","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}}},{"name":"4. IaC & Security","item":[{"name":"Generate Terraform","id":"180d64ee-4d4c-401d-b330-a9477bf8406f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://localhost:5000/api/projects/:id/generate-terraform","description":"

Invokes the IaCEngine to parse the project's nodes and generate valid HCL (Terraform) code.

Returns:

terraformCode: The HCL output.
projectInfo: Summary of nodes processed.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}},"urlObject":{"path":["projects",":id","generate-terraform"],"host":["http://localhost:5000/api"],"query":[],"variable":[{"id":"a0461de2-ee83-47dc-8c74-2708c7596a14","type":"any","value":"project_id_here","key":"id"}]}},"response":[],"_postman_id":"180d64ee-4d4c-401d-b330-a9477bf8406f"},{"name":"Run Security Audit","id":"fff13136-ee45-461c-9620-b1cd3e1615ce","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"http://localhost:5000/api/projects/:id/run-security-audit","description":"

Scans the generated Terraform code for security risks (e.g., open ports, unencrypted storage, missing IAM policies).

Convert visual diagrams into Terraform code and perform automated safety checks.

\n","_postman_id":"eb50a6ee-c122-48e2-a4ec-9276a1ffd887","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}}},{"name":"5. Cloud Deployment","item":[{"name":"Check Deployment Readiness","id":"96fc58c2-8b5b-4bbf-bdd0-1481e30bacc1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:5000/api/projects/:id/deployment-readiness","description":"

Verifies if the server has Terraform binary installed and if the project has generated code ready for use.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}},"urlObject":{"path":["projects",":id","deployment-readiness"],"host":["http://localhost:5000/api"],"query":[],"variable":[{"id":"b5111bdf-24ec-4f92-93a9-0052fe38dd76","type":"any","value":"project_id_here","key":"id"}]}},"response":[],"_postman_id":"96fc58c2-8b5b-4bbf-bdd0-1481e30bacc1"},{"name":"Deploy Infrastructure","id":"c904c4c6-8a79-4f4a-b4c0-b07f29eeb456","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"awsCredentials\": {\n \"accessKeyId\": \"ACCA_EXAMPLE_ID\",\n \"secretAccessKey\": \"SECRET_EXAMPLE_KEY\",\n \"region\": \"us-east-1\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/projects/:id/deploy","description":"

Initiates the real-world deployment on AWS.

Warning: This will create actual resources and may incur costs.

Credentials Requirement:

accessKeyId: AWS Access Key ID
secretAccessKey: AWS Secret Access Key
region: Target AWS Region (e.g., us-east-1)

Provision the infrastructure to AWS using the generated Terraform code.

\n","_postman_id":"8a4d8881-0d74-410e-850f-6f582615c454","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}}},{"name":"6. Drift Detection","item":[{"name":"Detect Drift","id":"fafc0845-1d66-42c6-bfd6-dd8213d794d9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"awsCredentials\": {\n \"accessKeyId\": \"ACCA_EXAMPLE_ID\",\n \"secretAccessKey\": \"SECRET_EXAMPLE_KEY\",\n \"region\": \"us-east-1\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/projects/:id/detect-drift","description":"

Checks for discrepancies between the code and reality.

Body Parameters: Requires valid AWS credentials for the target infrastructure.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}},"urlObject":{"path":["projects",":id","detect-drift"],"host":["http://localhost:5000/api"],"query":[],"variable":[{"id":"15d6f479-3df1-458d-b1f0-5159f22693d8","type":"any","value":"project_id_here","key":"id"}]}},"response":[],"_postman_id":"fafc0845-1d66-42c6-bfd6-dd8213d794d9"},{"name":"Drift History","id":"cc12a36e-673f-4e0d-bce4-39e5cbbee01e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"http://localhost:5000/api/projects/:id/drift-history","description":"

View a list of past drift detection scans for this project.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}},"urlObject":{"path":["projects",":id","drift-history"],"host":["http://localhost:5000/api"],"query":[],"variable":[{"id":"0a5cb3ce-390a-414d-844f-b6281c7e54ae","type":"any","value":"project_id_here","key":"id"}]}},"response":[],"_postman_id":"cc12a36e-673f-4e0d-bce4-39e5cbbee01e"},{"name":"Compare State","id":"fac84798-f92e-4352-8cdd-398151e770f7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"awsCredentials\": {\n \"accessKeyId\": \"ACCA_EXAMPLE_ID\",\n \"secretAccessKey\": \"SECRET_EXAMPLE_KEY\",\n \"region\": \"us-east-1\"\n }\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/projects/:id/compare-state","description":"

Advanced comparison of the Terraform state file vs the current cloud state.

Compare deployed resources with the intended configuration to find unauthorized manual changes.

\n","_postman_id":"f9da1ac5-296a-4247-8e43-0c3545fa7c22","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}}},{"name":"7. Utilities & AI","item":[{"name":"Calculate Budget","id":"f01d584e-71f8-4b7b-8665-581db427c8f9","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"budget\": 100,\n \"storage\": 50\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/pricing/calculate","description":"

Estimates monthly AWS costs based on desired compute/storage tiers.

Parameters:

budget: Monthly threshold in USD.
storage: Estimated storage needed in GB.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}},"urlObject":{"path":["pricing","calculate"],"host":["http://localhost:5000/api"],"query":[],"variable":[]}},"response":[],"_postman_id":"f01d584e-71f8-4b7b-8665-581db427c8f9"},{"name":"AI Service Suggestion","id":"eede72fa-648a-4b50-97b6-e925f01be025","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n \"workloadType\": \"Web Application\",\n \"budget\": 50\n}","options":{"raw":{"language":"json"}}},"url":"http://localhost:5000/api/recommendations/suggest","description":"

Provides tailored AWS service recommendations based on your workload profile and financial limits.

Values for workloadType:

Web Application
Mobile Backend
Data Analytics
File Storage
Machine Learning

Specialized tools to help with planning and decision making.

\n","_postman_id":"507e9585-c8de-4a5f-aab6-2c4401608e74","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"6251497c-8a68-4384-86bc-f4d26e5903c5","id":"6251497c-8a68-4384-86bc-f4d26e5903c5","name":"Zenith AI Backend API","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":[""],"id":"caa3aa46-6f15-463f-a9ad-f8f8b6250936"}},{"listen":"test","script":{"type":"text/javascript","exec":[""],"id":"ba801995-b4dc-4223-be92-93159849726e"}}],"variable":[{"key":"base_url","value":"http://localhost:5000/api","type":"string"},{"key":"token","value":"","type":"string"}]}