> For the complete documentation index, see [llms.txt](https://docs.echo3d.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.echo3d.com/api/assetstatus.md).

# Asset Status

<figure><img src="/files/1ArXo1NNE2AW5sfmvzd0" alt=""><figcaption></figcaption></figure>

## Set Asset Status

<mark style="color:green;">`PUT`</mark> `https://api.echo3d.com/versionStatus`

#### Request Body

| Name                                            | Type   | Description                                                                                                                                                   |
| ----------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| key<mark style="color:red;">\*</mark>           | string | Your API key.                                                                                                                                                 |
| entryId<mark style="color:red;">\*</mark>       | string | The entry ID of the content entry being accessed.                                                                                                             |
| versionStatus<mark style="color:red;">\*</mark> | string | Any string  value denoting the status, eg `Approved`                                                                                                          |
| secKey<mark style="color:red;">\*</mark>        | string | Your collection's secret key. Required only if enabled through the [Security page](/web-console/manage-pages/collections-and-sharing/security.md#secret-key). |
| email<mark style="color:red;">\*</mark>         | string | Your email address                                                                                                                                            |
| userKey<mark style="color:red;">\*</mark>       | string | Your user authentication key                                                                                                                                  |

When setting a status, the success server response will always include the asset permission state.

{% tabs %}
{% tab title="200 Asset Unlocked (Default)" %}

```
open
```

{% endtab %}

{% tab title="200 Asset Locked" %}

```
closed
```

{% endtab %}
{% endtabs %}

## Asset Lock via Status Update

The status you set for your asset can be any string. If the status string exactly matches (case-sensitive) either of status strings below, the asset will be locked. This closes the individual asset's permissions and preventing any edits until the asset is unlocked by an admin:

```
Approved
```

```
Released
```

## Clear Asset Status

<mark style="color:red;">`DELETE`</mark> `https://api.echo3d.com/versionStatus`

#### Request Body

| Name                                      | Type   | Description                                                                                                                                                   |
| ----------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| key<mark style="color:red;">\*</mark>     | string | Your API key.                                                                                                                                                 |
| entryId<mark style="color:red;">\*</mark> | string | The entry ID of the content entry being accessed.                                                                                                             |
| secKey<mark style="color:red;">\*</mark>  | string | Your collection's secret key. Required only if enabled through the [Security page](/web-console/manage-pages/collections-and-sharing/security.md#secret-key). |
| email<mark style="color:red;">\*</mark>   | string | Your email address                                                                                                                                            |
| userKey<mark style="color:red;">\*</mark> | string | Your user authentication key                                                                                                                                  |

{% tabs %}
{% tab title="200 OK" %}
No Response Content
{% endtab %}
{% endtabs %}

If the asset was locked with a `Approved` or `Released` status, the deletion request will also unlock the asset.&#x20;