Modifier une de mes tâches
update_my_taskUpdates a task the user created and that is still to do: content, urgency, scheduling, assignee or type.
Description
Modifie dans Oxygenius une tâche que l'utilisateur connecté a créée et qui est encore à traiter : contenu, urgence (épinglage), date de planification, destinataire (réaffectation, notifiée) ou type. Seuls les paramètres fournis changent ; le contenu fourni remplace le contenu actuel. Le type doit rester proposé pour le destinataire (list_task_types). L'application refuse de modifier la tâche de quelqu'un d'autre ou une tâche déjà traitée. Avant l'appel, annoncer précisément la modification à l'utilisateur et attendre son accord. Renvoie la tâche à jour.
Required access
- At least one of these permissions:
dashboard.tasksWidget.viewordossier-detail.tab.task - Company that has enabled write tools (Settings → AI integration).
- Without them, the tool is not listed by
tools/listand calling it is refused.
Parameters
| Name | Type | Presence | Description |
|---|---|---|---|
taskId | integer | required | Identifiant de la tâche (champ id de search_tasks, get_my_tasks ou get_task). |
description | string | optional | Nouveau contenu, en texte brut (retours à la ligne permis, HTML non interprété). Remplace le contenu actuel. |
isUrgent | boolean | optional | Vrai pour marquer la tâche urgente (épinglée), faux pour retirer l'urgence. |
scheduledFor | string (date) | optional | Date de planification (AAAA-MM-JJ, après aujourd'hui) : la tâche n'est à traiter qu'à partir de ce jour. |
removeSchedule | boolean | optional | Vrai pour retirer la planification : la tâche est à traiter tout de suite. |
assigneeId | integer | optional | Identifiant du nouveau destinataire (champ id de search_users). |
taskTypeId | integer | optional | Identifiant du nouveau type de tâche (champ id de list_task_types). |
Result
The result is returned as structured content (structuredContent) matching the output schema below, and as JSON text for clients that do not read structured content. An error comes back with isError: true and a French message that explains what to fix.
Result fields
| Name | Type | Presence | Description |
|---|---|---|---|
step | string | Nature de l'étape : creation, reply (réponse) ou transfer (transfert). | |
thread | object[] | Étapes de l'échange (création, réponses, transferts, clôture), par ordre chronologique, la tâche demandée comprise. | |
thread[].taskId | integer | nullable | Identifiant de la tâche (absent pour une clôture). |
thread[].step | string | creation, reply (réponse), transfer (transfert) ou closure (clôture). | |
thread[].from | string | nullable | Auteur de l'étape. |
thread[].to | string | nullable | Destinataire (absent pour une clôture). |
thread[].date | string (date-time) | Date de l'étape, en heure locale belge. | |
thread[].description | string | nullable | Contenu, en texte (tronqué). |
id | integer | Identifiant de la tâche (à passer à get_task). | |
status | string | open (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée). | |
type | string | nullable | Type de tâche (catégorie), ex. Commande, Facturation. |
title | string | nullable | Titre, rarement renseigné. |
description | string | nullable | Contenu de la tâche, en texte (tronqué dans les listes). |
isUrgent | boolean | Vrai pour une tâche urgente (épinglée). | |
isOverdue | boolean | Vrai pour une tâche à traiter en retard : échéance dépassée, ou sans échéance, créée il y a plus de 5 jours (règle de l'application). | |
from | string | nullable | Expéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique). |
to | string | nullable | Destinataire. |
createdAt | string (date-time) | Date de création, en heure locale belge avec son décalage UTC. | |
dueDate | string (date) | nullable | Échéance (AAAA-MM-JJ), rarement renseignée. |
scheduledFor | string (date) | nullable | Date à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ). |
completedAt | string (date-time) | nullable | Date à laquelle la tâche a été traitée, en heure locale belge. |
dossierId | integer | nullable | Identifiant du dossier lié (à passer à get_dossier). |
dossierReference | string | nullable | Référence du dossier lié. |
dossierIndication | string | nullable | Intitulé court du dossier lié. |
MCP annotations
| Annotation | Value | Meaning |
|---|---|---|
title | Modifier une de mes tâches | Human-readable name shown by the MCP client. |
readOnlyHint | no | The tool changes nothing. |
destructiveHint | yes | The tool may change or delete existing data, or trigger an irreversible action. |
idempotentHint | yes | Calling it again with the same arguments has no further effect. |
openWorldHint | no | The tool reads e-mails or document content, or reaches an external service. |
JSON definition
Exact tools/list entry
{
"name": "update_my_task",
"title": "Modifier une de mes tâches",
"description": "Modifie dans Oxygenius une tâche que l'utilisateur connecté a créée et qui est encore à traiter : contenu, urgence (épinglage), date de planification, destinataire (réaffectation, notifiée) ou type. Seuls les paramètres fournis changent ; le contenu fourni remplace le contenu actuel. Le type doit rester proposé pour le destinataire (list_task_types). L'application refuse de modifier la tâche de quelqu'un d'autre ou une tâche déjà traitée. Avant l'appel, annoncer précisément la modification à l'utilisateur et attendre son accord. Renvoie la tâche à jour.",
"inputSchema": {
"type": "object",
"properties": {
"taskId": {
"description": "Identifiant de la tâche (champ id de search_tasks, get_my_tasks ou get_task).",
"type": "integer"
},
"description": {
"description": "Nouveau contenu, en texte brut (retours à la ligne permis, HTML non interprété). Remplace le contenu actuel.",
"type": [
"string",
"null"
],
"default": null
},
"isUrgent": {
"description": "Vrai pour marquer la tâche urgente (épinglée), faux pour retirer l'urgence.",
"type": [
"boolean",
"null"
],
"default": null
},
"scheduledFor": {
"description": "Date de planification (AAAA-MM-JJ, après aujourd'hui) : la tâche n'est à traiter qu'à partir de ce jour.",
"type": [
"string",
"null"
],
"format": "date",
"default": null
},
"removeSchedule": {
"description": "Vrai pour retirer la planification : la tâche est à traiter tout de suite.",
"type": "boolean",
"default": false
},
"assigneeId": {
"description": "Identifiant du nouveau destinataire (champ id de search_users).",
"type": [
"integer",
"null"
],
"default": null
},
"taskTypeId": {
"description": "Identifiant du nouveau type de tâche (champ id de list_task_types).",
"type": [
"integer",
"null"
],
"default": null
}
},
"required": [
"taskId"
]
},
"outputSchema": {
"type": "object",
"properties": {
"step": {
"description": "Nature de l'étape : creation, reply (réponse) ou transfer (transfert).",
"type": "string"
},
"thread": {
"description": "Étapes de l'échange (création, réponses, transferts, clôture), par ordre chronologique, la tâche demandée comprise.",
"type": "array",
"items": {
"type": "object",
"properties": {
"taskId": {
"description": "Identifiant de la tâche (absent pour une clôture).",
"type": [
"integer",
"null"
]
},
"step": {
"description": "creation, reply (réponse), transfer (transfert) ou closure (clôture).",
"type": "string"
},
"from": {
"description": "Auteur de l'étape.",
"type": [
"string",
"null"
]
},
"to": {
"description": "Destinataire (absent pour une clôture).",
"type": [
"string",
"null"
]
},
"date": {
"description": "Date de l'étape, en heure locale belge.",
"type": "string",
"format": "date-time"
},
"description": {
"description": "Contenu, en texte (tronqué).",
"type": [
"string",
"null"
]
}
},
"required": [
"step",
"date"
]
}
},
"id": {
"description": "Identifiant de la tâche (à passer à get_task).",
"type": "integer"
},
"status": {
"description": "open (à traiter), scheduled (planifiée : visible du destinataire à partir de scheduledFor) ou done (traitée : répondue, transférée ou clôturée).",
"type": "string"
},
"type": {
"description": "Type de tâche (catégorie), ex. Commande, Facturation.",
"type": [
"string",
"null"
]
},
"title": {
"description": "Titre, rarement renseigné.",
"type": [
"string",
"null"
]
},
"description": {
"description": "Contenu de la tâche, en texte (tronqué dans les listes).",
"type": [
"string",
"null"
]
},
"isUrgent": {
"description": "Vrai pour une tâche urgente (épinglée).",
"type": "boolean"
},
"isOverdue": {
"description": "Vrai pour une tâche à traiter en retard : échéance dépassée, ou sans échéance, créée il y a plus de 5 jours (règle de l'application).",
"type": "boolean"
},
"from": {
"description": "Expéditeur (« Système (automatique) » pour une tâche créée par un traitement automatique).",
"type": [
"string",
"null"
]
},
"to": {
"description": "Destinataire.",
"type": [
"string",
"null"
]
},
"createdAt": {
"description": "Date de création, en heure locale belge avec son décalage UTC.",
"type": "string",
"format": "date-time"
},
"dueDate": {
"description": "Échéance (AAAA-MM-JJ), rarement renseignée.",
"type": [
"string",
"null"
],
"format": "date"
},
"scheduledFor": {
"description": "Date à partir de laquelle une tâche planifiée apparaît chez son destinataire (AAAA-MM-JJ).",
"type": [
"string",
"null"
],
"format": "date"
},
"completedAt": {
"description": "Date à laquelle la tâche a été traitée, en heure locale belge.",
"type": [
"string",
"null"
],
"format": "date-time"
},
"dossierId": {
"description": "Identifiant du dossier lié (à passer à get_dossier).",
"type": [
"integer",
"null"
]
},
"dossierReference": {
"description": "Référence du dossier lié.",
"type": [
"string",
"null"
]
},
"dossierIndication": {
"description": "Intitulé court du dossier lié.",
"type": [
"string",
"null"
]
}
},
"required": [
"step",
"id",
"status",
"isUrgent",
"isOverdue",
"createdAt"
]
},
"annotations": {
"title": "Modifier une de mes tâches",
"destructiveHint": true,
"idempotentHint": true,
"openWorldHint": false,
"readOnlyHint": false
}
}