Skip to main content
Use Templated through Corsair: one client, typed API calls. Create a key in the Templated dashboard under the API Key tab, then send it as Authorization: Bearer <key>. Things to know before you call:
  • Rendering spends a credit. renders.create, renders.duplicate and renders.merge each use API quota, and a deleted render does not refund it.
  • A render is synchronous by default. It comes back complete with its url in about two seconds. Pass async: true to return while it is still PENDING and give webhook_url for Templated to call when it finishes; the render then moves to COMPLETED or FAILED.
  • Batch renders answer an array. Sending templates instead of template renders each one, so the response is an array of renders rather than one object. Both shapes parse.
  • The list routes are paged by number, starting at 0. renders.list documents no query parameters at all, so the plugin rejects a filter on it. templates.list takes query, page, limit, width and height, and defaults to 25 per page; uploads.list and folders.list default to 15.
  • Uploads need real file bytes. uploads.create takes fileName and fileBase64, rebuilds the bytes as a Blob and sends multipart, because the route accepts an image file up to 2 MB and nothing else. Templated does not accept a hosted URL in its place.
  • Deleting uploads takes repeated ids. uploads.delete sends ids once per upload, not one comma-joined value.
  • Tags are bare arrays. templates.addTags and templates.removeTags take a JSON array of strings as the whole body, not an object with a tags key.
  • A merge needs hosting. renders.merge always asks Templated to host the result, because without that flag the route answers the PDF bytes rather than JSON.
  • Deletes are permanent. A deleted render loses its file and its URL stops working, and a deleted template cannot be restored.
What you get:
  • 23 typed API operations

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

List the first page of templates
Render a template with a text override
See the full list on the API page.

What’s next

API reference

Every templated.api.* operation with input and output types.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.