HTTP API Reference

All HTTP requests should be sent to the backend URL defined in your environment variables. Authenticated routes require a valid Clerk session token.

POST/roomAuth Required

Create a new drawing room.

{
  "name": "string (slug)"
}

{
  "roomId": "number"
}

GET/room/:slug

Retrieve room details by its unique slug.

{
  "room": "object"
}

GET/chats/:roomIdAuth Required

Fetch the last 1000 messages/strokes for a specific room.

{
  "messages": "array"
}

POST/ai-chat

Send a prompt to the AI Design Assistant (Groq/Llama 3.3).

{
  "messages": "array"
}

{
  "choices": "array"
}

POST/generate-ppt

Generate and download a PowerPoint presentation from canvas slides.

{
  "slides": "array (base64 images)"
}

Binary (pptx file)