> For the complete documentation index, see [llms.txt](https://www.center.daxium-air.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.center.daxium-air.com/api-reference/doc-api/taches.md).

# Tâches

Récupérer les tâches liées aux fiches

## Rechercher des tâches

> Retourne les tâches du vertical métier, filtrées par les paramètres de requête ci-dessous.

```json
{"openapi":"3.0.0","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"tasks"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"oauth2":{}}],"components":{"securitySchemes":{"oauth2":{"type":"oauth2","description":"Envoyez l'access token sous la forme `Authorization: Bearer <token>`.","flows":{"password":{"tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}},"authorizationCode":{"authorizationUrl":"/oauth/v2/auth","tokenUrl":"/oauth/v2/token","refreshUrl":"/oauth/v2/token","scopes":{}}}}},"parameters":{"XAcceptVersion":{"name":"X-Accept-Version","in":"header","description":"Version de l'API à appliquer. Vaut `v1.0` si omise ; une valeur inconnue bascule sur la version la plus récente.","required":false,"schema":{"type":"string","default":"v1.3","enum":["v1.0","v1.1","v1.2","v1.3"]}}},"schemas":{"TaskListResponse":{"properties":{"server_time":{"type":"integer","format":"int64"},"tasks":{"type":"array","items":{"$ref":"#/components/schemas/Task"}},"total_count":{"type":"integer"},"total_pages":{"type":"integer"}},"type":"object"},"Task":{"properties":{"created_at":{"type":"integer","format":"int64"},"deleted_at":{"description":"Date de suppression. Présente uniquement lorsque la tâche a été supprimée.","type":"integer","format":"int64"},"delay_after":{"description":"Délai d'affichage indicatif en secondes après la fin de la tâche","type":"integer"},"delay_before":{"description":"Délai d'affichage indicatif en secondes avant le début de la tâche","type":"integer"},"due_date":{"description":"Date d'échéance (timestamp UNIX)","type":"integer","format":"int64"},"duration":{"description":"Durée prévue en secondes","type":"integer"},"fill_status":{"description":"Indique si le champ de date de fin de la fiche liée a été renseigné.","type":"string","enum":["filled","notfilled"]},"id":{"type":"string","format":"uuid"},"recurrency":{"description":"Présent uniquement sur une tâche récurrente.","allOf":[{"$ref":"#/components/schemas/Recurrency"}]},"start_date":{"description":"Date de début prévue (timestamp UNIX)","type":"integer","format":"int64"},"submission":{"$ref":"#/components/schemas/Submission"},"submission_model":{"description":"Présent uniquement lorsque la tâche a un modèle de fiche configuré — le gabarit à partir duquel la fiche de la tâche a été créée.","allOf":[{"$ref":"#/components/schemas/Submission"}]},"time_status":{"description":"Indique si la tâche est dans les temps par rapport à son échéance.","type":"string","enum":["normal","late","advance","notplanned","error"]},"updated_at":{"type":"integer","format":"int64"},"user_id":{"type":"integer"}},"type":"object"},"Recurrency":{"description":"Définition de la récurrence d'une tâche. `min_by_week` / `max_by_week` ne sont présents que pour une récurrence `weekly`, et `repeatEvery` / `ruleMonth` / `numofday` / `nth` / `dayOfWeek` / `taskTiming` uniquement pour une récurrence `monthly`.","properties":{"days":{"description":"Jours de la semaine (3 premières lettres en anglais : mon, tue, wed, thu, fri, sat, sun).\nPour la récurrence hebdomadaire, tous les jours ne sont pas requis.\n","type":"object","additionalProperties":{"properties":{"end":{"description":"Durée de la tâche en secondes","type":"integer"},"start":{"description":"Heure de début (format HH:MM)","type":"string"}},"type":"object"}},"dayOfWeek":{"description":"Récurrence mensuelle uniquement.","type":"string"},"end":{"description":"Condition de fin de la récurrence","properties":{"type":{"description":"`occurrence` = nombre d'occurrences, `date` = date de fin","type":"string","enum":["occurrence","date"]},"value":{"description":"Nombre d'occurrences ou date de fin (timestamp) selon `type`","type":"integer"}},"type":"object"},"interval":{"description":"Intervalle entre chaque occurrence (minimum 1)","type":"integer"},"max_by_week":{"description":"Récurrence hebdomadaire uniquement. Nombre maximum d'occurrences par semaine.","type":"integer"},"min_by_week":{"description":"Récurrence hebdomadaire uniquement. Nombre minimum d'occurrences par semaine.","type":"integer"},"notDaysoff":{"description":"Indique si la récurrence ignore les jours d'absence des utilisateurs.","type":"boolean"},"numofday":{"description":"Récurrence mensuelle uniquement.","type":"integer"},"nth":{"description":"Récurrence mensuelle uniquement.","type":"integer"},"repeatEvery":{"description":"Récurrence mensuelle uniquement. Nombre de mois entre chaque occurrence.","type":"integer"},"ruleMonth":{"description":"Récurrence mensuelle uniquement.","type":"string"},"taskTiming":{"description":"Récurrence mensuelle uniquement.","type":"string"},"type":{"description":"Type de récurrence","type":"string","enum":["daily","weekly","monthly"]}},"type":"object"},"Submission":{"properties":{"id":{"type":"string","format":"uuid"},"structure_id":{"description":"Identifiant du formulaire.","type":"integer"},"structure_version":{"description":"Version du formulaire avec laquelle la fiche a été remplie.","type":"integer"},"items":{"description":"Valeurs de la fiche, indexées par le nom système du champ. La forme d'une valeur dépend du type du champ.","type":"object","additionalProperties":true},"channels":{"description":"Diffusions correspondant à la fiche.","type":"array","items":{"type":"string"}},"user_id":{"description":"Propriétaire de la fiche.","type":"integer"},"last_updated_user_id":{"description":"Utilisateur ayant modifié la fiche en dernier.","type":"integer"},"assigned_user":{"description":"Utilisateur à qui la fiche est assignée. Présent uniquement lorsqu'elle est assignée.","type":"object"},"user":{"description":"Le propriétaire de la fiche — même forme d'objet que `assigned_user`. Présent uniquement lorsque la requête porte `items_expanded=true` ; absent des endpoints de liste et de recherche, quel que soit ce paramètre.","type":"object"},"subscribers":{"description":"Utilisateurs abonnés à la fiche.","type":"array","items":{"type":"string"}},"current_state":{"description":"État du workflow dans lequel se trouve actuellement la fiche.","type":"string","format":"uuid"},"submission_number":{"description":"Numéro séquentiel à l'échelle du vertical métier.","type":"integer"},"number_in_structure":{"description":"Numéro séquentiel au sein du formulaire.","type":"integer"},"latitude":{"type":"number"},"longitude":{"type":"number"},"settings":{"type":"object"},"task_id":{"description":"Tâche à laquelle la fiche appartient, lorsqu'il y en a une.","type":"string","format":"uuid"},"data_created_at":{"description":"Date de création de la donnée sur le serveur.","type":"integer"},"data_updated_at":{"description":"Date de dernière modification de la donnée sur le serveur.","type":"integer"},"created_at":{"type":"integer"},"updated_at":{"type":"integer"},"deleted_at":{"description":"Date de suppression. Présente uniquement lorsque la fiche a été supprimée.","type":"integer"},"read_at":{"description":"Date à laquelle la fiche a été marquée comme lue. Présente uniquement une fois que cela a eu lieu.","type":"string","format":"date-time"}},"type":"object"},"ErrorResponse":{"description":"Corps d'erreur standardisé retourné par le subscriber d'exceptions REST.","properties":{"code":{"description":"Code d'erreur Daxium.","type":"string"},"message":{"type":"string"},"url":{"description":"Lien vers le code d'erreur dans la référence des erreurs.","type":"string"},"api_version":{"type":"string"},"infos":{"description":"Contexte additionnel sur l'erreur, lorsque l'exception en porte.","type":"array","items":{}},"server_time":{"type":"integer"}},"type":"object"}},"responses":{"Unauthorized":{"description":"Access token manquant ou invalide.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/{app_short}/tasks":{"get":{"tags":["tasks"],"summary":"Rechercher des tâches","description":"Retourne les tâches du vertical métier, filtrées par les paramètres de requête ci-dessous.","operationId":"listTasks","parameters":[{"name":"structure_id","in":"query","description":"identifiant du formulaire.","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"\\d+"}},{"name":"greater_start_date","in":"query","description":"toutes les tâches après la date de début.","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"\\d+"}},{"name":"lower_start_date","in":"query","description":"toutes les tâches avant la date de début.","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"\\d+"}},{"name":"greater_due_date","in":"query","description":"toutes les tâches dont l'échéance est après cette date.","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"\\d+"}},{"name":"lower_due_date","in":"query","description":"toutes les tâches dont l'échéance est avant cette date","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"\\d+"}},{"name":"user_id","in":"query","description":"toutes les tâches d'un utilisateur","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null,"pattern":"\\d+"}},{"name":"me","in":"query","description":"récupérer les tâches de l'utilisateur courant","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null}},{"name":"periodic","in":"query","description":"récupérer les tâches périodiques ou non","required":false,"allowEmptyValue":true,"schema":{"type":"string","default":null}},{"name":"page","in":"query","description":"Page de la vue d'ensemble.","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"0","pattern":"\\d+"}},{"name":"per_page","in":"query","description":"Nombre de résultats par page (max. 100)","required":false,"allowEmptyValue":false,"schema":{"type":"string","default":"10","pattern":"-?\\d+"}},{"name":"app_short","in":"path","description":"Nom court du vertical métier, tel qu'il apparaît dans l'URL du back-office.","required":true,"schema":{"type":"string"}},{"$ref":"#/components/parameters/XAcceptVersion"}],"responses":{"200":{"description":"Liste paginée de tâches","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskListResponse"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://www.center.daxium-air.com/api-reference/doc-api/taches.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.