Entidad
Tareas
Recuperar y gestionar tareas, predecesores, movimientos de proyectos, actualizaciones/inserciones, clones y el comportamiento de las notificaciones.
Puntos finales
/api/v2/tasksRecuperar una lista/api/v2/tasks/{id}Recuperar un registro/api/v2/tasksCrear registros/api/v2/tasksActualizar registros/api/v2/tasks/{id}Eliminar un registroAntecesores
/api/v2/tasks/{id}/predecessorsRecupera todos los predecesores de una tareaMover tareas
/api/v2/tasks/moveMover una o varias tareas a otro proyectoLa respuesta es un objeto JSON que representa el resultado de la operación de traslado. Envíe las tareas como una matriz de identificadores de tarea y el proyecto como el identificador del proyecto de destino. Solo las tareas y el proyecto deben estar presentes en la solicitud.
Para mover las tareas cuyos identificadores son 99259, 99260 y 99261 a un proyecto cuyo identificador es 12345:
curl -X POST \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "tasks": [ 99259, 99260, 99261 ], "project": 12345 }' \ 'https://app.celoxis.com/psa/api/v2/tasks/move'Desactivar notificaciones
/api/v2/tasks?notifications=falseActualiza una tarea sin notificaciones por correo electrónico ni en la aplicación.La respuesta es un objeto JSON con los detalles actualizados de la tarea. Al añadir `?notifications=false`, se evita que se envíen notificaciones por correo electrónico o dentro de la aplicación para la actualización. Incluya el ID y solo las propiedades que deban modificarse.
Para actualizar una tarea cuyo ID es 99266 y establecer su porcentaje de finalización actual en 64 sin enviar notificaciones:
curl -X PATCH \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "id": 99266, "actualPercentComplete": 64 }' \ 'https://app.celoxis.com/psa/api/v2/tasks?notifications=false'Agregar o insertar una tarea
/api/v2/tasks/upsertCrear o actualizar mediante clave externa/api/v2/tasks/upsertCrear o actualizar mediante clave externaProporcione una externalKey no vacía (el ID de su sistema), omita el ID e identifique el proyecto por ID, nombre o clave externa, según corresponda. Celoxis busca una tarea con esa externalKey en su empresa; si la encuentra, la actualiza; de lo contrario, la crea. La respuesta incluye el JSON habitual de la tarea, además de la acción ( creada o actualizada ) y el estado de éxito : verdadero . Si hay varias coincidencias, se devuelve un error HTTP 409.
curl -X POST \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "externalKey": "ERP-T-9876", "name": "Design review", "project": "ERP-P-1001" }' \ 'https://app.celoxis.com/psa/api/v2/tasks/upsert'Clonar una tarea
/api/v2/tasks/{id}/cloneCrea una tarea a partir de una tarea existenteEnvía un objeto JSON en el cuerpo de la solicitud con solo las propiedades que deben diferir de la tarea de origen. La respuesta es { data: {created-object} }.