Add build_id reference option to tags documentation

Author: beran-t

docs/template/tags.mdx

@@ -270,3 +270,35 @@ stable_sandbox = Sandbox.create('my-tool:stable')  # Tested
 ```
 
 </CodeGroup>
+
+### Referencing a specific build
+
+Instead of using a named tag, you can start a sandbox from a specific build by passing its `build_id` directly. This is useful when you need to pin a sandbox to an exact build artifact — for example, during debugging or when reproducing an issue from a known build.
+
+The format follows the same colon syntax as tags: `<template>:<build_id>` or `<namespace>/<template>:<build_id>`.
+
+You can find the `build_id` from the return value of `Template.build()` or by listing tags with `Template.getTags()` / `Template.get_tags()`.
+
+<CodeGroup>
+
+```typescript JavaScript & TypeScript
+import { Sandbox } from 'e2b'
+
+// Start a sandbox from a specific build ID
+const sandbox = await Sandbox.create('my-template:f47ac10b-58cc-4372-a567-0e02b2c3d479')
+
+// With namespace
+const sandbox2 = await Sandbox.create('acme/my-template:f47ac10b-58cc-4372-a567-0e02b2c3d479')
+```
+
+```python Python
+from e2b import Sandbox
+
+# Start a sandbox from a specific build ID
+sandbox = Sandbox.create('my-template:f47ac10b-58cc-4372-a567-0e02b2c3d479')
+
+# With namespace
+sandbox2 = Sandbox.create('acme/my-template:f47ac10b-58cc-4372-a567-0e02b2c3d479')
+```
+
+</CodeGroup>