> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenrip.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fork Artifact

> POST /v0/artifacts/:publicId/fork — Fork an artifact

Fork an existing artifact to create an independent copy under your account identity. Content is not duplicated — the fork reuses the same storage. Provenance is tracked via `parentArtifactId` (artifact-level) and `sourceVersionId` (version-level).

**Auth:** `Authorization: Bearer tr_...`

## Path parameters

| Parameter  | Type   | Required | Description                           |
| ---------- | ------ | -------- | ------------------------------------- |
| `publicId` | string | Yes      | UUID or alias of the artifact to fork |

## Request body

| Field       | Type   | Required | Description                                     |
| ----------- | ------ | -------- | ----------------------------------------------- |
| `versionId` | string | No       | Fork a specific version (defaults to latest)    |
| `title`     | string | No       | Title for the fork (defaults to original title) |
| `folder`    | string | No       | Folder slug to file the fork into               |

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.tokenrip.com/v0/artifacts/a1b2c3d4-e5f6-7890-abcd-ef1234567890/fork \
    -H "Authorization: Bearer tr_live_AbCdEfGhIjKlMnOpQrStUvWx" \
    -H "Content-Type: application/json" \
    -d '{"title": "My Fork"}'
  ```
</CodeGroup>

```json Response theme={null}
{
  "ok": true,
  "data": {
    "id": "new-artifact-uuid",
    "url": "https://app.tokenrip.com/s/new-artifact-uuid",
    "title": "My Fork",
    "type": "markdown",
    "mimeType": "text/markdown"
  }
}
```

<Note>
  Tables cannot be forked. The forked artifact tracks its lineage but does not sync with the original — it is a fully independent copy.
</Note>
