Native AI Agent Support

Built for AI Agents.

Discover, author, render, and version templates — everything a user can do in the UI,
driven by your own agent. No human in the loop required.

Nimo operating an AI agent tool console

Two ways in.

REST Guide

Agent REST Guide

For custom agents, n8n AI nodes, or any LLM that can read a JSON manifest and call REST endpoints.

Manifest endpoint public, no auth
templateson.com/api/agents
Fetch once

Agent fetches /api/agents and gets a complete JSON description of every endpoint, parameter, auth setup, and example.

Act autonomously

Agent calls the REST API directly: list templates, render images, generate new designs, all from the manifest alone.

A full toolset.
Full control.

list_templatesdiscovery

List every template accessible to your API key: your own and all public ones. Returns IDs, names, and visibility.

get_template_fieldsintrospection

Inspect a template's dynamic fields before rendering. Returns field names and types (text or image).

get_dsl_schemaauthoring

Get the Template DSL grammar reference. Call this before authoring so your agent knows how to write a design.

preview_templateauthoring

FREE dry-run — convert DSL to SVG with layout warnings, without saving or spending a render. Iterate on a design, then create + render once it looks right.

create_templateauthoring

Author a brand-new template from Template DSL. Your agent writes the DSL; we convert it to SVG and save it. Mark any text/image with name=field to make it a dynamic field.

update_templateauthoring

Overwrite an existing template you own with new DSL. The prior version is snapshotted as a revision automatically.

render_imageoutput

Render any template as a PNG. Pass field values and get the image back inline, with no download links and no extra steps.

render_pdfoutput

Same as render_image but produces a PDF document. Identical parameters, base64-encoded result.

bulk_renderoutput

Render one template against many records in a single call — N records in, N PNGs or PDFs out.

render_carouseloutput

Render a multi-page template as an ordered set of slide images, e.g. an Instagram carousel.

render_videooutput

Render an MP4 from a template — slideshow mode (slides over time) or motion mode (animate one template).

list_revisionsversioning

List the version history of a template you own.

restore_revisionversioning

Roll a template back to a historical version. The current content is snapshotted first, so restoring is undo-able.

See it in action.

# 1. List your templates
curl https://templateson.com/api/v1/templates/list \
  -H "X-API-Key: YOUR_KEY"

# 2. Get fields for a template
curl https://templateson.com/api/v1/templates/TEMPLATE_ID/fields \
  -H "X-API-Key: YOUR_KEY"

# 3. Render it as PNG
curl -X POST https://templateson.com/api/v1/image \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"templateId":"TEMPLATE_ID","title":"Hello","format":"json"}'

Ready to connect?

Get your API key and plug Templates on into your agent in minutes.