# Make an open editor tab the builder

> Picks one of your connected editor tabs with the remake's project open and makes it the builder: it gets a fresh builder token (any earlier one stops working), shows the build, and answers every lab call. Attaching again moves the builder to the freshest tab. With no such tab the call answers 409 `no_tab` with the project link: open it in the browser and retry.

### POST /v1/remakes/{id}/attach

**Make an open editor tab the builder**

Picks one of your connected editor tabs with the remake's project open and makes it the builder: it gets a fresh builder token (any earlier one stops working), shows the build, and answers every lab call. Attaching again moves the builder to the freshest tab. With no such tab the call answers 409 `no_tab` with the project link: open it in the browser and retry.

Auth: `Authorization: Bearer rl_live_...` with the `remake` scope.

Parameters:

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `id` | path | uuid | yes | The remake id. |

Responses:

| Status | Meaning |
| --- | --- |
| 200 | The tab is the builder. |
| 400 | Invalid request. |
| 401 | Missing, invalid or revoked key. |
| 403 | The key lacks the scope, or the key's owner has view-only access to the workspace (code `forbidden`). |
| 404 | Not found. |
| 409 | No connected tab of yours has the project open (code `no_tab`), or the remake ended (code `stage`). |
| 429 | Rate limited, or a monthly cap reached. |
| 504 | The tab did not answer (code `tab_timeout`). |

Response body (200):

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `attached` | enum | yes |  |
| `gpuRenderer` | string \| null | yes |  |

Example (curl):

```bash
curl -X POST https://api.raylight.app/v1/remakes/$ID/attach \
  -H "Authorization: Bearer $RAYLIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

## More

- Previous: [Read a remake](https://www.raylight.app/docs/reference/get-v1-remakes-id.md)
- Next: [Run one op in the builder tab](https://www.raylight.app/docs/reference/post-v1-remakes-id-lab.md)
- All docs: https://www.raylight.app/llms.txt
- Everything in one file: https://www.raylight.app/llms-full.txt
- OpenAPI: https://api.raylight.app/v1/openapi.json