---
title: "Move a workspace artifact into a Team Space folder"
method: POST
path: "/v1/workspaces/{workspaceId}/artifacts/{artifactId}/move"
tags: ["Folders"]
---

# Move a workspace artifact into a Team Space folder

`POST /v1/workspaces/{workspaceId}/artifacts/{artifactId}/move`

## Request

- Base URL: `https://shareout.site`
- URL: `https://shareout.site/v1/workspaces/{workspaceId}/artifacts/{artifactId}/move`
- Auth: HTTP bearer

Pass `folder_id: null` to unfile it.

## Request body

- object
  - `folder_id` string, nullable, required

## Response `200`

Moved

## Other responses

- `404`: Resource not found

## Changes

- **2026-10-13** `ed6fa61bd690`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shareout/apis/shareout-rest-api/changes/v1/workspaces/:workspaceId/artifacts/:artifactId/move/post.md)

---

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