---
title: "Restore a space from trash"
method: POST
path: "/spaces/{spaceId}/restore"
tags: ["Spaces"]
---

# Restore a space from trash

`POST /spaces/{spaceId}/restore`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/spaces/{spaceId}/restore`
- Auth: HTTP bearer

Brings the space and the boards that went with it back. Plus and Max only.

## Response `200`

Restored.

- Space
  - `id` string: A space id, or the reserved `default` and `trash`.
  - `name` string
  - `builtIn` boolean
  - `role` 'owner' | 'admin' | 'editor' | 'reviewer': The product's roles. Owner is the workspace that holds the board or space and cannot be granted or transferred. Admin can rename and share, editor can edit, reviewer can view, export and add comment items. There is no viewer role and no pending state.
  - `boardCount` integer
  - `memberCount` integer
  - `coverUrl` string, uri, nullable
  - `publicUrl` string, uri, nullable
  - `position` integer: Dashboard order, lowest first.
  - `createdBy` string, nullable
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable
  - `deletedAt` string, date-time, nullable

## Other responses

- `402`: The workspace plan does not allow this, or AI credits are exhausted.
- `429`: Too many requests.

---

[API](https://skmtc.dev/mockflow/apis/mockflow-boards-api.md) - [All operations](https://skmtc.dev/mockflow/apis/mockflow-boards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mockflow/apis/mockflow-boards-api/revisions/1a890390518c?raw)