users | 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 users User related operations List all users gethttp://www.data.gouv.fr/api/1/users/ Paramètres de requête qstringOptionnelThe search query sortstring · enumOptionnelThe field (and direction) on which sorting apply Valeurs possibles: last_namefirst_namedatasetsreusesfollowersviewscreated-last_name-first_name-datasets-reuses-followers-views-created pageintegerOptionnelThe page to fetch page_sizeintegerOptionnelThe page size to fetch Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Réponses 200Success application/json dataobject · User (read)[]OptionnelThe page data Afficher propriétés next_pagestringOptionnelThe next page URL if exists pageinteger · min: 1RequisThe current page page_sizeintegerRequisThe page size used for pagination previous_pagestringOptionnelThe previous page URL if exists totalintegerRequisThe total paginated items get/users/ HTTP Copier GET /api/1/users/ HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Copier { "data": [ { "about": "text", "active": true, "avatar": "text", "avatar_thumbnail": "text", "email": "text", "first_name": "text", "id": "text", "last_login_at": "2026-01-01T00:00:00.000Z", "last_name": "text", "metrics": {}, "organizations": [ { "class": "text", "id": "text", "acronym": "text", "badges": [ { "kind": "text" } ], "logo": "text", "logo_thumbnail": "text", "name": "text", "page": "text", "permissions": { "delete": true, "edit": true, "harvest": true, "members": true, "private": true }, "slug": "text", "uri": "text" } ], "page": "text", "password_rotation_demanded": "2026-01-01T00:00:00.000Z", "password_rotation_performed": "2026-01-01T00:00:00.000Z", "roles": [ "text" ], "since": "2026-01-01T00:00:00.000Z", "slug": "text", "uri": "text", "website": "text" } ], "next_page": "text", "page": 1, "page_size": 1, "previous_page": "text", "total": 1 } Create a new user posthttp://www.data.gouv.fr/api/1/users/ Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Corps application/json aboutstring · markdownOptionnel emailstring · max: 255Requis first_namestring · max: 255Requis last_namestring · max: 255Requis websitestringOptionnel Réponses 201Success application/json aboutstring · markdownOptionnel activebooleanLecture seuleOptionnel avatarstringLecture seuleOptionnelURL of the image avatar_thumbnailstringLecture seuleOptionnelURL of the cropped and squared image (500x500) emailstring · max: 255Requis first_namestring · max: 255Requis idstringLecture seuleRequis last_login_atstring · date-timeLecture seuleOptionnel last_namestring · max: 255Requis metricsobjectLecture seuleOptionnel organizationsobject · BaseReferenceOptionnel Afficher propriétés pagestringLecture seuleOptionnelLink to the udata web page for this user password_rotation_demandedstring · date-timeLecture seuleOptionnel password_rotation_performedstring · date-timeLecture seuleOptionnel rolesstring[]Lecture seuleOptionnel sincestring · date-timeLecture seuleRequis slugstring · max: 255Lecture seuleRequis uristringLecture seuleOptionnelLink to the API endpoint for this user websitestringOptionnel 400Validation error post/users/ HTTP Copier POST /api/1/users/ HTTP/1.1 Host: www.data.gouv.fr Content-Type: application/json Accept: */* Content-Length: 87 { "about": "text", "email": "text", "first_name": "text", "last_name": "text", "website": "text" } Tester 201Success Copier { "about": "text", "active": true, "avatar": "text", "avatar_thumbnail": "text", "email": "text", "first_name": "text", "id": "text", "last_login_at": "2026-01-01T00:00:00.000Z", "last_name": "text", "metrics": {}, "organizations": [ { "class": "text", "id": "text", "acronym": "text", "badges": [ { "kind": "text" } ], "logo": "text", "logo_thumbnail": "text", "name": "text", "page": "text", "permissions": { "delete": true, "edit": true, "harvest": true, "members": true, "private": true }, "slug": "text", "uri": "text" } ], "page": "text", "password_rotation_demanded": "2026-01-01T00:00:00.000Z", "password_rotation_performed": "2026-01-01T00:00:00.000Z", "roles": [ "text" ], "since": "2026-01-01T00:00:00.000Z", "slug": "text", "uri": "text", "website": "text" } List all possible user roles gethttp://www.data.gouv.fr/api/1/users/roles/ Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Réponses 200Success application/json namestringLecture seuleOptionnelThe role name get/users/roles/ HTTP Copier GET /api/1/users/roles/ HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Copier [ { "name": "text" } ] Suggest users gethttp://www.data.gouv.fr/api/1/users/suggest/ Paramètres de requête qstringRequisThe string to autocomplete/suggest sizestringOptionnelThe amount of suggestion to fetch (between 1 and 20) Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Réponses 200Success application/json avatar_urlstringLecture seuleOptionnelThe user avatar URL emailobjectLecture seuleOptionnelThe user email (only the domain for non-admin user) first_namestringLecture seuleOptionnelThe user first name idstringLecture seuleOptionnelThe user identifier last_namestringLecture seuleOptionnelThe user last name slugstringLecture seuleOptionnelThe user permalink string get/users/suggest/ HTTP Copier GET /api/1/users/suggest/?q=text HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Copier [ { "avatar_url": "text", "email": {}, "first_name": "text", "id": "text", "last_name": "text", "slug": "text" } ] List all followers for a given object gethttp://www.data.gouv.fr/api/1/users/{id}/followers/ Paramètres de chemin idstringRequis Paramètres de requête pageintegerOptionnelThe page to fetch page_sizeintegerOptionnelThe page size to fetch userstringOptionnelFilter follower by user, it allows to check if a user is following the object Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Réponses 200Success application/json dataobject · Follow[]OptionnelThe page data Afficher propriétés next_pagestringOptionnelThe next page URL if exists pageinteger · min: 1RequisThe current page page_sizeintegerRequisThe page size used for pagination previous_pagestringOptionnelThe previous page URL if exists totalintegerRequisThe total paginated items get/users/{id}/followers/ HTTP Copier GET /api/1/users/{id}/followers/ HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Copier { "data": [ { "follower": { "class": "text", "id": "text", "avatar": "text", "avatar_thumbnail": "text", "first_name": "text", "last_name": "text", "page": "text", "slug": "text", "uri": "text" }, "id": "text", "since": "2026-01-01T00:00:00.000Z" } ], "next_page": "text", "page": 1, "page_size": 1, "previous_page": "text", "total": 1 } Follow a user given its ID posthttp://www.data.gouv.fr/api/1/users/{id}/followers/ Paramètres de chemin idstringRequis Réponses 403When trying to follow yourself Aucun contenu post/users/{id}/followers/ HTTP Copier POST /api/1/users/{id}/followers/ HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 403When trying to follow yourself Aucun contenu Unfollow an object given its ID deletehttp://www.data.gouv.fr/api/1/users/{id}/followers/ Returns the number of followers left after the operation Paramètres de chemin idstringRequis Réponses 200Success Aucun contenu delete/users/{id}/followers/ HTTP Copier DELETE /api/1/users/{id}/followers/ HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Aucun contenu Get a user given its identifier gethttp://www.data.gouv.fr/api/1/users/{user}/ Paramètres de chemin userstringRequis Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Réponses 200Success application/json aboutstring · markdownOptionnel activebooleanLecture seuleOptionnel avatarstringLecture seuleOptionnelURL of the image avatar_thumbnailstringLecture seuleOptionnelURL of the cropped and squared image (500x500) emailstring · max: 255Requis first_namestring · max: 255Requis idstringLecture seuleRequis last_login_atstring · date-timeLecture seuleOptionnel last_namestring · max: 255Requis metricsobjectLecture seuleOptionnel organizationsobject · BaseReferenceOptionnel Afficher propriétés pagestringLecture seuleOptionnelLink to the udata web page for this user password_rotation_demandedstring · date-timeLecture seuleOptionnel password_rotation_performedstring · date-timeLecture seuleOptionnel rolesstring[]Lecture seuleOptionnel sincestring · date-timeLecture seuleRequis slugstring · max: 255Lecture seuleRequis uristringLecture seuleOptionnelLink to the API endpoint for this user websitestringOptionnel 404User not found 410User is not active or has been deleted get/users/{user}/ HTTP Copier GET /api/1/users/{user}/ HTTP/1.1 Host: www.data.gouv.fr Accept: */* Tester 200Success Copier { "about": "text", "active": true, "avatar": "text", "avatar_thumbnail": "text", "email": "text", "first_name": "text", "id": "text", "last_login_at": "2026-01-01T00:00:00.000Z", "last_name": "text", "metrics": {}, "organizations": [ { "class": "text", "id": "text", "acronym": "text", "badges": [ { "kind": "text" } ], "logo": "text", "logo_thumbnail": "text", "name": "text", "page": "text", "permissions": { "delete": true, "edit": true, "harvest": true, "members": true, "private": true }, "slug": "text", "uri": "text" } ], "page": "text", "password_rotation_demanded": "2026-01-01T00:00:00.000Z", "password_rotation_performed": "2026-01-01T00:00:00.000Z", "roles": [ "text" ], "since": "2026-01-01T00:00:00.000Z", "slug": "text", "uri": "text", "website": "text" } Update a user given its identifier puthttp://www.data.gouv.fr/api/1/users/{user}/ Paramètres de chemin userstringRequis Paramètres d'en-tête X-Fieldsstring · maskOptionnelAn optional fields mask Corps application/json aboutstring · markdownOptionnel emailstring · max: 255Requis first_namestring · max: 255Requis last_namestring · max: 255Requis websitestringOptionnel Réponses 200Success application/json aboutstring · markdownOptionnel activebooleanLecture seuleOptionnel avatarstringLecture seuleOptionnelURL of the image avatar_thumbnailstringLecture seuleOptionnelURL of the cropped and squared image (500x500) emailstring · max: 255Requis first_namestring · max:…