API overview - Macaly Documentation

The Macaly API enables external applications to create chat sessions, build web applications with AI, and deploy them to production programmatically.

The API is available exclusively on Enterprise plans. Contact us to learn more about enterprise pricing and features.

Base URL

https://www.macaly.com

Method	Endpoint	Description
POST	`/api/chat`	Create a new chat and start building
POST	`/api/chat/{chatId}/publish`	Send a message to an existing chat
POST	`/api/client-app/assets/upload`	Upload a file and get a permanent CDN URL
GET	`/api/chat/{chatId}/status`	Poll workflow status
GET	`/api/chat/{chatId}/subscribe`	Subscribe to real-time stream
POST	`/api/chat/{chatId}/deploy`	Deploy chat to production
GET	`/api/chat/{chatId}/deployment`	Get deployment status

All errors return JSON with an error field:

{
  "error": "Error message here"
}

Status	Description
400	Bad Request - Invalid request body
401	Unauthorized - Invalid or missing API key
402	Payment Required - Insufficient credits
403	Forbidden - No permission or wrong team
404	Not Found - Resource not found
422	Unprocessable Entity - Validation error
429	Too Many Requests - Rate limited
500	Internal Server Error - Server-side error
503	Service Unavailable - Server is busy, try again later

⌘I