Ir al contenido

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.

project_idintegerobligatorio

Proyecto de la carpeta. Debe existir en proyectos.

namestringobligatorio

Nombre de la carpeta. Máximo 255 caracteres.

descriptionstring

Descripción de la carpeta.

project_folder_parent_idinteger

Carpeta 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.

project-folder.create, que se valida en ProjectFolderPolicy::create.

Ventana de terminal
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
}'
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."
]
}
}