Documentation menu

This org's community templates, drafts and published

GEThttps://api.instacloud.com/orgs/{orgId}/templates

Token scope: account · org — read-only tokens allowed.

One summary per template, with no services, variables or publish requirements. getOrgTemplate serves one template in full.

Parameters

NameInTypeRequiredDescription
orgIdpathstringyes

Responses

200

Default Response

FieldTypeRequiredDescription
templatesobject[]yes
templates.idstringyesThe draft's stable id. A rename of its code keeps it, and a new draft gets a new one, even under a code a deleted draft had. Routes and editor links address a draft by its code.
templates.codestringyes
templates.orgIdstringyes
templates.sourceProjectIdstring | nullyes
templates.blankbooleanyesCreated with POST /orgs/{orgId}/templates, with no project behind it: every service is one the author added, and Regenerate From Project answers 400. A generated draft whose project was deleted is not blank.
templates.status"draft" | "published" | "unpublished"yes
templates.publishedVersionstring | nullyes
templates.hasUnpublishedChangesbooleanyes
templates.takenDownbooleanyesStaff took this template down. It cannot be republished.
templates.namestringyes
templates.taglinestring | nullyes
templates.categorystring | nullyes
templates.logoUrlstring | nullyes
templates.updatedAtstringyes
templates.deployCountintegeryesSucceeded deployments of this template.
templates.totalProjectsintegeryesDistinct projects that deployed this template since its first publish, any outcome: the number the gallery card shows (the catalog's totalProjects).

404

Default Response

FieldTypeRequiredDescription
errorstringyes

429

This user listed the templates too many times in the last minute. Retry later.

FieldTypeRequiredDescription
errorstringyes

View as Markdown