List templates
GEThttps://api.instacloud.com/templates
Token scope: account · org · project — read-only tokens allowed.
List published templates in the platform registry. Public — no auth required.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
query | query | string | no | substring filter over code/name/tagline/tags |
category | query | string | no | exact category filter (case-insensitive) |
Responses
200
Default Response
| Field | Type | Required | Description |
|---|---|---|---|
templates | object[] | yes | |
templates.code | string | no | |
templates.version | string | no | |
templates.maintainer | string | no | who publishes it, as the manifest declares ('official' for InstaCloud's own) |
templates.source | string | no | the registry row's publisher tag, set at publish; defaults to the maintainer |
templates.name | string | no | |
templates.tagline | string | no | |
templates.category | string | no | |
templates.tags | string[] | no | |
templates.totalProjects | integer | no | distinct PROJECTS that deployed this template since its first publish (any outcome) — the adoption number; one project deploying repeatedly counts once |
templates.activeProjects | integer | no | distinct PROJECTS that still have at least one live service from a SUCCEEDED deployment of this template made since its first publish (service in creating/active; deleting, errored or deleted services do not keep a project active) — what a visitor reads as "running this now" |
templates.successRate | integer | null | no | share of the CONCLUDED deployments of this template since its first publish that reached succeeded, as a whole percent. Denominator: deployments with status succeeded + failed + partial, EXCLUDING runs abandoned by a platform restart (a platform release must not count against a template) and excluding running deployments (not concluded). A partial deployment counts as a failure. This is a per-DEPLOYMENT rate, not per attempt: an idempotent retry reuses its deployment row. null (never 0) when nothing has concluded — no data is not 0% |
templates.deploymentCount | integer | no | cumulative DEPLOYMENT runs for this code (every run since the template was first published) — the deployment-unit counterpart of totalProjects |
templates.activeDeploymentCount | integer | no | DEPLOYMENT runs since the first publish that succeeded and still have a live attributed service — the deployment-unit counterpart of activeProjects |
templates.logoUrl | string | null | no | absolute https logo URL; null when the template published no logo. Official templates: a commit-pinned jsDelivr URL (TEMPLATE_LOGO_HOST in templateManifest.ts). Community templates: any https:// link the author set. |
templates.license | string | null | no | the upstream project's license id, from the manifest's upstream.license; null when the manifest declares none |
templates.updatedAt | string | no | when this template was last published — the catalog freshness stamp |