> For the complete documentation index, see [llms.txt](https://developers.couchdrop.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.couchdrop.io/administration/symlinks-shortcuts.md).

# Symlinks/Shortcuts

Managing symbolic links can be done through the admin interface or via the API. 

## Get all symbolic links in the organisation

<mark style="color:blue;">`GET`</mark> `https://api.couchdrop.io/manage/symlinks`

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    result: [
        {"source": "/link", "destination":"/dropbox/folder1", "id":"id1"},
        {"source": "/link2", "destination":"/dropbox/folder2", "id":"id2"}
    ]
}
```

{% endtab %}
{% endtabs %}

## Create a new symbolic link

<mark style="color:orange;">`PUT`</mark> `https://api.couchdrop.io/manage/symlinks`

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "result":{
        "id": "id1"
    }
}
```

{% endtab %}
{% endtabs %}

## Modify an existing symbolic link

<mark style="color:green;">`POST`</mark> `https://api.couchdrop.io/manage/symlinks`

#### Request Body

| Name                                          | Type   | Description                                                                                  |
| --------------------------------------------- | ------ | -------------------------------------------------------------------------------------------- |
| id<mark style="color:red;">\*</mark>          | String | ID of the symbolic link you are modifying                                                    |
| source<mark style="color:red;">\*</mark>      | String | The source path for the link. This is the path where the link will appear in the filesystem. |
| destination<mark style="color:red;">\*</mark> | String | The destination path. Where the link points to in the real filesystem                        |

## Delete an existing link

<mark style="color:red;">`DELETE`</mark> `https://api.couchdrop.io/manage/symlinks/<link_id>`

#### Path Parameters

| Name     | Type   | Description                             |
| -------- | ------ | --------------------------------------- |
| link\_id | String | The ID of the object you want to delete |