---
title: "Archive tables, or bring them back"
method: POST
path: "/tables/archive/"
tags: ["tables"]
---

# Archive tables, or bring them back

`POST /tables/archive/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/tables/archive/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

archived true takes these tables off the list: out of All, their folder, Favorites and Recent, while search still finds them, they open as before and keep every row. archived false brings them back, into their folder. Nothing archives a table by itself; only this does.

## Request body

- TableArchiveSchema: Request body for archiving tables, or bringing them back.
  - `archived` boolean, required: True archives them: they leave All, their folder and Favorites and Recent, stay in search, and keep every row. False brings them back to the list, into their folder.
  - `table_ids` string[], required: The tables.

## Response `200`

Successful Response

- TablesChangedSchema: Which tables a move, owner change or archive actually changed.
  - `table_ids` string[], required: The tables changed. One already as asked, missing or in Trash is left out.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)
