---
name: schematics-ts-workspace-failure
title: I tried to create a workspace, why did it fail?
description: Review the following sections to help debugging `workspace new` failures.
last-updated: 2025-01-17
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/schematics?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# I tried to create a workspace, why did it fail? 
{: #wks-failure}

Review the following sections to help debugging `workspace new` failures. 

## Workspace create fails with message `Request Entity Too Large`
{: #wks-new-fails1}

When you create a workspace from an existing `terraform.tfstate` file, it fails with error code `413` and a message `Required Entiry Too Large`.
{: tsSymptoms}

Your workspace create did not reach the Schematics, due to the limitation of the `terraform.tfstate` file.
{: tsCauses}

Example error message

```text
FAILED
Could not create the workspace. Please verify that your request is correct. If the problem persists, contact IBM Cloud support.


Status Code: 413
Message:

<title>413 Request Entity Too Large</title>
```
{: screen}

The `terraform.tfstate` file must be less than 2 MB. When you create workspace from an existing Terraform state file, the `terraform.tfstate` file must be less than 2 MB. Greater than 2 MB state file is not supported in the Schematics. Rerun the workspace create operation with less than 2 MB state file.
{: tsResolve}