workers | Guides de data.gouv.fr ⌘Ctrlk ✉️ Contact💬 Forum Plus Documentation de data.gouv.fr Guides sur les données Documentation de l’Annuaire des Entreprises Documentation ecologie.data.gouv.fr Fabrique des strandards Passe marché Accueil ❓Foire aux questions COMPTE UTILISATEUR Créer un compte utilisateur Suivre vos contenus publiés ORGANISATIONS Rejoindre une organisation Créer une organisation Modifier son organisation Gérer les membres de son organisation Suivre l'activité de son organisation Obtenir une certification JEUX DE DONNÉES Publier un jeu de données Ressource communautaire Modifier un jeu de données API Publier une API Modifier une API RÉUTILISATIONS Publier une réutilisation Modifier une réutilisation API DE DATA.GOUV.FR Prise en main Référencesite datasets reuses discussions organizations spatial users me contacts workers tags topics posts transfer notifications avatars harvest dataservices Télécharger le catalogue de données de data.gouv.fr Accéder au catalogue via SPARQL MOISSONNAGE Comprendre le moissonnage Mettre en place un moissonneur INTELLIGENCE ARTIFICIELLE Notre approche de l’intelligence artificielle sur data.gouv.fr Le serveur MCP de data.gouv.fr Le skill data.gouv.fr Données spécifiques Publier une Base Adresse Locale Données de forte valeur : métadonnées obligatoires et modalités de rapportage Données de la commande publique Données de transports et mobilités Autres Créer une verticale thématique de data.gouv.fr Propulsé par GitBook Sur cette page For the complete documentation index, see llms.txt. This page is also available as Markdown. Copier Sur cette page Documentation de data.gouv.fr API DE DATA.GOUV.FR Référence workers Asynchronous workers related operations List all scheduled jobs gethttp://www.data.gouv.fr/api/1/workers/jobs/ Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Réponses 200Success application/json argsobject[]OptionnelThe job execution arguments Default: [] crontabobject · CrontabOptionnel Afficher propriétés descriptionstringOptionnelThe job description enabledbooleanOptionnelIs this job enabled Default: false idstringLecture seuleOptionnelThe job unique identifier intervalobject · IntervalOptionnel Afficher propriétés kwargsobjectOptionnelThe job execution keyword arguments Default: {} last_run_atstring · date-timeLecture seuleOptionnelThe last job execution date last_run_idstringLecture seuleOptionnelThe last execution task id namestringRequisThe job unique name schedulestringLecture seuleOptionnelThe schedule display taskstring · enumRequisThe task name Example: test-high-queueValeurs possibles: test-high-queuetest-default-queuerecommendations-cleantest-low-queuepurge-chunkscheck-integritypurge-harvestersrecommendations-addnotify-inactive-usersgenerate-sitemapspurge-harvest-jobsdelete-inactive-userscompute-site-metricscompute-geozones-metricsexport-csvpurge-organizationspurge-topics-elementspurge-visualizationsupdate-badgescount-tagsbind-tabular-dataserviceharvesttest-errorpurge-reusesdelete-expired-notificationspurge-datasetsupdate-metricsmap-transport-datasetstest-logpurge-dataservices get/workers/jobs/ HTTP Copier GET /api/1/workers/jobs/ HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Copier [ { "args": [ {} ], "crontab": { "day_of_month": "*", "day_of_week": "*", "hour": "*", "minute": "*", "month_of_year": "*" }, "description": "text", "enabled": false, "id": "text", "interval": { "every": 1, "period": "days" }, "kwargs": {}, "last_run_at": "2026-01-01T00:00:00.000Z", "last_run_id": "text", "name": "text", "schedule": "text", "task": "test-high-queue" } ] Create a new scheduled job posthttp://www.data.gouv.fr/api/1/workers/jobs/ Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Corps application/json argsobject[]OptionnelThe job execution arguments Default: [] crontabobject · CrontabOptionnel Afficher propriétés descriptionstringOptionnelThe job description enabledbooleanOptionnelIs this job enabled Default: false idstringLecture seuleOptionnelThe job unique identifier intervalobject · IntervalOptionnel Afficher propriétés kwargsobjectOptionnelThe job execution keyword arguments Default: {} last_run_atstring · date-timeLecture seuleOptionnelThe last job execution date last_run_idstringLecture seuleOptionnelThe last execution task id namestringRequisThe job unique name schedulestringLecture seuleOptionnelThe schedule display taskstring · enumRequisThe task name Example: test-high-queueValeurs possibles: test-high-queuetest-default-queuerecommendations-cleantest-low-queuepurge-chunkscheck-integritypurge-harvestersrecommendations-addnotify-inactive-usersgenerate-sitemapspurge-harvest-jobsdelete-inactive-userscompute-site-metricscompute-geozones-metricsexport-csvpurge-organizationspurge-topics-elementspurge-visualizationsupdate-badgescount-tagsbind-tabular-dataserviceharvesttest-errorpurge-reusesdelete-expired-notificationspurge-datasetsupdate-metricsmap-transport-datasetstest-logpurge-dataservices Réponses 200Success application/json argsobject[]OptionnelThe job execution arguments Default: [] crontabobject · CrontabOptionnel Afficher propriétés descriptionstringOptionnelThe job description enabledbooleanOptionnelIs this job enabled Default: false idstringLecture seuleOptionnelThe job unique identifier intervalobject · IntervalOptionnel Afficher propriétés kwargsobjectOptionnelThe job execution keyword arguments Default: {} last_run_atstring · date-timeLecture seuleOptionnelThe last job execution date last_run_idstringLecture seuleOptionnelThe last execution task id namestringRequisThe job unique name schedulestringLecture seuleOptionnelThe schedule display taskstring · enumRequisThe task name Example: test-high-queueValeurs possibles: test-high-queuetest-default-queuerecommendations-cleantest-low-queuepurge-chunkscheck-integritypurge-harvestersrecommendations-addnotify-inactive-usersgenerate-sitemapspurge-harvest-jobsdelete-inactive-userscompute-site-metricscompute-geozones-metricsexport-csvpurge-organizationspurge-topics-elementspurge-visualizationsupdate-badgescount-tagsbind-tabular-dataserviceharvesttest-errorpurge-reusesdelete-expired-notificationspurge-datasetsupdate-metricsmap-transport-datasetstest-logpurge-dataservices post/workers/jobs/ HTTP Copier POST /api/1/workers/jobs/ HTTP/1.1 Host: www.data.gouv.fr Content-Type: application/json Accept: */* Content-Length: 233 { "args": [ {} ], "crontab": { "day_of_month": "*", "day_of_week": "*", "hour": "*", "minute": "*", "month_of_year": "*" }, "description": "text", "enabled": false, "interval": { "every": 1, "period": "days" }, "kwargs": {}, "name": "text", "task": "test-high-queue" } Tester 200Success Copier { "args": [ {} ], "crontab": { "day_of_month": "*", "day_of_week": "*", "hour": "*", "minute": "*", "month_of_year": "*" }, "description": "text", "enabled": false, "id": "text", "interval": { "every": 1, "period": "days" }, "kwargs": {}, "last_run_at": "2026-01-01T00:00:00.000Z", "last_run_id": "text", "name": "text", "schedule": "text", "task": "test-high-queue" } List all schedulable jobs gethttp://www.data.gouv.fr/api/1/workers/jobs/schedulables Réponses 200Success application/json string[]Optionnel get/workers/jobs/schedulables HTTP Copier GET /api/1/workers/jobs/schedulables HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Copier [ "text" ] Fetch a single scheduled job gethttp://www.data.gouv.fr/api/1/workers/jobs/{id} Paramètres de chemin idstringRequisA job ID Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Réponses 200Success application/json argsobject[]OptionnelThe job execution arguments Default: [] crontabobject · CrontabOptionnel Afficher propriétés descriptionstringOptionnelThe job description enabledbooleanOptionnelIs this job enabled Default: false idstringLecture seuleOptionnelThe job unique identifier intervalobject · IntervalOptionnel Afficher propriétés kwargsobjectOptionnelThe job execution keyword arguments Default: {} last_run_atstring · date-timeLecture seuleOptionnelThe last job execution date last_run_idstringLecture seuleOptionnelThe last execution task id namestringRequisThe job unique name schedulestringLecture seuleOptionnelThe schedule display taskstring · enumRequisThe task name Example: test-high-queueValeurs possibles: test-high-queuetest-default-queuerecommendations-cleantest-low-queuepurge-chunkscheck-integritypurge-harvestersrecommendations-addnotify-inactive-usersgenerate-sitemapspurge-harvest-jobsdelete-inactive-userscompute-site-metricscompute-geozones-metricsexport-csvpurge-organizationspurge-topics-elementspurge-visualizationsupdate-badgescount-tagsbind-tabular-dataserviceharvesttest-errorpurge-reusesdelete-expired-notificationspurge-datasetsupdate-metricsmap-transport-datasetstest-logpurge-dataservices get/workers/jobs/{id} HTTP Copier GET /api/1/workers/jobs/{id} HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Copier { "args": [ {} ], "crontab": { "day_of_month": "*", "day_of_week": "*", "hour": "*", "minute": "*", "month_of_year": "*" }, "description": "text", "enabled": false, "id": "text", "interval": { "every": 1, "period": "days" }, "kwargs": {}, "last_run_at": "2026-01-01T00:00:00.000Z", "last_run_id": "text", "name": "text", "schedule": "text", "task": "test-high-queue" } Update a single scheduled job puthttp://www.data.gouv.fr/api/1/workers/jobs/{id} Paramètres de chemin idstringRequisA job ID Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Réponses 200Success application/json argsobject[]OptionnelThe job execution arguments Default: [] crontabobject · CrontabOptionnel Afficher propriétés descriptionstringOptionnelThe job description enabledbooleanOptionnelIs this job enabled Default: false idstringLecture seuleOptionnelThe job unique identifier intervalobject · IntervalOptionnel Afficher propriétés kwargsobjectOptionnelThe job execution keyword arguments Default: {} last_run_atstring · date-timeLecture seuleOptionnelThe last job execution date last_run_idstringLecture seuleOptionnelThe last execution task id namestringRequisThe job unique name schedulestringLecture seuleOptionnelThe schedule display taskstring · enumRequisThe task name Example: test-high-queueValeurs possibles: test-high-queuetest-default-queuerecommendations-cleantest-low-queuepurge-chunkscheck-integritypurge-harvestersrecommendations-addnotify-inactive-usersgenerate-sitemapspurge-harvest-jobsdelete-inactive-userscompute-site-metricscompute-geozones-metricsexport-csvpurge-organizationspurge-topics-elementspurge-visualizationsupdate-badgescount-tagsbind-tabular-dataserviceharvesttest-errorpurge-reusesdelete-expired-notificationspurge-datasetsupdate-metricsmap-transport-datasetstest-logpurge-dataservices put/workers/jobs/{id} HTTP Copier PUT /api/1/workers/jobs/{id} HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Copier { "args": [ {} ], "crontab": { "day_of_month": "*", "day_of_week": "*", "hour": "*", "minute": "*", "month_of_year": "*" }, "description": "text", "enabled": false, "id": "text", "interval": { "every": 1, "period": "days" }, "kwargs": {}, "last_run_at": "2026-01-01T00:00:00.000Z", "last_run_id": "text", "name": "text", "schedule": "text", "task": "test-high-queue" } Delete a single scheduled job deletehttp://www.data.gouv.fr/api/1/workers/jobs/{id} Paramètres de chemin idstringRequisA job ID Réponses 204Successfuly deleted Aucun contenu delete/workers/jobs/{id} HTTP Copier DELETE /api/1/workers/jobs/{id} HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 204Successfuly deleted Aucun contenu Get a tasks status given its ID gethttp://www.data.gouv.fr/api/1/workers/tasks/{id} Paramètres de chemin idstringRequis Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Réponses 200Success application/json excstringOptionnelThe except…