Carbon Voice

Instructions

Implementation Reference

• src/server.ts:758-771 (handler)

  MCP tool handler for 'move_folder' that handles authentication and delegates to simplifiedApi.moveFolder.

  async (args: MoveFolderInput, { authInfo }): Promise<McpToolResponse> => {
    try {
      return formatToMCPToolResponse(
        await simplifiedApi.moveFolder(
          args.id,
          args,
          setCarbonVoiceAuthHeader(authInfo?.token),
        ),
      );
    } catch (error) {
      logger.error('Error moving folder:', { error });
      return formatToMCPToolResponse(error);
    }
  },

• src/server.ts:747-772 (registration)

  Registers the 'move_folder' tool with the MCP server, defining its description, input schema, and handler function.

  server.registerTool(
    'move_folder',
    {
      description:
        'Move a folder by its ID. Move a Folder into another Folder or into a Workspace.',
      inputSchema: moveFolderParams.merge(moveFolderBody).shape,
      annotations: {
        readOnlyHint: false,
        destructiveHint: false,
      },
    },
    async (args: MoveFolderInput, { authInfo }): Promise<McpToolResponse> => {
      try {
        return formatToMCPToolResponse(
          await simplifiedApi.moveFolder(
            args.id,
            args,
            setCarbonVoiceAuthHeader(authInfo?.token),
          ),
        );
      } catch (error) {
        logger.error('Error moving folder:', { error });
        return formatToMCPToolResponse(error);
      }
    },
  );

• src/interfaces/folder.interface.ts:19-20 (schema)

  TypeScript type definition for the input of the move_folder tool, combining path and body parameters.

  export type MoveFolderInput = z.infer<typeof moveFolderParams> &
    z.infer<typeof moveFolderBody>;

• src/generated/carbon-voice-api.ts:641-655 (helper)

  Generated API helper function that performs the actual HTTP PATCH request to move the folder to a target workspace or folder.

  const moveFolder = (
    id: string,
    moveFolderPayload: MoveFolderPayload,
    options?: SecondParameter<typeof mutator>,
  ) => {
    return mutator<Folder>(
      {
        url: `/simplified/folders/${id}/move`,
        method: 'PATCH',
        headers: { 'Content-Type': 'application/json' },
        data: moveFolderPayload,
      },
      options,
    );
  };

• src/generated/models/MoveFolderPayload.ts:80-85 (schema)

  Interface defining the payload for the move_folder operation, specifying the target workspace_id or folder_id.

  export interface MoveFolderPayload {
    /** Workspace ID */
    workspace_id?: string;
    /** Folder ID */
    folder_id?: string;
  }