> For the complete documentation index, see [llms.txt](https://docs.ellipsis-drive.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ellipsis-drive.com/developers/api-v3/path-bookmark/create-new-bookmark.md).

# Create new bookmark

| **Description** | Creates a path of type bookmark |
| --------------- | ------------------------------- |
| **Endpoint**    | `/path/bookmark`                |
| **Method**      | POST                            |

### Access Level Rules

| **Minimum Access Level** | edit+ on parent folder or account holder in root. |
| ------------------------ | ------------------------------------------------- |

### Processing Units

| **Processing units** | 1 |
| -------------------- | - |

### Parameters

<table><thead><tr><th>Name</th><th>Description</th><th>Required</th><th>Default</th><th data-hidden>Required</th><th data-hidden>Default</th></tr></thead><tbody><tr><td><code>name</code></td><td>The name of the new bookmark</td><td>true</td><td></td><td>true</td><td></td></tr><tr><td><code>bookmark</code></td><td>A JSON with properties layers and dems.<br><br>Layers should be a list of JSONs containing the properties "type", "id" and "selected". <br><br>Type should be one of "ellipsis", "base" or "external". <br><br>Selected should be boolean. <br><br>Id should be the id of the layer or external layer. In case of type "base" you can choose between id=1 (open street map) and id=2 (google satellite map). <br><br>dems should be a list of JSONs containing the properties "id" and "selected". <br><br>Selected should be boolean. <br><br>Id should be the id of the raster layer.</td><td>true</td><td></td><td></td><td></td></tr><tr><td><code>thumbnail</code></td><td>A thumbnail image as base64.</td><td>false</td><td>Default null.</td><td></td><td></td></tr><tr><td><code>parentId</code></td><td><p>The id of the parent folder of the new path.</p><p>If omitted the new path is placed in your myDrive root.</p></td><td>false</td><td>Default null.</td><td>false</td><td>null</td></tr><tr><td><code>publicAccess</code></td><td><a href="/pages/jWHxOKKaASR2HwgmIQkh">Public access object</a> with properties "hidden" and "accessTier"<br><br>"accessTier" must be between "none" and "edit" and "hidden" must be a boolean.</td><td>false</td><td>Default {accessTier:"none", hidden:true}.</td><td>false</td><td>publicAccessLevel</td></tr><tr><td><code>metadata</code></td><td>A JSON with property "description" with the description of the file.</td><td>false</td><td>Default null.</td><td></td><td></td></tr></tbody></table>

Example request:

```
{
  name: 'test bookmark',
  metadata: { description: 'test description' },
  publicAccess: {hidden:true, accessTier:'view'},
  bookmark: {
    layers: [
      { type: 'ellipsis', id: '78cb1955-2910-4ede-9d21-2c6472d0ba71', selected: true },
      { type: 'base', id: 1, selected: true },
    ],
    dems: [{ id: '085f5e10-63b6-4e8f-a4c6-dce9689100d3', selected: false }],
  },
};

```