# rename method

Future<Link> rename (String newPath)

Renames this link. Returns a `Future<Link>` that completes with a Link instance for the renamed link.

If `newPath` identifies an existing link, that link is replaced. If `newPath` identifies an existing file or directory, the operation fails and the future completes with an exception.

## Implementation

    Future<Link> rename(String newPath);