---
description: >-
  Deletes the specified collection. Please note that you only have access to
  your own collections.
---

# collection.deleteCollection

**Note:** Requests must be made to **https://api.flipsnack.com/v1**.

## Request parameters <a href="#request_params" id="request_params"></a>

| Name                      | Type   | Description                                                                                                                                                                                                                                                                                                                                         |
| ------------------------- | ------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| apiKey (required)         | string | The API key provided for your user. If it is not specified, the request will return the error code "30 - Missing mandatory parameter". If the key is incorrect the request returns the error code "41 - Invalid credentials".                                                                                                                       |
| signature (required)      | string | The signature must be calculated by you and added to the request. See [How to sign a request](../how-to-sign-a-request) for more information. If the parameter is missing the request will return the error code "30 - Missing mandatory parameter". If the signature is incorrect the request will return the error code "44 - Invalid signature". |
| action (required)         | string | The API method that should be called. In this case the value should be _collection.deleteCollection_. If it is not specified, the request will return the error code "30 - Missing mandatory parameter".                                                                                                                                            |
| collectionHash (required) | string | TheThe hash of the collection you want to delete. If you do not specify a collection hash, then the request will return the error code "30 - Missing mandatory parameter".                                                                                                                                                                          |

## Response parameters <a href="#response_params" id="response_params"></a>

If the request is successful, The API does not send back data. It only responds with status code "20 - OK".



## Error codes <a href="#error_codes" id="error_codes"></a>

For complete list of error codes and messages go to [api-status-codes](../api-status-codes "mention") section.



## Examples <a href="#example" id="example"></a>

### Request

{% tabs %}
{% tab title="cURL" %}
```bash
# GET
curl -X GET \
     -G \
     https://api.flipsnack.com/v1/ \
     -d action=collection.deleteCollection \
     -d apiKey=<YOUR-API-KEY> \
     -d collectionHash=d3m0h45h \
     -d signature=<YOUR-REQUEST-SIGNATURE>
```
{% endtab %}

{% tab title="HTML" %}
```html
<form method="get" action="https://api.flipsnack.com/v1/">
    <input type="hidden" name="action" value="collection.deleteCollection">
    <input type="hidden" name="apiKey" value="<YOUR-API-KEY>">
    <input type="text" name="collectionHash">
    <input type="hidden" name="signature" value="<YOUR-REQUEST-SIGNATURE>">
    <button type="submit">Submit</button>
</form>
```
{% endtab %}
{% endtabs %}

### Response

{% tabs %}
{% tab title="JSON" %}
```json
{
    "code": 20,
    "status": "OK"
}
```
{% endtab %}
{% endtabs %}
