TwoMinuteTimeline
Slide Deck Quality Gantt Charts in 2 minutes or less

HTTP API

POST a small JSON description and get back a deck-ready PNG (or SVG). The endpoint is open and CORS-enabled, so it works from browsers, scripts, CI, and anywhere else you can make an HTTP call.

POST /api/timeline
Fair use: The endpoint is rate-limited to 20 requests / minute per IP (short-burst cap 5/sec) with a 64KB body cap. No auth required. Self-host for higher throughput.

Try it

Code samples


        

        

      

    


    
    

      

        
Live preview

        

          
Click Render to call the API.

        

      


      

        
Request body

        

          

            
FieldTypeDescription

            
titlestringProject title shown above the chart. Default: "Project Timeline".

            
columnsnumberNumber of time-unit columns (2–52). Default 8.

            
unitstringColumn unit label, e.g. "Week", "Sprint", "Month". Default "Week".

            
startnumberStarting column number — header reads "Week 1", "Week 2", …. Default 1.

            
widthnumberOutput width in pixels (640–2400). Default 1280. PNG renders at 2× DPR.

            
labelsInBarsbooleanShow task names inside each bar. Default true.

            
tasksTask[]Array of tasks (max 100). See below.

          

        

      


      

        
Task object

        

          

            
FieldTypeDescription

            
namestringTask label (truncated if it overflows).

            
startnumberColumn offset from the left of the track (supports 0.25 increments, e.g. 2.75).

            
durationnumberLength in columns. 0.25 renders as a milestone diamond.

            
colorstringBar color — any valid CSS color (hex preferred). Default #4f46e5.

          

        

      


      

        
Response & query options

        
    
          
  • POST /api/timeline → image/png (default)
    • 
          
  • POST /api/timeline?format=svg → image/svg+xml
    • 
          
  • GET /api/timeline?demo=1 → returns the example chart for quick tests
    • 
          
  • Errors return JSON: { error: string, ... } with status 400/413/429/500
    • 
        

      


      

        
Calling from an AI assistant?

        
You probably want the hosted MCP server instead — it wraps this exact endpoint as a create_timeline tool that Claude, Cursor, and other MCP clients can call directly. See the MCP page →