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

# bookmarks.move()

> Move a bookmark to another change.

Move an existing bookmark to a new change ID.

**Required scope: `write`**

```ts theme={null}
const bookmark = await mesa.bookmarks.move({
  repo: 'app',
  bookmark: 'main',
  change_id: 'zyxwvutsrqponmlkzyxwvutsrqponmlk',
});

console.log(bookmark.from_change_id, bookmark.change_id);
```

## Options

<ParamField path="repo" type="string" required>
  Repository name.
</ParamField>

<ParamField path="bookmark" type="string" required>
  Bookmark to move.
</ParamField>

<ParamField path="change_id" type="string" required>
  Target change ID.
</ParamField>

<ParamField path="org" type="string | undefined">
  Organization override.
</ParamField>

## Response

<ResponseField name="name" type="string">
  Bookmark name.
</ResponseField>

<ResponseField name="change_id" type="string">
  Change ID the bookmark points to.
</ResponseField>

<ResponseField name="is_default" type="boolean">
  Whether this is the repository default bookmark.
</ResponseField>

<ResponseField name="from_change_id" type="string | null">
  Previous change ID before the move, or null when unavailable.
</ResponseField>