> ## Documentation Index > Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt > Use this file to discover all available pages before exploring further. # Save an Application as a Template > Saves one of your applications as a private template, choosing which variables become questions and which files go in. This call saves an application as a private template with a first version and answers `201` with the template. Variable values are never copied unless you choose `keep` for a variable that does not look like a credential. Call [Review Template Draft](https://docs.vertracloud.app/api-reference/endpoint/templates/draft.md) first to see what the platform proposes. Needs the `templates:write` scope when called with an API key. The same plan, 5-template limit and workspace rules of [Create a Private Template](https://docs.vertracloud.app/api-reference/endpoint/templates/create.md) apply, and the template is not verified by Vertra Cloud. An application that came from a share link cannot be saved (`TEMPLATE_SAVE_NOT_ALLOWED`), and neither can an application of a [closed template](https://docs.vertracloud.app/templates/use/closed-templates.md) (`TEMPLATE_CLOSED`). An application that runs a platform image cannot be saved either. **app\_id** `string` *required* The application ID. **workspace\_id** `string` If the application belongs to a workspace, the workspace's ID. **id** `string` *required* The slug of the template, lowercase letters, digits and hyphens. **name** `object` *required* The name by language: `pt-br` (required), `en` and `es`, up to 50 characters each. **description** `object` *required* The description by language, same shape as `name`, up to 128 characters each. **category** `string` *required* `automation`, `ai-agents`, `bots`, `apis`, `cms`, `monitoring`, `starters`, `databases` or `other`. **tags** `string[]` Up to 10 tags. **version** `string` The first version, as a semantic version. Default `1.0.0`. **permissions** `object` What users of the template may do, as in the [permissions](https://docs.vertracloud.app/templates/create/permissions.md) of the manifest. Absent fields take the defaults. **member** `object` *required* What to save of the application. **member object** **resource\_id** `string` *required* The ID of the application or database to save. **service\_id** `string` *required* The id the service gets in the manifest. **env** `object[]` One review per variable of an application. A variable without a review is left out of the template. Each review has: * `key`: the variable name. * `mode`: `question` (becomes a question the user answers; the value is not copied), `keep` (the value is copied; refused when it looks like a credential), `generate` (becomes a secret the platform generates for each user, with `generate` set to `random:` or `uuid`), `hidden` (copied but hidden from whoever uses the template; the value stays out of sight of whoever uses the template) or `omit` (left out). * `label` and `help`: texts by language (`pt-br`, `en`, `es`), used by `question` and `generate`. * `generate`: how the secret is generated, `random:` or `uuid`. Read the suggestions first with [Review Template Draft](https://docs.vertracloud.app/api-reference/endpoint/templates/draft.md). **paths** `string[]` The paths of the application's `/app` that go into the template, for applications with code. Without it, everything goes in except what the draft leaves unselected. `.env*` files, the platform folder and dependency folders can never be included. **ram** `object` The memory of the service in MB: `min`, `recommended` and optional `max`. **workspace\_id** `string` The workspace that will own the template. Without it, the template belongs to you. ```bash cURL theme={null} curl -X POST https://api.vertracloud.app/v1/templates/from-app/app-abc123def456 \ -H "Authorization: Bearer $VERTRA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "id": "support-bot", "name": { "pt-br": "Bot de suporte", "en": "Support bot" }, "description": { "pt-br": "Bot que responde o suporte." }, "category": "bots", "member": { "resource_id": "app-abc123def456", "service_id": "bot", "env": [ { "key": "DISCORD_TOKEN", "mode": "question", "label": { "pt-br": "Token do bot", "en": "Bot token" } }, { "key": "LOG_LEVEL", "mode": "keep" } ] } }' ``` ### Response The same template object returned by [Create a Private Template](https://docs.vertracloud.app/api-reference/endpoint/templates/create.md), with `201 Created`: `id`, `slug`, `origin` (`private`), `name`, `description`, `category`, `tags`, `current_version`, `services`, `inputs`, `permissions`, `outputs` and the other fields listed there. ```json Response theme={null} { "response": { "id": "tpl-abc123def456", "slug": "support-bot", "origin": "private", "visibility": "public", "name": { "pt-br": "Bot de suporte", "en": "Support bot" }, "description": { "pt-br": "Bot que responde o suporte." }, "category": "bots", "tags": [], "current_version": { "id": "tplv-111222333444", "version": "1.0.0", "security": false, "created_at": "2026-10-27T14:02:00Z" }, "creates_stack": false, "inputs": [ { "id": "discord_token", "type": "secret", "label": { "pt-br": "Token do bot", "en": "Bot token" } } ], "created_at": "2026-10-27T14:02:00Z", "updated_at": "2026-10-27T14:02:00Z" } } ``` ### Error Responses **code** `string` The error code indicating the reason for the failure. Possible values: * `API_KEY_SCOPE_DENIED`: The API key does not have the `templates:write` scope (`403`). * `APP_NOT_FOUND`: The application does not exist or is not yours. * `TEMPLATE_SAVE_NOT_ALLOWED`: The application came from a share link, or runs a platform image (`403`). * `TEMPLATE_CLOSED`: The application comes from a closed template (`403`). * `TEMPLATE_MANIFEST_INVALID`: The result is not a valid manifest, or a `keep` variable holds something that looks like a credential; `details.issues` lists the findings. * `TEMPLATE_SECRET_IN_SOURCE`: A file selected from `/app` holds a secret; `details.files` lists the paths (`400`). * `TEMPLATE_SLUG_TAKEN`: The slug is already in use among your templates or is reserved. * `TEMPLATE_PRIVATE_LIMIT_REACHED`: The account already has 5 private templates. * `PLAN_DOES_NOT_SUPPORT_CUSTOM_IMAGES`: The plan cannot create templates. * `WORKSPACE_OWNER_ONLY`: Only the workspace owner saves templates in it. ```json Error Response theme={null} { "code": "TEMPLATE_SAVE_NOT_ALLOWED" } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.