Ir al contenido

Listar carpetas de proyecto

GET/api/project-folder

Devuelve la lista paginada de carpetas. Usa BaseControllerHelper::index. Los parámetros comunes (per_page, status, trashed, ids, fechas…) se describen en Paginación y filtros. Aquí solo se listan los propios de la carpeta.

project_idinteger

Devuelve solo las carpetas de ese proyecto.

project_folder_parent_idinteger

Devuelve solo las subcarpetas de esa carpeta.

parent_onlyboolean

Con el valor true devuelve solo las carpetas de primer nivel. En la consulta solo se reconoce el texto true; el valor 1 no activa el filtro.

filtersstring

Filtros con el formato campo:valor. Campos admitidos: los terminados en _id que están en $fillable (entre ellos project_id y project_folder_parent_id, además de los *_user_id de auditoría).

relationsstring

Relaciones a cargar. Ver Resumen.

count_relationsstring

Sin efecto: el modelo no define conteos permitidos.

orderstring

Orden de los resultados. Campos permitidos: id, name, created_at, updated_at, status. Por defecto id|DESC.

No exige un permiso del módulo: ProjectFolderPolicy::viewAny devuelve verdadero para cualquier usuario autenticado.

Ventana de terminal
curl -G \
"https://servererp.allendostmen.app/api/project-folder" \
-H "Authorization: Bearer $TOKEN" \
-H "Accept: application/json" \
--data-urlencode "project_id=1" \
--data-urlencode "parent_only=true" \
--data-urlencode "order=name|ASC"
Lista de carpetas200
{
"current_page": 1,
"data": [
{
"id": 4,
"project_id": 1,
"name": "Cotizaciones de materiales",
"description": "Carpeta de primer nivel",
"project_folder_parent_id": null,
"level": 1,
"status": "activo",
"previous_status": null,
"status_update_comment": null,
"status_update_date": null,
"status_update_user_id": null,
"create_user_id": 1,
"update_user_id": null,
"delete_user_id": null,
"restore_user_id": null,
"created_at": "2026-11-19T10:40:15.000000Z",
"updated_at": "2026-11-19T10:40:15.000000Z",
"deleted_at": null
}
],
"first_page_url": "https://servererp.allendostmen.app/api/project-folder?page=1",
"from": 1,
"last_page": 1,
"last_page_url": "https://servererp.allendostmen.app/api/project-folder?page=1",
"next_page_url": null,
"path": "https://servererp.allendostmen.app/api/project-folder",
"per_page": 20,
"prev_page_url": null,
"to": 1,
"total": 1
}
Sin permiso403
{
"message": "This action is unauthorized."
}