Crear una carpeta de proyecto
POST/api/project-folder
Crea una carpeta con estado activo. Si se envía project_folder_parent_id, la carpeta es una subcarpeta y su level es el de la carpeta padre más uno. Una carpeta de segundo nivel no puede tener subcarpetas. En la respuesta de creación, level solo aparece cuando hay carpeta padre; las carpetas de primer nivel quedan con nivel 1 por defecto en la base de datos.
Parámetros del cuerpo
Sección titulada «Parámetros del cuerpo»project_idintegerobligatorioProyecto de la carpeta. Debe existir en proyectos.
namestringobligatorioNombre de la carpeta. Máximo 255 caracteres.
descriptionstringDescripción de la carpeta.
project_folder_parent_idintegerCarpeta padre. Debe existir en carpetas de proyecto. Si la carpeta padre ya es de segundo nivel, responde 422 con No se puede crear la carpeta porque se excedió el límite de subcarpetas permitido.
Permiso
Sección titulada «Permiso»project-folder.create, que se valida en ProjectFolderPolicy::create.
curl -X POST \ "https://servererp.allendostmen.app/api/project-folder" \ -H "Authorization: Bearer $TOKEN" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "project_id": 1, "name": "Materiales eléctricos", "description": "Subcarpeta de materiales", "project_folder_parent_id": 4}'const response = await fetch( "https://servererp.allendostmen.app/api/project-folder", { method: "POST", headers: { Authorization: `Bearer ${token}`, Accept: "application/json", "Content-Type": "application/json", }, body: JSON.stringify({ project_id: 1, name: "Materiales eléctricos", description: "Subcarpeta de materiales", project_folder_parent_id: 4, }), },);const data = await response.json();use Illuminate\Support\Facades\Http;
$response = Http::withToken($token) ->acceptJson() ->post('https://servererp.allendostmen.app/api/project-folder', [ 'project_id' => 1, 'name' => 'Materiales eléctricos', 'description' => 'Subcarpeta de materiales', 'project_folder_parent_id' => 4, ]);Carpeta creada201
{ "project_id": 1, "name": "Materiales eléctricos", "description": "Subcarpeta de materiales", "project_folder_parent_id": 4, "status": "activo", "previous_status": null, "level": 2, "create_user_id": 1, "updated_at": "2026-11-19T10:40:15.000000Z", "created_at": "2026-11-19T10:40:15.000000Z", "id": 5}Sin permiso403
{ "message": "This action is unauthorized."}Datos no válidos422
{ "message": "No se puede crear la carpeta porque se excedió el límite de subcarpetas permitido.", "errors": { "level": [ "No se puede crear la carpeta porque se excedió el límite de subcarpetas permitido." ] }}