From 5154fc878517549351f76c27dbba14ed6c15c2b7 Mon Sep 17 00:00:00 2001
From: simon-sarrafi <simon.sarrafi@saucelabs.com>
Date: Tue, 19 Nov 2024 14:07:51 +0100
Subject: [PATCH] [TF-2152] Copy Build to a folder rest api (#3014)

---
 docs/testfairy/api-reference/rest-api.md | 41 ++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/docs/testfairy/api-reference/rest-api.md b/docs/testfairy/api-reference/rest-api.md
index 1f38a51f91..ddda477522 100644
--- a/docs/testfairy/api-reference/rest-api.md
+++ b/docs/testfairy/api-reference/rest-api.md
@@ -212,6 +212,47 @@ Delete a specific build. When all builds of a project are deleted, the project i
 
 ---
 
+### Copy a Specific Build to a Folder
+
+<details>
+<summary><span className="api post">POST</span><code>/api/1/projects/&#123;project-id&#125;/builds/&#123;build-id&#125;/copy</code></summary>
+<p></p>
+
+Use this endpoint to copy a specific build to a specified folder. You can either create a new folder or copy the build to an existing one.
+#### Parameters
+
+<table id="table-api">
+	<tbody>
+		<tr>
+			<td><code>folder_name</code></td>
+			<td><p><small>| REQUIRED | STRING |</small></p><p>The name or path of the target folder. Examples: Folder1 or /Project1/Folder1.</p></td>
+		</tr>
+	</tbody>
+</table>
+
+#### Responses
+
+<table id="table-api">
+	<tbody>
+		<tr>
+			<td><code>200</code></td>
+			<td colSpan='2'>Success.</td>
+		</tr>
+	</tbody>
+</table>
+
+```json title="Sample Response"
+{
+    "status": "ok",
+    "build_id": "1000",
+    "folder_path": "/Project1/Folder1"
+}
+```
+
+</details>
+
+---
+
 ### Download the Uploaded Artifact
 
 <details>