# API

## upload file in to IPFS 

<mark style="color:green;">`POST`</mark> `https://api.djib.cloud/api/v1/ipfs/drive/upload`

#### Headers

| Name                                        | Type | Description |
| ------------------------------------------- | ---- | ----------- |
| X-API-Key<mark style="color:red;">\*</mark> |      |             |

#### Request Body

| Name                                    | Type | Description        |
| --------------------------------------- | ---- | ------------------ |
| files<mark style="color:red;">\*</mark> | file |                    |
| path                                    | /    | path to the folder |

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

```json
{
    "data": {
        "status": "OK"
    },
    "message": null,
    "status": 0
}
```

{% endtab %}
{% endtabs %}

<mark style="color:green;">`POST`</mark> `https://api.djib.cloud/api/v1/ipfs/drive/mkdir`

#### Request Body

| Name                                   | Type | Description                             |
| -------------------------------------- | ---- | --------------------------------------- |
| name<mark style="color:red;">\*</mark> |      | folder name                             |
| parent                                 | /    | parent folder, if empty it is root then |

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

```postman_json
{
    "data": {
        "status": "ok"
    },
    "message": null,
    "status": 0
}
```

{% endtab %}
{% endtabs %}

{% openapi src="<https://3144134972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6MrZ6BqPMP2mmJKSKsG8%2Fuploads%2F2w7KQIzlCZzWOBzuRBw7%2Fdriveyml.yml?alt=media&token=50885c20-da81-47d1-95b9-84abd9700435>" path="/drive/ls" method="get" %}
[driveyml.yml](https://3144134972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6MrZ6BqPMP2mmJKSKsG8%2Fuploads%2F2w7KQIzlCZzWOBzuRBw7%2Fdriveyml.yml?alt=media\&token=50885c20-da81-47d1-95b9-84abd9700435)
{% endopenapi %}

{% openapi src="<https://3144134972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6MrZ6BqPMP2mmJKSKsG8%2Fuploads%2F2w7KQIzlCZzWOBzuRBw7%2Fdriveyml.yml?alt=media&token=50885c20-da81-47d1-95b9-84abd9700435>" path="/drive/export" method="get" %}
[driveyml.yml](https://3144134972-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6MrZ6BqPMP2mmJKSKsG8%2Fuploads%2F2w7KQIzlCZzWOBzuRBw7%2Fdriveyml.yml?alt=media\&token=50885c20-da81-47d1-95b9-84abd9700435)
{% endopenapi %}