Operaciones comunes

Actualización de registros

Actualiza uno o varios registros enviando solo las propiedades que necesitan modificarse.

Actualizar registros

PARCHE/api/v2/{entity}Actualiza uno o varios registros

Al actualizar un registro, la respuesta es { data: {updated-object} }. Al actualizar varios registros, la respuesta es { data: [{updated-object-1}, {updated-object-2}, … {updated-object-N}] }.

Para actualizar un registro, envíe un objeto JSON en el cuerpo de la solicitud; para actualizar varios, envíe un array JSON. Incluya el ID y solo las propiedades que necesiten modificarse. Las propiedades actualizables se encuentran en la Referencia de propiedades de la API de su cuenta de Celoxis.

Para actualizar una entrada de tiempo cuyo ID es 123456 y cambiar sus horas a 2.5 y el código de tiempo a PM:

intento

Ejemplo

curl -g -X PATCH \ -H 'Content-Type: application/json' \ -H 'Authorization: bearer YourTokenHere' \ -d '{ "id": 123456, "hours": "2.5", "timeCode": "PM" }' \ 'https://app.celoxis.com/psa/api/v2/timeEntries'

Mover tareas entre proyectos

POST/api/v2/tasks/moveMover una o varias tareas a otro proyecto

La respuesta es un objeto JSON que representa el resultado de la operación de movimiento. Envíe un objeto JSON para mover tareas o un array JSON para mover varios grupos de tareas. La solicitud solo debe incluir tareas y el proyecto

Para mover las tareas cuyos identificadores son 99259, 99260 y 99261 a un proyecto cuyo identificador es 12345:

intento

Ejemplo

curl -g -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 las notificaciones para las actualizaciones basadas en API

PARCHE/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 garantiza que no se envíen notificaciones por correo electrónico ni dentro de la aplicación para esta actualización.

Envía un objeto JSON en el cuerpo de la solicitud. Incluye el ID y solo las propiedades que necesiten modificarse.

Para actualizar una tarea cuyo ID es 99266 y establecer su porcentaje de finalización actual en 64 sin enviar notificaciones:

intento

Ejemplo

curl -g -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'