---
title: "Upload state version"
method: POST
path: "/workspaces/{workspace_id}/state-versions"
tags: ["Terraform Remote Backend"]
---

# Upload state version

`POST /workspaces/{workspace_id}/state-versions`

Client sends state metadata and receives upload URL for 2-step state upload flow

## Path parameters

- `workspace_id` string, required

## Response `201`

State version created, upload URL returned

## Other responses

- `401` — Unauthorized
- `409` — Conflict
- `500` — Internal server error

---

[API](https://skmtc.net/firefly/apis/api-gateway.md) · [All operations](https://skmtc.net/firefly/apis/api-gateway/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firefly/api-gateway/revisions/eea119b4113f/schema)