*API REST › Objetos › Catálogo e inventario*

# Colección

> Nodo del árbol por el que se organiza el catálogo.

Un nodo del árbol con el que se organiza el catálogo. Los artículos, espacios, vehículos, personal y servicios cuelgan de una colección. La lista devuelve el árbol como lista plana: cada nodo lleva su `parentId`, su `path` completo y su `depth`, así que reconstruyes el árbol de una sola pasada con [`GET /api/v1/collections`](https://docs.filmo.io/es/rest-api/endpoint-reference/collections/list-collections).

Esquemas: `CollectionDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `id` | string | Identificador único de la colección. |
| `name` | string | Nombre de la colección. |
| `path` | string | Nombre completo desde la colección de nivel superior, con los niveles unidos por " > ". |
| `entityType` | string | Qué agrupa la colección: item, space, vehicle, staff o service. `item`, `space`, `vehicle`, `staff`, `service` |
| `parentId` | string | Identificador de la colección padre; null para una colección de primer nivel. |
| `depth` | integer | Niveles por encima: 0 para una colección de primer nivel, 1 para sus hijas, y así sucesivamente. |
| `order` | number | Orden de visualización entre sus hermanos. |
| `itemCount` | integer | Entidades directamente en esta colección, sin contar sus subcolecciones. |
| `createdAt` | string<date-time> | Fecha de creación en ISO 8601 UTC; null si no consta. |
| `updatedAt` | string<date-time> | Fecha de la última modificación en ISO 8601 UTC; null si no está registrada. |

## Valores

| Campo | Valores |
| --- | --- |
| `entityType` | `item`, `space`, `vehicle`, `staff`, `service` |

## Ejemplo

*Collection · Generado a partir del esquema*

```json
{
  "id": "id_8f2a1c",
  "name": "Example",
  "path": "string",
  "entityType": "item",
  "parentId": "string",
  "depth": 1,
  "order": 1,
  "itemCount": 1,
  "createdAt": "2026-09-01T08:00:00Z",
  "updatedAt": "2026-09-01T08:00:00Z"
}
```

## Lo devuelven

- [`GET /api/v1/collections`](https://docs.filmo.io/es/rest-api/endpoint-reference/collections/list-collections) — Listar colecciones

## Lo modifican

Ninguna operación.

---

URL canónica: https://docs.filmo.io/es/rest-api/objects/collection  
Última actualización: 2026-10-25