Opérations communes

Mise à jour des enregistrements

Mettez à jour un ou plusieurs enregistrements en envoyant uniquement les propriétés à modifier.

Mise à jour des enregistrements

PATCH/api/v2/{entity}Mettre à jour un ou plusieurs enregistrements

Lors de la mise à jour d'un seul enregistrement, la réponse est { data: {updated-object} }. Lors de la mise à jour de plusieurs enregistrements, la réponse est { data: [{updated-object-1}, {updated-object-2}, … {updated-object-N}] }.

Envoyez un objet JSON dans le corps de la requête pour mettre à jour un seul enregistrement, ou un tableau JSON pour en mettre à jour plusieurs. Indiquez l'identifiant et uniquement les propriétés à modifier. Les propriétés modifiables sont listées dans la documentation de référence des propriétés de l'API de votre compte Celoxis.

Pour mettre à jour une entrée horaire dont l'identifiant est 123456 et modifier sa durée à 2,5 et son code horaire à PM :

frapper

Exemple

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'

Déplacer les tâches entre les projets

POST/api/v2/tasks/moveDéplacer une ou plusieurs tâches vers un autre projet

La réponse est un objet JSON représentant le résultat de l'opération de déplacement. Envoyez un objet JSON pour déplacer des tâches, ou un tableau JSON pour déplacer plusieurs groupes de tâches. Seuls les champs « tâches » et « projet » doivent figurer dans la requête.

Pour déplacer les tâches dont les identifiants sont 99259, 99260 et 99261 vers un projet dont l'identifiant est 12345 :

frapper

Exemple

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'

Désactiver les notifications pour les mises à jour basées sur l'API

PATCH/api/v2/tasks?notifications=falseMettre à jour une tâche sans notification par e-mail ni dans l'application

La réponse est un objet JSON contenant les détails mis à jour de la tâche. L'ajout de ` ?notifications=false` garantit qu'aucune notification par e-mail ou dans l'application ne sera déclenchée lors de la mise à jour.

Envoyez un objet JSON dans le corps de la requête. Incluez l'identifiant et uniquement les propriétés à modifier.

Pour mettre à jour une tâche dont l'identifiant est 99266 et définir son pourcentage d'avancement réel à 64 sans envoyer de notifications :

frapper

Exemple

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'