Skip to main content
POST
/
api
/
chat
/
{chatId}
/
deploy
Deploy
curl --request POST \
  --url https://macaly.com/api/chat/{chatId}/deploy \
  --header 'Authorization: Bearer <token>'

Documentation Index

Fetch the complete documentation index at: https://www.macaly.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Deploy a chat to production. Starts a deployment to Vercel and returns immediately.

​
Request

POST /api/chat/{chatId}/deploy

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer macaly_...

​
Path Parameters

ParameterTypeDescription
chatIdstringThe chat ID to deploy

​
Example Request

curl -X POST https://www.macaly.com/api/chat/abc123/deploy \
  -H "Authorization: Bearer macaly_abc123..."

​
Response

{
  "id": "jzga0sttml37v6mbizb8tk1x",
  "url": "https://macaly-staging-abc123.macaly.app",
  "status": "QUEUED",
  "deploymentId": "dpl_HKLBd2QDTwq58AMUJiaMyUzk8WUw"
}

​
Response Fields

FieldTypeDescription
idstringDatabase deployment ID
urlstringThe deployment URL
status"QUEUED" | "BUILDING"Initial status
deploymentIdstringVercel deployment ID

​
Status Codes

StatusDescription
200Deployment started
400Bad request (e.g., no messages in chat)
401Invalid or missing API key
403No permission to deploy OR chat doesn’t belong to team
404Chat not found
500Internal server error

​
Notes

This endpoint returns immediately after starting the deployment. The deployment happens asynchronously on Vercel.

​
Next Steps

After starting a deployment:
  1. Poll for completion using GET /api/chat/{chatId}/deployment
  2. Wait for status to become READY