curl "https://api.vertracloud.app/v1/templates?category=bots&fits=true&sort=popular&limit=10" \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"response": {
"data": [
{
"id": "7c1d4f0e-3b8a-4d52-9a66-1f0c2e5a9b41",
"slug": "discord-bot-js",
"origin": "vertra",
"visibility": "public",
"name": { "pt-br": "Bot de Discord (JavaScript)", "en": "Discord bot (JavaScript)", "es": "Bot de Discord (JavaScript)" },
"description": {
"pt-br": "Bot de Discord com discord.js e o comando /ping. Ponto de partida para o seu bot.",
"en": "Discord bot with discord.js and a /ping command. A starting point for your bot."
},
"category": "bots",
"tags": ["discord", "bot", "javascript", "discordjs"],
"icon_url": "https://api.vertracloud.app/v1/template-icons/7c1d4f0e-3b8a-4d52-9a66-1f0c2e5a9b41?v=a1b2c3d4",
"author_display": null,
"links": { "website": "https://discord.js.org", "docs": "https://discordjs.guide" },
"landing": null,
"featured": true,
"current_version": {
"id": "e0b7a2c9-5d14-4f8e-8c3a-92d6b1f47a10",
"version": "1.0.0",
"security": false,
"created_at": "2026-10-26T13:05:00Z"
},
"services": [
{
"id": "app",
"kind": "app",
"source_type": "code",
"database": null,
"blob_visibility": null,
"ram": { "min": 256, "recommended": 256 },
"web": "none",
"conditional": false
}
],
"creates_stack": false,
"ram_min_total": 256,
"byok": false,
"required_plan": "economy",
"code_view": true,
"uses_count": 87,
"owner": null,
"github": null,
"created_at": "2026-10-26T09:00:00Z",
"updated_at": "2026-10-26T13:05:00Z",
"account": {
"fits": true,
"reasons": [],
"required_ram": 256,
"free_ram": 2048,
"needs_image_slot": false,
"image_slots_free": 0,
"in_use": false,
"in_use_count": 0
}
}
],
"total_count": 1,
"page": 1,
"limit": 10,
"total_pages": 1,
"has_next_page": false,
"has_previous_page": false
}
}
Templates
List Templates
Lists public catalog templates, plus your private ones when authenticated, with filters, sorting, pagination and whether each fits your account.
GET
/
v1
/
templates
curl "https://api.vertracloud.app/v1/templates?category=bots&fits=true&sort=popular&limit=10" \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"response": {
"data": [
{
"id": "7c1d4f0e-3b8a-4d52-9a66-1f0c2e5a9b41",
"slug": "discord-bot-js",
"origin": "vertra",
"visibility": "public",
"name": { "pt-br": "Bot de Discord (JavaScript)", "en": "Discord bot (JavaScript)", "es": "Bot de Discord (JavaScript)" },
"description": {
"pt-br": "Bot de Discord com discord.js e o comando /ping. Ponto de partida para o seu bot.",
"en": "Discord bot with discord.js and a /ping command. A starting point for your bot."
},
"category": "bots",
"tags": ["discord", "bot", "javascript", "discordjs"],
"icon_url": "https://api.vertracloud.app/v1/template-icons/7c1d4f0e-3b8a-4d52-9a66-1f0c2e5a9b41?v=a1b2c3d4",
"author_display": null,
"links": { "website": "https://discord.js.org", "docs": "https://discordjs.guide" },
"landing": null,
"featured": true,
"current_version": {
"id": "e0b7a2c9-5d14-4f8e-8c3a-92d6b1f47a10",
"version": "1.0.0",
"security": false,
"created_at": "2026-10-26T13:05:00Z"
},
"services": [
{
"id": "app",
"kind": "app",
"source_type": "code",
"database": null,
"blob_visibility": null,
"ram": { "min": 256, "recommended": 256 },
"web": "none",
"conditional": false
}
],
"creates_stack": false,
"ram_min_total": 256,
"byok": false,
"required_plan": "economy",
"code_view": true,
"uses_count": 87,
"owner": null,
"github": null,
"created_at": "2026-10-26T09:00:00Z",
"updated_at": "2026-10-26T13:05:00Z",
"account": {
"fits": true,
"reasons": [],
"required_ram": 256,
"free_ram": 2048,
"needs_image_slot": false,
"image_slots_free": 0,
"in_use": false,
"in_use_count": 0
}
}
],
"total_count": 1,
"page": 1,
"limit": 10,
"total_pages": 1,
"has_next_page": false,
"has_previous_page": false
}
}
Returns one page of templates, filtered and sorted as you ask. The public catalog needs no authentication. With a session or an API key (scope
The public gallery shows templates that are public or in beta and whose latest version is ready. Hidden and deprecated templates are not listed, but Get Template still serves them by ID or slug.
An anonymous answer is cacheable for 30 seconds. An authenticated answer is never cached.
templates:read) the answer also includes your private templates and an account block on each template that says whether it fits your account right now. Calls with an Authorization header are always validated: an invalid key or token is a 401, never an anonymous answer. Reads are limited to 60 requests per minute per client.
string
Text to look for in the name, description (in the three languages), slug and tags. Case and accents are ignored. Up to 100 characters.
string
Only templates of one category:
automation, ai-agents, bots, apis, cms, monitoring, starters, databases or other.string
Only templates of one origin:
vertra (made by the platform), community (contributed and reviewed) or private (yours). private lists your personal private templates, or the ones of workspace_id, and only returns something when you are authenticated.string
Only templates that carry this tag. Up to 50 characters.
boolean
true keeps only the templates that fit your account right now (plan, free memory, limits and image slots). Needs authentication: without it the call fails with AUTH_TOKEN_MISSING.string
default:"recommended"
The order:
recommended (featured first, then most used), popular (most used), newest or name.integer
default:"1"
The page, starting at 1.
integer
default:"20"
Templates per page, from 1 to 50.
string
Includes the private templates of that workspace. The owner of the workspace and members who can read its applications can list them; anyone else gets the workspace error.
Response
object
A page of templates.
Show Toggle object
Show Toggle object
object[]
The templates of the page.
Show Toggle object
Show Toggle object
string
The template ID.
string
A short name, unique among public templates. Accepted wherever a template ID is.
string
vertra, community or private.string
public, beta, hidden or deprecated. A deprecated template cannot be used for new applications; the ones that already run keep running.object
The name in the three languages:
pt-br (always present), en and es (a missing one falls back to pt-br).object
The description, with the same shape as
name.string
One of the categories above.
string[]
The tags of the template.
string | null
URL of the icon, or
null when it has none (private templates have none).string | null
The name shown as the author, or
null for templates of the platform.object
Links of the software the template packages:
website, docs, source and license, each optional.string | null
The slug of the dedicated public page, when there is one.
boolean
true when the template is highlighted in the gallery.object
The latest version:
id, version (semantic version), security (true for a security release) and created_at.object[]
The services the template creates. Each has
id, kind (app, database or blob), source_type (code or image for an app, otherwise null), database (postgres, mysql, mongodb or redis for a database, otherwise null), blob_visibility (private or public for a Blob folder, otherwise null), ram (min, recommended and optional max, in MB; a Blob folder uses none), web (required, optional or none for an app, otherwise null) and conditional (true when the service is only created for some answers).boolean
true when using the template creates a stack, which happens with two or more services.integer
The sum of the minimum memory of every service, in MB.
boolean
true when you bring the key of the AI model the software uses.string
The lowest plan that can use the template.
boolean
false for a closed template: whoever uses it cannot see or download its code. Public templates are always open.integer | null
How many times a catalog template was used: the total of deploys that finished successfully, across every version. Deploys that failed or were rolled back are not counted, and deleting the resulting app does not decrease it. It is an aggregate only, with no information about who used it.
null for private templates.object | null
The owner of a private template, with
user_id and workspace_id (null when it belongs to the user); null for catalog templates.object | null
The linked GitHub repository of a private template (
repository as owner/name and branch), or null.string
When the template was created.
string
When the template was last updated.
object
Present only when the request is authenticated: what using the template would do to your account.
Show Toggle object
Show Toggle object
boolean
true when your plan and free resources cover the template.object[]
Why it does not fit; empty when it does. Each item has
reason and, when it is a number or a plan, required and available. Reasons: no_plan, ram, web_publish, image_plan, image_slots, private_network (a connection of the template is not available over public addresses), blob_plan, min_plan, max_apps, max_databases and deploys_per_hour.integer
The memory the template needs: the sum of the minimum memory of the services that would be created, in MB.
integer
The memory free in your account, in MB.
boolean
true when using the template takes an image slot that you do not already hold. It is never true for an image of your own private template.integer
The image slots free in your account.
boolean
true when your account already runs applications created from this template.integer
How many applications and stacks of your account came from this template.
integer
How many templates match the filters, across all pages.
integer
The current page.
integer
The page size used.
integer
The number of pages.
boolean
true when there is a next page.boolean
true when there is a previous page.curl "https://api.vertracloud.app/v1/templates?category=bots&fits=true&sort=popular&limit=10" \
-H "Authorization: Bearer $VERTRA_API_KEY"
{
"response": {
"data": [
{
"id": "7c1d4f0e-3b8a-4d52-9a66-1f0c2e5a9b41",
"slug": "discord-bot-js",
"origin": "vertra",
"visibility": "public",
"name": { "pt-br": "Bot de Discord (JavaScript)", "en": "Discord bot (JavaScript)", "es": "Bot de Discord (JavaScript)" },
"description": {
"pt-br": "Bot de Discord com discord.js e o comando /ping. Ponto de partida para o seu bot.",
"en": "Discord bot with discord.js and a /ping command. A starting point for your bot."
},
"category": "bots",
"tags": ["discord", "bot", "javascript", "discordjs"],
"icon_url": "https://api.vertracloud.app/v1/template-icons/7c1d4f0e-3b8a-4d52-9a66-1f0c2e5a9b41?v=a1b2c3d4",
"author_display": null,
"links": { "website": "https://discord.js.org", "docs": "https://discordjs.guide" },
"landing": null,
"featured": true,
"current_version": {
"id": "e0b7a2c9-5d14-4f8e-8c3a-92d6b1f47a10",
"version": "1.0.0",
"security": false,
"created_at": "2026-10-26T13:05:00Z"
},
"services": [
{
"id": "app",
"kind": "app",
"source_type": "code",
"database": null,
"blob_visibility": null,
"ram": { "min": 256, "recommended": 256 },
"web": "none",
"conditional": false
}
],
"creates_stack": false,
"ram_min_total": 256,
"byok": false,
"required_plan": "economy",
"code_view": true,
"uses_count": 87,
"owner": null,
"github": null,
"created_at": "2026-10-26T09:00:00Z",
"updated_at": "2026-10-26T13:05:00Z",
"account": {
"fits": true,
"reasons": [],
"required_ram": 256,
"free_ram": 2048,
"needs_image_slot": false,
"image_slots_free": 0,
"in_use": false,
"in_use_count": 0
}
}
],
"total_count": 1,
"page": 1,
"limit": 10,
"total_pages": 1,
"has_next_page": false,
"has_previous_page": false
}
}
Error Responses
string
The error code indicating the reason for the failure. Possible values:
VALIDATION_ERROR: A query parameter is not valid, for example an unknowncategoryor alimitabove 50 (400).AUTH_TOKEN_MISSING:fits=truewithout authentication (401).API_KEY_SCOPE_DENIED: The API key does not have thetemplates:readscope (403).WORKSPACE_NOT_FOUND: The workspace inworkspace_iddoes not exist or you are not part of it (404).RATE_LIMIT_EXCEEDED: Too many requests (429).INTERNAL_SERVER_ERROR: Unexpected failure (500).
{
"code": "AUTH_TOKEN_MISSING"
}
Last modified on October 30, 2026