> ## 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.

# Move an app to another workspace

> Moves the app at once into `workspace`, which the caller must admin. It keeps running at its address, everyone keeps their access (Admins from outside that workspace as Editors), and that workspace pays for it from then on. Refused during a build, for an app in Trash or taken down, and when the workspace has no paid app free, with the page that pays for one in `data.url`.



## OpenAPI

````yaml https://dojo.frogbot.ai/api/openapi.json post /api/apps/{id}/move
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/apps/{id}/move:
    post:
      tags:
        - Apps
      summary: Move an app to another workspace
      description: >-
        Moves the app at once into `workspace`, which the caller must admin. It
        keeps running at its address, everyone keeps their access (Admins from
        outside that workspace as Editors), and that workspace pays for it from
        then on. Refused during a build, for an app in Trash or taken down, and
        when the workspace has no paid app free, with the page that pays for one
        in `data.url`.
      operationId: post/api/apps/:id/move
      parameters:
        - name: id
          in: path
          required: true
          description: The app's id.
          schema:
            type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                workspace:
                  type: string
                  description: A document id.
              required:
                - workspace
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  moved:
                    type: array
                    items:
                      type: string
                      description: A document id.
                required:
                  - moved
        '400':
          description: '`invalid_request`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
        '401':
          description: '`unauthorized`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Errors'
        '403':
          description: '`forbidden`'
          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'
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.