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

# Transfer forms

> Move forms to another workspace. This needs a signed-in user, so it works with a CLI session but not with an API key. The user must be an admin of the destination workspace. Integrations are disconnected, forms get new public links, workspace payment questions are saved as drafts, and the forms are disabled.

> [!NOTE]
>
> Replace `{your-subdomain}` with your workspace’s subdomain. \
> Learn how to find your subdomain in [Workspace subdomain](https://apidocs.neetoform.com/api/workspace-subdomain.md).


## OpenAPI

````yaml bundled/forms.yaml POST /forms/transfer
openapi: 3.0.3
info:
  title: NeetoForm APIs
  version: 2.0.0
servers:
  - description: NeetoForm APIs
    url: https://{your-subdomain}.neetoform.com/api/external/v2
    variables:
      your-subdomain:
        default: spinkart
        description: >-
          Replace **spinkart** with your [workspace's
          subdomain](/api/workspace-subdomain).
security: []
paths:
  /forms/transfer:
    post:
      tags:
        - Forms
      summary: Transfer forms
      description: >-
        Move forms to another workspace. This needs a signed-in user, so it
        works with a CLI session but not with an API key. The user must be an
        admin of the destination workspace. Integrations are disconnected, forms
        get new public links, workspace payment questions are saved as drafts,
        and the forms are disabled.
      parameters:
        - $ref: '#/components/parameters/api_key_header'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - ids
                - destination_workspace
              properties:
                ids:
                  $ref: '#/components/schemas/ids_body_property'
                destination_workspace:
                  type: string
                  description: Subdomain of the workspace to move the forms to.
                  example: acme-eu
      responses:
        '200':
          description: OK - Forms transferred successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  form_ids:
                    type: array
                    items:
                      type: string
                  destination_workspace:
                    type: string
              example:
                form_ids:
                  - 6f1c2a9e-3b6d-4d8e-9a51-2f0c7d4e8b10
                destination_workspace: acme-eu
        '400':
          description: Bad Request - `ids` or `destination_workspace` is missing
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_response'
              example:
                error: 'param is missing or the value is empty or invalid: ids'
        '404':
          description: Not Found - The form does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_response'
              example:
                error: Form does not exist.
        '422':
          description: >-
            Unprocessable Entity - The request used an API key, or the
            destination is not a workspace where you are an admin
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/error_response'
              examples:
                api_key:
                  value:
                    error: >-
                      Transferring forms needs a signed-in user. API keys cannot
                      transfer forms.
                unknown_destination:
                  value:
                    error: >-
                      'foo' is not a workspace you can transfer forms to.
                      Workspaces where you are an admin: acme-eu, acme-us.
components:
  parameters:
    api_key_header:
      in: header
      name: X-Api-Key
      description: >-
        Use the X-Api-Key header to provide your workspace API key. Refer to
        [Authentication](/api/authentication) for more information.
      required: true
      schema:
        type: string
        default: your-api-key
  schemas:
    ids_body_property:
      type: array
      description: IDs of the forms.
      items:
        type: string
      example:
        - 6f1c2a9e-3b6d-4d8e-9a51-2f0c7d4e8b10
    error_response:
      type: object
      properties:
        error:
          type: string

````

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