# Tâches

## Lister les tâches

> Retourne les tâches filtrées par utilisateur, formulaire et/ou plage de dates.\
> Tous les paramètres de date sont des timestamps UNIX.\
> Utilisez \`me\` pour retourner uniquement les tâches de l'utilisateur authentifié.<br>

```json
{"openapi":"3.0.3","info":{"title":"Daxium Air API","version":"v1.3"},"tags":[{"name":"tasks"}],"servers":[{"url":"https://api.daxium-air.com","description":"Production"}],"security":[{"BearerAuth":[]}],"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer"}},"parameters":{"AppShort":{"name":"app_short","in":"path","required":true,"description":"Nom court de l'instance (ex. `daxium-test`)","schema":{"type":"string"}}},"schemas":{"TaskListResponse":{"type":"object","properties":{"tasks":{"type":"array","items":{"$ref":"#/components/schemas/Task"},"description":"Liste des tâches"},"total_count":{"type":"integer","description":"Nombre total de tâches"},"total_pages":{"type":"integer","description":"Nombre total de pages"},"server_time":{"type":"integer","format":"int64","description":"Date courante du serveur (timestamp UNIX)"}}},"Task":{"type":"object","description":"Tâche liée à une fiche","properties":{"id":{"type":"string","format":"uuid","description":"Identifiant de la tâche"},"created_at":{"type":"integer","format":"int64","description":"Date de création (timestamp UNIX)"},"updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour (timestamp UNIX)"},"start_date":{"type":"integer","format":"int64","description":"Date de début prévue (timestamp UNIX)"},"due_date":{"type":"integer","format":"int64","description":"Date d'échéance (timestamp UNIX)"},"duration":{"type":"integer","description":"Durée prévue en secondes"},"delay_before":{"type":"integer","description":"Délai d'affichage indicatif en secondes avant le début de la tâche"},"delay_after":{"type":"integer","description":"Délai d'affichage indicatif en secondes après la fin de la tâche"},"user_id":{"type":"integer","description":"Identifiant de l'utilisateur assigné"},"submission":{"$ref":"#/components/schemas/Submission","description":"Fiche associée à la tâche"}}},"Submission":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"Identifiant de la fiche"},"structure_id":{"type":"integer","description":"Identifiant du formulaire"},"structure_version":{"type":"integer","description":"Version du formulaire"},"created_at":{"type":"integer","format":"int64","description":"Date de création (timestamp UNIX)"},"updated_at":{"type":"integer","format":"int64","description":"Date de mise à jour (timestamp UNIX)"},"data_created_at":{"type":"integer","format":"int64","description":"Date de création des données sur le serveur"},"data_updated_at":{"type":"integer","format":"int64","description":"Date de dernière mise à jour des données sur le serveur"},"user_id":{"type":"integer","description":"Propriétaire de la fiche"},"channels":{"type":"array","items":{"type":"string"},"description":"Conditions remplies par la fiche"},"items":{"type":"object","additionalProperties":true,"description":"Dictionnaire clé/valeur dont la clé est le nom système du champ.\n\n**Types simples :** texte/email → chaîne | nombre → flottant | booléen → bool |\ndate → timestamp UNIX | durée → ms | téléphone → RFC 3966\n\n**location :** `{lat, lng, address}`\n\n**image/signature/fichier :** `[{id, name, mimeType, extension, size, comment}]`\n\n**liste :** `[id, …]`\n\n**relation :** `{submissions: [{id, count?}, …]}`\n\n**utilisateur :** `[{id}, …]`\n"},"submission_number":{"type":"integer","description":"Numéro séquentiel global"},"number_in_structure":{"type":"integer","description":"Numéro séquentiel au sein du formulaire"},"latitude":{"type":"number","format":"double","description":"Latitude de la fiche"},"longitude":{"type":"number","format":"double","description":"Longitude de la fiche"},"last_updated_user_id":{"type":"integer","description":"Identifiant du dernier utilisateur ayant modifié la fiche"},"current_state":{"type":"string","format":"uuid","nullable":true,"description":"UUID de l'état de workflow courant (null si pas de workflow)"},"assigned_user":{"$ref":"#/components/schemas/UserRef"},"subscribers":{"type":"array","items":{},"description":"Utilisateurs abonnés à la fiche"},"settings":{"type":"array","items":{}}}},"UserRef":{"type":"object","description":"Référence à un utilisateur","properties":{"id":{"type":"integer"},"email":{"type":"string","format":"email"},"first_name":{"type":"string","description":"Prénom"},"last_name":{"type":"string","description":"Nom"},"groups":{"type":"array","items":{},"description":"Groupes de l'utilisateur"},"system_groups":{"type":"array","items":{},"description":"Groupes système de l'utilisateur"}}}}},"paths":{"/{app_short}/tasks":{"get":{"summary":"Lister les tâches","description":"Retourne les tâches filtrées par utilisateur, formulaire et/ou plage de dates.\nTous les paramètres de date sont des timestamps UNIX.\nUtilisez `me` pour retourner uniquement les tâches de l'utilisateur authentifié.\n","tags":["tasks"],"operationId":"listTasks","parameters":[{"$ref":"#/components/parameters/AppShort"},{"name":"structure_id","in":"query","description":"Filtrer par identifiant de formulaire","schema":{"type":"string"}},{"name":"greater_start_date","in":"query","description":"Date de début supérieure ou égale à ce timestamp","schema":{"type":"integer","format":"int64"}},{"name":"lower_start_date","in":"query","description":"Date de début inférieure ou égale à ce timestamp","schema":{"type":"integer","format":"int64"}},{"name":"greater_due_date","in":"query","description":"Date d'échéance supérieure ou égale à ce timestamp","schema":{"type":"integer","format":"int64"}},{"name":"lower_due_date","in":"query","description":"Date d'échéance inférieure ou égale à ce timestamp","schema":{"type":"integer","format":"int64"}},{"name":"user_id","in":"query","description":"Filtrer par identifiant d'utilisateur","schema":{"type":"integer"}},{"name":"me","in":"query","description":"Si présent, retourner uniquement les tâches de l'utilisateur authentifié","schema":{"type":"boolean"}},{"name":"page","in":"query","description":"Numéro de la page demandée","schema":{"type":"integer"}},{"name":"per_page","in":"query","description":"Nombre de tâches par page","schema":{"type":"integer"}}],"responses":{"200":{"description":"Liste paginée de tâches","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TaskListResponse"}}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.