# Archive a Use Case

Archive a use case by setting its status to `inactive`. Archived use cases are hidden from listings by default and will reject new event ingestion.

**Required scope:** `vision-events:manage`

{% openapi src="/files/XCSsl1XUH9tiFJObaN6D" path="/vision-events/use-cases/{useCaseId}/archive" method="post" %}
[openapi.yaml](https://1284666567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fe5GEiPeDoFksvZv1vH3A%2Fuploads%2Fgit-blob-d74beeed17fc5b3f8e39dcc93a9e9adaa7837101%2Fopenapi.yaml?alt=media)
{% endopenapi %}

### Path Parameters

* **`useCaseId`** (string, required): The ID of the use case to archive.

### Example Request

```bash
curl -X POST "https://api.roboflow.com/vision-events/use-cases/a1b3c8e1/archive" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

### Example Response

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

```json
{
  "success": true
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "Solution not found"
}
```

{% endtab %}

{% tab title="403" %}

```json
{
  "error": "Insufficient permissions for this resource."
}
```

{% endtab %}
{% endtabs %}

### Notes

* Archiving is a soft delete. The use case and its events are preserved but hidden from active listings.
* To view archived use cases, use the [List Use Cases](/developer/rest-api/vision-events/list-use-cases.md) endpoint with `status=inactive`.
* You can restore an archived use case using the [Unarchive a Use Case](/developer/rest-api/vision-events/unarchive-a-use-case.md) endpoint.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.roboflow.com/developer/rest-api/vision-events/archive-a-use-case.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.