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

# Métadonnées de sandbox

Les métadonnées de sandbox vous permettent d’associer des informations personnalisées sous forme de paires clé-valeur à une sandbox.

Les utilisations courantes incluent :

* Associer une sandbox à une session utilisateur.
* Enregistrer des données personnalisées liées à l’utilisateur pour une sandbox, comme des clés API.
* Lier une sandbox à un ID utilisateur afin de pouvoir s’y reconnecter plus tard.

Les métadonnées sont fournies lors de la création de la sandbox. Elles peuvent ensuite être lues lors de la récupération de la liste des sandboxes actives avec `Sandbox.list()`.

<CodeGroup>
  ```js JavaScript & TypeScript icon="js" theme={"system"}
  import { Sandbox } from 'novita-sandbox'

  // Start a sandbox and attach custom metadata.
  const sbx = await Sandbox.create({
    metadata: {
      userId: '123',
    },
  })

  // Retrieve active sandboxes and inspect their metadata.
  const page = await Sandbox.list()
  const active = await page.nextItems()

  console.log(active[0].metadata)
  // Example output:
  // { userId: '123' }
  ```

  ```python Python icon="python" theme={"system"}
  from novita_sandbox.core import Sandbox

  # Start a sandbox and attach custom metadata.
  sbx = Sandbox.create(
      metadata={
          "userId": "123",
      },
  )

  # Retrieve active sandboxes and inspect their metadata.
  page = Sandbox.list()
  active = page.next_items()

  print(active[0].metadata)
  # Example output:
  # {"userId": "123"}
  ```
</CodeGroup>

## Filtrage basé sur les métadonnées

Les sandboxes peuvent également être filtrées à l’aide de métadonnées lors de la récupération de la liste.