users

User related operations

List all users

get

Paramètres de requête

qstringOptionnel

The search query

sortstring · enumOptionnel

The field (and direction) on which sorting apply

Valeurs possibles:

pageintegerOptionnel

The page to fetch

page_sizeintegerOptionnel

The page size to fetch

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

next_pagestringOptionnel

The next page URL if exists

pageinteger · min: 1Requis

The current page

page_sizeintegerRequis

The page size used for pagination

previous_pagestringOptionnel

The previous page URL if exists

totalintegerRequis

The total paginated items

get/users/

HTTPcURLJavaScriptPython

GET /api/1/users/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

{
  "data": [
    {
      "about": "text",
      "active": true,
      "avatar": "text",
      "avatar_thumbnail": "text",
      "email": {},
      "first_name": "text",
      "id": "text",
      "last_login_at": {},
      "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": {},
      "password_rotation_performed": {},
      "roles": [
        "text"
      ],
      "since": "2026-07-14T21:39:32.131Z",
      "slug": "text",
      "uri": "text",
      "website": "text"
    }
  ],
  "next_page": "text",
  "page": 1,
  "page_size": 1,
  "previous_page": "text",
  "total": 1
}

Create a new object

post

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

aboutstring · markdownOptionnel

The user self description

activebooleanOptionnel

avatarstringOptionnel

The user avatar URL

avatar_thumbnailstringOptionnel

The user avatar thumbnail URL. This is the square (500x500) and cropped version.

emailobjectLecture seuleOptionnel

The user email

first_namestringRequis

The user first name

idstringLecture seuleOptionnel

The user identifier

last_login_atobjectLecture seuleOptionnel

The user's most recent login date (present for global admins, on /me, and for organization members in their org context)

last_namestringRequis

The user last name

metricsobjectLecture seuleOptionnel

The user metrics

pagestringLecture seuleOptionnel

The user web page URL

password_rotation_demandedobjectLecture seuleOptionnel

Date at which a password rotation was requested for this user (only present for global admins and on /me)

password_rotation_performedobjectLecture seuleOptionnel

Date at which the user performed the requested password rotation (only present for global admins and on /me)

rolesstring[]Optionnel

Site wide user roles

sincestring · date-timeRequis

The registeration date

slugstringLecture seuleOptionnel

The user permalink string

uristringLecture seuleOptionnel

The API URI for this user

websitestringOptionnel

The user website

Réponses

201

Success

application/json

aboutstring · markdownOptionnel

The user self description

activebooleanOptionnel

avatarstringOptionnel

The user avatar URL

avatar_thumbnailstringOptionnel

The user avatar thumbnail URL. This is the square (500x500) and cropped version.

emailobjectLecture seuleOptionnel

The user email

first_namestringRequis

The user first name

idstringLecture seuleOptionnel

The user identifier

last_login_atobjectLecture seuleOptionnel

The user's most recent login date (present for global admins, on /me, and for organization members in their org context)

last_namestringRequis

The user last name

metricsobjectLecture seuleOptionnel

The user metrics

pagestringLecture seuleOptionnel

The user web page URL

password_rotation_demandedobjectLecture seuleOptionnel

Date at which a password rotation was requested for this user (only present for global admins and on /me)

password_rotation_performedobjectLecture seuleOptionnel

Date at which the user performed the requested password rotation (only present for global admins and on /me)

rolesstring[]Optionnel

Site wide user roles

sincestring · date-timeRequis

The registeration date

slugstringLecture seuleOptionnel

The user permalink string

uristringLecture seuleOptionnel

The API URI for this user

websitestringOptionnel

The user website

400

Validation error

post/users/

HTTPcURLJavaScriptPython

POST /api/1/users/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 258

{
  "about": "text",
  "active": true,
  "avatar": "text",
  "avatar_thumbnail": "text",
  "first_name": "text",
  "last_name": "text",
  "organizations": [
    {
      "class": "text",
      "id": "text",
      "acronym": "text",
      "name": "text"
    }
  ],
  "roles": [
    "text"
  ],
  "since": "2026-07-14T21:39:32.131Z",
  "website": "text"
}

{
  "about": "text",
  "active": true,
  "avatar": "text",
  "avatar_thumbnail": "text",
  "email": {},
  "first_name": "text",
  "id": "text",
  "last_login_at": {},
  "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": {},
  "password_rotation_performed": {},
  "roles": [
    "text"
  ],
  "since": "2026-07-14T21:39:32.131Z",
  "slug": "text",
  "uri": "text",
  "website": "text"
}

List all possible user roles

get

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

namestringLecture seuleOptionnel

The role name

get/users/roles/

HTTPcURLJavaScriptPython

GET /api/1/users/roles/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

[
  {
    "name": "text"
  }
]

Suggest users

get

Paramètres de requête

qstringRequis

The string to autocomplete/suggest

sizestringOptionnel

The amount of suggestion to fetch (between 1 and 20)

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

avatar_urlstringLecture seuleOptionnel

The user avatar URL

emailobjectLecture seuleOptionnel

The user email (only the domain for non-admin user)

first_namestringLecture seuleOptionnel

The user first name

idstringLecture seuleOptionnel

The user identifier

last_namestringLecture seuleOptionnel

The user last name

slugstringLecture seuleOptionnel

The user permalink string

get/users/suggest/

HTTPcURLJavaScriptPython

GET /api/1/users/suggest/?q=text HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

[
  {
    "avatar_url": "text",
    "email": {},
    "first_name": "text",
    "id": "text",
    "last_name": "text",
    "slug": "text"
  }
]

List all followers for a given object

get

Paramètres de chemin

idstringRequis

Paramètres de requête

pageintegerOptionnel

The page to fetch

page_sizeintegerOptionnel

The page size to fetch

userstringOptionnel

Filter follower by user, it allows to check if a user is following the object

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

next_pagestringOptionnel

The next page URL if exists

pageinteger · min: 1Requis

The current page

page_sizeintegerRequis

The page size used for pagination

previous_pagestringOptionnel

The previous page URL if exists

totalintegerRequis

The total paginated items

get/users/{id}/followers/

HTTPcURLJavaScriptPython

GET /api/1/users/{id}/followers/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

{
  "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-07-14T21:39:32.131Z"
    }
  ],
  "next_page": "text",
  "page": 1,
  "page_size": 1,
  "previous_page": "text",
  "total": 1
}

Follow a user given its ID

post

Paramètres de chemin

idstringRequis

Réponses

403

When trying to follow yourself

Aucun contenu

post/users/{id}/followers/

HTTPcURLJavaScriptPython

POST /api/1/users/{id}/followers/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

403

When trying to follow yourself

Aucun contenu

Unfollow an object given its ID

delete

Returns the number of followers left after the operation

Paramètres de chemin

idstringRequis

Réponses

200

Success

Aucun contenu

delete/users/{id}/followers/

HTTPcURLJavaScriptPython

DELETE /api/1/users/{id}/followers/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

Aucun contenu

Get a user given its identifier

get

Paramètres de chemin

userstringRequis

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

aboutstring · markdownOptionnel

The user self description

activebooleanOptionnel

avatarstringOptionnel

The user avatar URL

avatar_thumbnailstringOptionnel

The user avatar thumbnail URL. This is the square (500x500) and cropped version.

emailobjectLecture seuleOptionnel

The user email

first_namestringRequis

The user first name

idstringLecture seuleOptionnel

The user identifier

last_login_atobjectLecture seuleOptionnel

The user's most recent login date (present for global admins, on /me, and for organization members in their org context)

last_namestringRequis

The user last name

metricsobjectLecture seuleOptionnel

The user metrics

pagestringLecture seuleOptionnel

The user web page URL

password_rotation_demandedobjectLecture seuleOptionnel

Date at which a password rotation was requested for this user (only present for global admins and on /me)

password_rotation_performedobjectLecture seuleOptionnel

Date at which the user performed the requested password rotation (only present for global admins and on /me)

rolesstring[]Optionnel

Site wide user roles

sincestring · date-timeRequis

The registeration date

slugstringLecture seuleOptionnel

The user permalink string

uristringLecture seuleOptionnel

The API URI for this user

websitestringOptionnel

The user website

404

User not found

410

User is not active or has been deleted

get/users/{user}/

HTTPcURLJavaScriptPython

GET /api/1/users/{user}/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

{
  "about": "text",
  "active": true,
  "avatar": "text",
  "avatar_thumbnail": "text",
  "email": {},
  "first_name": "text",
  "id": "text",
  "last_login_at": {},
  "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": {},
  "password_rotation_performed": {},
  "roles": [
    "text"
  ],
  "since": "2026-07-14T21:39:32.131Z",
  "slug": "text",
  "uri": "text",
  "website": "text"
}

Update a user given its identifier

put

Paramètres de chemin

userstringRequis

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

aboutstring · markdownOptionnel

The user self description

activebooleanOptionnel

avatarstringOptionnel

The user avatar URL

avatar_thumbnailstringOptionnel

The user avatar thumbnail URL. This is the square (500x500) and cropped version.

emailobjectLecture seuleOptionnel

The user email

first_namestringRequis

The user first name

idstringLecture seuleOptionnel

The user identifier

last_login_atobjectLecture seuleOptionnel

The user's most recent login date (present for global admins, on /me, and for organization members in their org context)

last_namestringRequis

The user last name

metricsobjectLecture seuleOptionnel

The user metrics

pagestringLecture seuleOptionnel

The user web page URL

password_rotation_demandedobjectLecture seuleOptionnel

Date at which a password rotation was requested for this user (only present for global admins and on /me)

password_rotation_performedobjectLecture seuleOptionnel

Date at which the user performed the requested password rotation (only present for global admins and on /me)

rolesstring[]Optionnel

Site wide user roles

sincestring · date-timeRequis

The registeration date

slugstringLecture seuleOptionnel

The user permalink string

uristringLecture seuleOptionnel

The API URI for this user

websitestringOptionnel

The user website

Réponses

200

Success

application/json

aboutstring · markdownOptionnel

The user self description

activebooleanOptionnel

avatarstringOptionnel

The user avatar URL

avatar_thumbnailstringOptionnel

The user avatar thumbnail URL. This is the square (500x500) and cropped version.

emailobjectLecture seuleOptionnel

The user email

first_namestringRequis

The user first name

idstringLecture seuleOptionnel

The user identifier

last_login_atobjectLecture seuleOptionnel

The user's most recent login date (present for global admins, on /me, and for organization members in their org context)

last_namestringRequis

The user last name

metricsobjectLecture seuleOptionnel

The user metrics

pagestringLecture seuleOptionnel

The user web page URL

password_rotation_demandedobjectLecture seuleOptionnel

Date at which a password rotation was requested for this user (only present for global admins and on /me)

password_rotation_performedobjectLecture seuleOptionnel

Date at which the user performed the requested password rotation (only present for global admins and on /me)

rolesstring[]Optionnel

Site wide user roles

sincestring · date-timeRequis

The registeration date

slugstringLecture seuleOptionnel

The user permalink string

uristringLecture seuleOptionnel

The API URI for this user

websitestringOptionnel

The user website

400

Validation error

404

User not found

410

User is not active or has been deleted

put/users/{user}/

HTTPcURLJavaScriptPython

PUT /api/1/users/{user}/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 258

{
  "about": "text",
  "active": true,
  "avatar": "text",
  "avatar_thumbnail": "text",
  "first_name": "text",
  "last_name": "text",
  "organizations": [
    {
      "class": "text",
      "id": "text",
      "acronym": "text",
      "name": "text"
    }
  ],
  "roles": [
    "text"
  ],
  "since": "2026-07-14T21:39:32.131Z",
  "website": "text"
}

{
  "about": "text",
  "active": true,
  "avatar": "text",
  "avatar_thumbnail": "text",
  "email": {},
  "first_name": "text",
  "id": "text",
  "last_login_at": {},
  "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": {},
  "password_rotation_performed": {},
  "roles": [
    "text"
  ],
  "since": "2026-07-14T21:39:32.131Z",
  "slug": "text",
  "uri": "text",
  "website": "text"
}

Delete a user given its identifier

delete

Paramètres de chemin

userstringRequis

Paramètres de requête

send_legal_noticebooleanOptionnel

Send formal legal notice with appeal information to owner (admin only)

no_mailbooleanOptionnel

Do not send the simple deletion notification email. Note: automatically set to True when send_legal_notice=True to avoid sending duplicate emails.

delete_commentsbooleanOptionnel

Delete comments posted by the user upon user deletion

Réponses

204

Object deleted

Aucun contenu

403

When trying to delete yourself

404

User not found

410

User is not active or has been deleted

delete/users/{user}/

HTTPcURLJavaScriptPython

DELETE /api/1/users/{user}/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

Aucun contenu

Upload a new avatar for a given user

post

Paramètres de chemin

userstringRequis

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

multipart/form-data

filestringOptionnel

bboxstringOptionnel

Réponses

200

Success

application/json

imagestringOptionnel

successbooleanLecture seuleOptionnel

Whether the upload succeeded or not.

Default: true

post/users/{user}/avatar

HTTPcURLJavaScriptPython

POST /api/1/users/{user}/avatar HTTP/1.1
Host: www.data.gouv.fr
Content-Type: multipart/form-data
Accept: */*
Content-Length: 29

{
  "file": "text",
  "bbox": "text"
}

200

Success

{
  "image": "text",
  "success": true
}