Carpetas

Todos los endpoints requieren autenticación. Ver Autenticación.

Base URL: https://fivehub.pro

Las carpetas permiten organizar los assets de tu organización en una jerarquía. Puedes anidar carpetas dentro de otras carpetas. Al eliminar una carpeta, sus subcarpetas también se eliminan y los assets dentro se mueven al nivel raíz.

---

GET /api/folders — Listar carpetas

Devuelve las carpetas de tu organización en un nivel determinado.

Parámetros query:

Parámetro	Tipo	Default	Descripción
parentId	string	—	ID de la carpeta padre. Omitir para obtener las carpetas raíz.

Respuesta 200:

{
  "folders": [
    {
      "id": "folder_abc123",
      "organizationId": "org_xyz",
      "parentId": null,
      "name": "Scripts",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  ]
}

cURL

# Carpetas raíz
curl "https://fivehub.pro/api/folders" \
  -H "x-api-key: TU_API_KEY"

# Subcarpetas de una carpeta
curl "https://fivehub.pro/api/folders?parentId=folder_abc123" \
  -H "x-api-key: TU_API_KEY"

JavaScript

// Carpetas raíz
const { folders } = await client.listFolders();

// Subcarpetas
const { folders: sub } = await client.listFolders({ parentId: 'folder_abc123' });

Lua (FiveM)

-- Carpetas raíz
exports.fivehub:ListFolders(function(err, data)
  for _, folder in ipairs(data.folders) do
    print(folder.name, folder.id)
  end
end)

-- Subcarpetas
exports.fivehub:ListFolders({ parentId = "folder_abc123" }, function(err, data)
  print("Subcarpetas:", #data.folders)
end)

---

POST /api/folders — Crear carpeta

Crea una nueva carpeta en tu organización.

Body: application/json

Campo	Tipo	Obligatorio	Descripción
name	string	Sí	Nombre de la carpeta.
parentId	string	No	ID de la carpeta padre. Omitir para crear en raíz.

Respuesta 201: Devuelve el objeto Folder creado.

cURL

# Carpeta en raíz
curl -X POST "https://fivehub.pro/api/folders" \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Scripts"}'

# Subcarpeta
curl -X POST "https://fivehub.pro/api/folders" \
  -H "x-api-key: TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "v2", "parentId": "folder_abc123"}'

JavaScript

// Carpeta en raíz
const folder = await client.createFolder('Scripts');

// Subcarpeta
const sub = await client.createFolder('v2', { parentId: 'folder_abc123' });
console.log(sub.id, sub.name);

Lua (FiveM)

-- Carpeta en raíz
exports.fivehub:CreateFolder("Scripts", function(err, folder)
  if err then print("Error:", err) return end
  print("Creada:", folder.id, folder.name)
end)

-- Subcarpeta
exports.fivehub:CreateFolder("v2", { parentId = "folder_abc123" }, function(err, folder)
  print("Subcarpeta creada:", folder.id)
end)

---

DELETE /api/folders/:id — Eliminar carpeta

Elimina una carpeta y todas sus subcarpetas. Los assets dentro de la carpeta eliminada no se borran — su folderId se establece en null y permanecen en el nivel raíz.

Respuesta 200: { "success": true }

cURL

curl -X DELETE "https://fivehub.pro/api/folders/folder_abc123" \
  -H "x-api-key: TU_API_KEY"

JavaScript

await client.deleteFolder('folder_abc123');

Lua (FiveM)

exports.fivehub:DeleteFolder("folder_abc123", function(err)
  if err then print("Error:", err) return end
  print("Carpeta eliminada")
end)

---

Tipo Folder

type Folder = {
  id: string;
  organizationId: string;
  parentId: string | null;  // null = carpeta raíz
  name: string;
  createdAt: string;        // ISO 8601
};