> ## Documentation Index
> Fetch the complete documentation index at: https://docs.frogbot.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Use a template

> Creates the app with you as its Admin and queues its first build. With no paid app free and no free preview left it answers 402 with the page that pays for one more in `data.url`; a taken name is 409 with `data.code: name_taken`.



## OpenAPI

````yaml https://dojo.frogbot.ai/api/openapi.json post /api/templates/{id}/use
openapi: 3.1.0
info:
  title: Dojo API
  version: '1'
  description: >-
    Everything Dojo's pages do, for scripts and agents. Sign in with an API key
    as `Authorization: Bearer fb_…`. Paying and accepting the terms happen at a
    link a route answers, for a person to open.
servers:
  - url: https://dojo.frogbot.ai
security:
  - apiKey: []
tags:
  - name: Sign-in
  - name: Workspaces
  - name: Projects
  - name: Apps
  - name: Templates
  - name: Sharing
  - name: Deployments
  - name: Environment variables
  - name: Domains
  - name: Data
  - name: Billing
  - name: API keys
paths:
  /api/templates/{id}/use:
    post:
      tags:
        - Templates
      summary: Use a template
      description: >-
        Creates the app with you as its Admin and queues its first build. With
        no paid app free and no free preview left it answers 402 with the page
        that pays for one more in `data.url`; a taken name is 409 with
        `data.code: name_taken`.
      operationId: post/api/templates/:id/use
      parameters:
        - name: id
          in: path
          required: true
          description: The template's id.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                workspace:
                  type: string
                  description: A document id.
                name:
                  type: string
                slug:
                  type: string
              required:
                - workspace
                - name
                - slug
            example:
              workspace: 6720f1…
              name: Acme helpdesk
              slug: acme-helpdesk
      responses:
        '201':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  app:
                    type: object
                    properties:
                      id:
                        type: string
                        description: A document id.
                      slug:
                        type: string
                      name:
                        type: string
                    required:
                      - id
                      - slug
                      - name
                  deploymentId:
                    type: string
                    description: A document id.
                required:
                  - app
                  - deploymentId
        '400':
          description: '`invalid_request`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
        '401':
          description: '`unauthorized`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
        '402':
          description: '`payment_required`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
        '404':
          description: '`not_found`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
        '409':
          description: '`conflict`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
        '429':
          description: '`rate_limited`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
components:
  schemas:
    Errors:
      type: object
      required:
        - errors
      properties:
        errors:
          type: array
          items:
            type: object
            required:
              - message
            properties:
              message:
                type: string
              data:
                type: object
                properties:
                  code:
                    type: string
                  url:
                    type: string
                    description: Where a person takes the next step, such as paying.
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        An API key from `frogbot deploy`'s sign-in, `/api/cli/device/token`, or
        the API keys page.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.