# Directories

## Create Directory

<mark style="color:green;">`POST`</mark> `https://api.annolab.ai/v1/directory/create`

Create a new directory within the project

#### Headers

| Name          | Type   | Description                                                                                                                                                           |
| ------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Authorization | string | <p>Where you put your api key. Creating a directory requires a key with "Write" permissions.<br><code>{"Authorization": "Api-Key XXXXXXX-XXXXXXX-XXXXXXX"}</code></p> |

#### Request Body

| Name              | Type   | Description                                                                                                       |
| ----------------- | ------ | ----------------------------------------------------------------------------------------------------------------- |
| projectIdentifier | string | Identifier of the project that the directory will be created within. Either id or the unique name of the project. |
| name              | string | Name of the directory you wish to create                                                                          |

{% tabs %}
{% tab title="201 The directory was created" %}

```
{
    "name": "Wikipedia Subset",
    "id": 12,
    "projectname": "New NER Project",
    "projectId": 22
}
```

{% endtab %}

{% tab title="400 The directory could not be created" %}

```
{
    "message": "explanation for why directory could not be created"
}
```

{% endtab %}
{% endtabs %}

Example of how to make the request to create a directory

{% tabs %}
{% tab title="Python" %}

```python
import requests

ANNO_LAB_API_KEY = 'XXXXXXX-XXXXXXX-XXXXXXX-XXXXXXX'

directory = {
  'projectIdentifier': 'New NER Project',
  'name': 'Wikipedia Subset'
}

headers = {
  'Authorization': 'Api-Key '+ANNO_LAB_API_KEY,
}

url = 'https://api.annolab.ai/v1/directory/create'

response = requests.post(url, headers=headers, json=directory)

print(response.json())
```

{% endtab %}
{% endtabs %}