reuses

Reuse related operations

get

Paramètres de requête

pageintegerOptionnel

The page to display

page_sizeintegerOptionnel

The page size

sortstring · enumOptionnel

The field (and direction) on which sorting apply

Valeurs possibles:

qstringOptionnel

ownerstringOptionnel

organizationstringOptionnel

organization_badgestring · my-custom-formatOptionnel

typestring · enumOptionnelValeurs possibles:

datasetstringOptionnel

dataservicestringOptionnel

tagstringOptionnel

topicstring · enumOptionnelValeurs possibles:

privatebooleanOptionnel

featuredbooleanOptionnel

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

/reuses/

HTTPcURLJavaScriptPython

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

200

Success

{
  "data": [
    {
      "archived": "2026-03-11T09:48:07.897Z",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "created_at": "2026-03-11T09:48:07.897Z",
      "dataservices": [
        {
          "class": "text",
          "id": "text",
          "self_api_url": "text",
          "self_web_url": "text",
          "title": "My awesome API"
        }
      ],
      "datasets": [
        {
          "access_audiences": [
            {
              "condition": "yes",
              "role": "local_authority_and_administration"
            }
          ],
          "access_type": "text",
          "access_type_reason": "text",
          "access_type_reason_category": "text",
          "acronym": "text",
          "archived": "2026-03-11T09:48:07.897Z",
          "authorization_request_url": "text",
          "badges": [
            {
              "kind": "text"
            }
          ],
          "community_resources": [
            {
              "checksum": {
                "type": "sha1",
                "value": "text"
              },
              "created_at": "2026-03-11T09:48:07.897Z",
              "description": "text",
              "extras": {},
              "filesize": 1,
              "filetype": "file",
              "format": "text",
              "harvest": {
                "issued_at": "2026-03-11T09:48:07.897Z",
                "modified_at": "2026-03-11T09:48:07.897Z",
                "uri": "text"
              },
              "id": "text",
              "internal": {
                "created_at_internal": "2026-03-11T09:48:07.897Z",
                "last_modified_internal": "2026-03-11T09:48:07.897Z"
              },
              "last_modified": "2026-03-11T09:48:07.897Z",
              "latest": "text",
              "metrics": {},
              "mime": "text",
              "preview_url": "text",
              "schema": {
                "name": "text",
                "url": "text",
                "version": "text"
              },
              "title": "text",
              "type": "main",
              "url": "text",
              "dataset": {
                "class": "text",
                "id": "text"
              },
              "organization": {
                "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"
              },
              "owner": {
                "class": "text",
                "id": "text",
                "avatar": "text",
                "avatar_thumbnail": "text",
                "first_name": "text",
                "last_name": "text",
                "page": "text",
                "slug": "text",
                "uri": "text"
              },
              "permissions": {
                "delete": true,
                "edit": true,
                "edit_resources": true
              }
            }
          ],
          "contact_points": [
            {
              "contact_form": "text",
              "email": "text",
              "id": "text",
              "name": "text",
              "organization": {
                "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"
              },
              "owner": {
                "class": "text",
                "id": "text",
                "avatar": "text",
                "avatar_thumbnail": "text",
                "first_name": "text",
                "last_name": "text",
                "page": "text",
                "slug": "text",
                "uri": "text"
              },
              "role": "text"
            }
          ],
          "created_at": "2026-03-11T09:48:07.897Z",
          "deleted": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "description_short": "text",
          "extras": {},
          "featured": true,
          "frequency": "continuous",
          "frequency_date": "2026-03-11T09:48:07.897Z",
          "harvest": {
            "archived": "text",
            "archived_at": "2026-03-11T09:48:07.897Z",
            "backend": "text",
            "created_at": "2026-03-11T09:48:07.897Z",
            "dct_identifier": "text",
            "domain": "text",
            "issued_at": "2026-03-11T09:48:07.897Z",
            "last_update": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "remote_id": "text",
            "remote_url": "text",
            "source_id": "text",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "last_update": "2026-03-11T09:48:07.897Z",
          "license": "notspecified",
          "metrics": {},
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "page": "text",
          "permissions": {
            "delete": true,
            "edit": true,
            "edit_resources": true
          },
          "private": true,
          "quality": {},
          "resources": [
            {
              "checksum": {
                "type": "sha1",
                "value": "text"
              },
              "created_at": "2026-03-11T09:48:07.897Z",
              "description": "text",
              "extras": {},
              "filesize": 1,
              "filetype": "file",
              "format": "text",
              "harvest": {
                "issued_at": "2026-03-11T09:48:07.897Z",
                "modified_at": "2026-03-11T09:48:07.897Z",
                "uri": "text"
              },
              "id": "text",
              "internal": {
                "created_at_internal": "2026-03-11T09:48:07.897Z",
                "last_modified_internal": "2026-03-11T09:48:07.897Z"
              },
              "last_modified": "2026-03-11T09:48:07.897Z",
              "latest": "text",
              "metrics": {},
              "mime": "text",
              "preview_url": "text",
              "schema": {
                "name": "text",
                "url": "text",
                "version": "text"
              },
              "title": "text",
              "type": "main",
              "url": "text"
            }
          ],
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "slug": "text",
          "spatial": {
            "geom": {
              "coordinates": [
                {}
              ],
              "type": "Point"
            },
            "granularity": "other",
            "zones": {}
          },
          "tags": [
            "text"
          ],
          "temporal_coverage": {
            "end": "2026-03-11T09:48:07.897Z",
            "start": "2026-03-11T09:48:07.897Z"
          },
          "title": "text",
          "uri": "text"
        }
      ],
      "deleted": "2026-03-11T09:48:07.897Z",
      "description": "text",
      "extras": {},
      "featured": true,
      "id": "text",
      "image": "text",
      "image_thumbnail": "text",
      "last_modified": "2026-03-11T09:48:07.897Z",
      "metrics": {},
      "organization": {
        "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"
      },
      "owner": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true
      },
      "private": true,
      "slug": "text",
      "tags": [
        "text"
      ],
      "title": "text",
      "topic": "health",
      "type": "api",
      "uri": "text",
      "url": "text"
    }
  ],
  "next_page": "text",
  "page": 1,
  "page_size": 1,
  "previous_page": "text",
  "total": 1
}

post

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

archivedstring · date-timeOptionnel

dataservicesstring[]Optionnel

ID of the reference

datasetsstring[]Optionnel

ID of the reference

deletedstring · date-timeOptionnel

descriptionstring · markdownRequis

extrasobjectOptionnel

organizationstringOptionnel

Only present if owner is not set. Can only be set to an organization of the current authenticated user.

ownerstringOptionnel

Only present if organization is not set. Can only be set to the current authenticated user.

privatebooleanOptionnel

tagsstring[]Optionnel

titlestringRequis

topicstring · enumRequisExample: healthValeurs possibles:

typestring · enumRequisExample: apiValeurs possibles:

urlstringRequis

The remote URL (website)

Réponses

201

Success

application/json

400

Validation error

post

/reuses/

HTTPcURLJavaScriptPython

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

{
  "archived": "2026-03-11T09:48:07.897Z",
  "dataservices": [
    "text"
  ],
  "datasets": [
    "text"
  ],
  "deleted": "2026-03-11T09:48:07.897Z",
  "description": "text",
  "extras": {},
  "organization": "text",
  "owner": "text",
  "private": true,
  "tags": [
    "text"
  ],
  "title": "text",
  "topic": "health",
  "type": "api",
  "url": "text"
}

{
  "archived": "2026-03-11T09:48:07.897Z",
  "badges": [
    {
      "kind": "text"
    }
  ],
  "created_at": "2026-03-11T09:48:07.897Z",
  "dataservices": [
    {
      "class": "text",
      "id": "text",
      "self_api_url": "text",
      "self_web_url": "text",
      "title": "My awesome API"
    }
  ],
  "datasets": [
    {
      "access_audiences": [
        {
          "condition": "yes",
          "role": "local_authority_and_administration"
        }
      ],
      "access_type": "text",
      "access_type_reason": "text",
      "access_type_reason_category": "text",
      "acronym": "text",
      "archived": "2026-03-11T09:48:07.897Z",
      "authorization_request_url": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "community_resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text",
          "dataset": {
            "class": "text",
            "id": "text"
          },
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "permissions": {
            "delete": true,
            "edit": true,
            "edit_resources": true
          }
        }
      ],
      "contact_points": [
        {
          "contact_form": "text",
          "email": "text",
          "id": "text",
          "name": "text",
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "role": "text"
        }
      ],
      "created_at": "2026-03-11T09:48:07.897Z",
      "deleted": "2026-03-11T09:48:07.897Z",
      "description": "text",
      "description_short": "text",
      "extras": {},
      "featured": true,
      "frequency": "continuous",
      "frequency_date": "2026-03-11T09:48:07.897Z",
      "harvest": {
        "archived": "text",
        "archived_at": "2026-03-11T09:48:07.897Z",
        "backend": "text",
        "created_at": "2026-03-11T09:48:07.897Z",
        "dct_identifier": "text",
        "domain": "text",
        "issued_at": "2026-03-11T09:48:07.897Z",
        "last_update": "2026-03-11T09:48:07.897Z",
        "modified_at": "2026-03-11T09:48:07.897Z",
        "remote_id": "text",
        "remote_url": "text",
        "source_id": "text",
        "uri": "text"
      },
      "id": "text",
      "internal": {
        "created_at_internal": "2026-03-11T09:48:07.897Z",
        "last_modified_internal": "2026-03-11T09:48:07.897Z"
      },
      "last_modified": "2026-03-11T09:48:07.897Z",
      "last_update": "2026-03-11T09:48:07.897Z",
      "license": "notspecified",
      "metrics": {},
      "organization": {
        "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"
      },
      "owner": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true,
        "edit_resources": true
      },
      "private": true,
      "quality": {},
      "resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text"
        }
      ],
      "schema": {
        "name": "text",
        "url": "text",
        "version": "text"
      },
      "slug": "text",
      "spatial": {
        "geom": {
          "coordinates": [
            {}
          ],
          "type": "Point"
        },
        "granularity": "other",
        "zones": {}
      },
      "tags": [
        "text"
      ],
      "temporal_coverage": {
        "end": "2026-03-11T09:48:07.897Z",
        "start": "2026-03-11T09:48:07.897Z"
      },
      "title": "text",
      "uri": "text"
    }
  ],
  "deleted": "2026-03-11T09:48:07.897Z",
  "description": "text",
  "extras": {},
  "featured": true,
  "id": "text",
  "image": "text",
  "image_thumbnail": "text",
  "last_modified": "2026-03-11T09:48:07.897Z",
  "metrics": {},
  "organization": {
    "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"
  },
  "owner": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  },
  "page": "text",
  "permissions": {
    "delete": true,
    "edit": true
  },
  "private": true,
  "slug": "text",
  "tags": [
    "text"
  ],
  "title": "text",
  "topic": "health",
  "type": "api",
  "uri": "text",
  "url": "text"
}

List all available reuse badges and their labels

get

Réponses

200

Success

Aucun contenu

get

/reuses/badges/

HTTPcURLJavaScriptPython

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

200

Success

Aucun contenu

Reuses suggest endpoint using mongoDB contains

get

Paramètres de requête

qstringRequis

The string to autocomplete/suggest

sizeintegerOptionnel

The amount of suggestion to fetch

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

idstringLecture seuleOptionnel

The reuse identifier

image_urlstringLecture seuleOptionnel

The reuse thumbnail URL

pagestringLecture seuleOptionnel

The reuse web page URL

slugstringLecture seuleOptionnel

The reuse permalink string

titlestringLecture seuleOptionnel

The reuse title

get

/reuses/suggest/

HTTPcURLJavaScriptPython

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

200

Success

[
  {
    "id": "text",
    "image_url": "text",
    "page": "text",
    "slug": "text",
    "title": "text"
  }
]

List all reuse topics

get

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

idstringOptionnel

The reuse topic identifier

labelstringOptionnel

The reuse topic display name

get

/reuses/topics/

HTTPcURLJavaScriptPython

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

200

Success

[
  {
    "id": "text",
    "label": "text"
  }
]

List all reuse types

get

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

idstringOptionnel

The reuse type identifier

labelstringOptionnel

The reuse type display name

get

/reuses/types/

HTTPcURLJavaScriptPython

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

200

Success

[
  {
    "id": "text",
    "label": "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

/reuses/{id}/followers/

HTTPcURLJavaScriptPython

GET /api/1/reuses/{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-03-11T09:48:07.897Z"
    }
  ],
  "next_page": "text",
  "page": 1,
  "page_size": 1,
  "previous_page": "text",
  "total": 1
}

Follow an object given its ID

post

Returns the number of followers left after the operation

Paramètres de chemin

idstringRequis

Réponses

200

Success

Aucun contenu

post

/reuses/{id}/followers/

HTTPcURLJavaScriptPython

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

200

Success

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

/reuses/{id}/followers/

HTTPcURLJavaScriptPython

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

200

Success

Aucun contenu

Fetch a given reuse

get

Paramètres de chemin

reusestringRequis

The reuse ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

archivedstring · date-timeOptionnel

created_atstring · date-timeLecture seuleRequis

deletedstring · date-timeOptionnel

descriptionstring · markdownRequis

extrasobjectOptionnel

featuredbooleanLecture seuleOptionnel

idstringLecture seuleRequis

imagestringLecture seuleOptionnel

URL of the image

image_thumbnailstringLecture seuleOptionnel

URL of the cropped and squared image (500x500)

last_modifiedstring · date-timeLecture seuleRequis

metricsobjectLecture seuleOptionnel

pagestringLecture seuleOptionnel

Link to the udata web page for this reuse

privatebooleanOptionnel

slugstring · max: 255Lecture seuleRequis

tagsstring[]Optionnel

titlestringRequis

topicstring · enumRequisExample: healthValeurs possibles:

typestring · enumRequisExample: apiValeurs possibles:

uristringLecture seuleOptionnel

Link to the API endpoint for this reuse

urlstringRequis

The remote URL (website)

404

Reuse not found

410

Reuse has been deleted

get

/reuses/{reuse}/

HTTPcURLJavaScriptPython

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

{
  "archived": "2026-03-11T09:48:07.897Z",
  "badges": [
    {
      "kind": "text"
    }
  ],
  "created_at": "2026-03-11T09:48:07.897Z",
  "dataservices": [
    {
      "class": "text",
      "id": "text",
      "self_api_url": "text",
      "self_web_url": "text",
      "title": "My awesome API"
    }
  ],
  "datasets": [
    {
      "access_audiences": [
        {
          "condition": "yes",
          "role": "local_authority_and_administration"
        }
      ],
      "access_type": "text",
      "access_type_reason": "text",
      "access_type_reason_category": "text",
      "acronym": "text",
      "archived": "2026-03-11T09:48:07.897Z",
      "authorization_request_url": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "community_resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text",
          "dataset": {
            "class": "text",
            "id": "text"
          },
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "permissions": {
            "delete": true,
            "edit": true,
            "edit_resources": true
          }
        }
      ],
      "contact_points": [
        {
          "contact_form": "text",
          "email": "text",
          "id": "text",
          "name": "text",
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "role": "text"
        }
      ],
      "created_at": "2026-03-11T09:48:07.897Z",
      "deleted": "2026-03-11T09:48:07.897Z",
      "description": "text",
      "description_short": "text",
      "extras": {},
      "featured": true,
      "frequency": "continuous",
      "frequency_date": "2026-03-11T09:48:07.897Z",
      "harvest": {
        "archived": "text",
        "archived_at": "2026-03-11T09:48:07.897Z",
        "backend": "text",
        "created_at": "2026-03-11T09:48:07.897Z",
        "dct_identifier": "text",
        "domain": "text",
        "issued_at": "2026-03-11T09:48:07.897Z",
        "last_update": "2026-03-11T09:48:07.897Z",
        "modified_at": "2026-03-11T09:48:07.897Z",
        "remote_id": "text",
        "remote_url": "text",
        "source_id": "text",
        "uri": "text"
      },
      "id": "text",
      "internal": {
        "created_at_internal": "2026-03-11T09:48:07.897Z",
        "last_modified_internal": "2026-03-11T09:48:07.897Z"
      },
      "last_modified": "2026-03-11T09:48:07.897Z",
      "last_update": "2026-03-11T09:48:07.897Z",
      "license": "notspecified",
      "metrics": {},
      "organization": {
        "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"
      },
      "owner": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true,
        "edit_resources": true
      },
      "private": true,
      "quality": {},
      "resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text"
        }
      ],
      "schema": {
        "name": "text",
        "url": "text",
        "version": "text"
      },
      "slug": "text",
      "spatial": {
        "geom": {
          "coordinates": [
            {}
          ],
          "type": "Point"
        },
        "granularity": "other",
        "zones": {}
      },
      "tags": [
        "text"
      ],
      "temporal_coverage": {
        "end": "2026-03-11T09:48:07.897Z",
        "start": "2026-03-11T09:48:07.897Z"
      },
      "title": "text",
      "uri": "text"
    }
  ],
  "deleted": "2026-03-11T09:48:07.897Z",
  "description": "text",
  "extras": {},
  "featured": true,
  "id": "text",
  "image": "text",
  "image_thumbnail": "text",
  "last_modified": "2026-03-11T09:48:07.897Z",
  "metrics": {},
  "organization": {
    "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"
  },
  "owner": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  },
  "page": "text",
  "permissions": {
    "delete": true,
    "edit": true
  },
  "private": true,
  "slug": "text",
  "tags": [
    "text"
  ],
  "title": "text",
  "topic": "health",
  "type": "api",
  "uri": "text",
  "url": "text"
}

Update a given reuse

put

Paramètres de chemin

reusestringRequis

The reuse ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

archivedstring · date-timeOptionnel

dataservicesstring[]Optionnel

ID of the reference

datasetsstring[]Optionnel

ID of the reference

deletedstring · date-timeOptionnel

descriptionstring · markdownRequis

extrasobjectOptionnel

organizationstringOptionnel

Only present if owner is not set. Can only be set to an organization of the current authenticated user.

ownerstringOptionnel

Only present if organization is not set. Can only be set to the current authenticated user.

privatebooleanOptionnel

tagsstring[]Optionnel

titlestringRequis

topicstring · enumRequisExample: healthValeurs possibles:

typestring · enumRequisExample: apiValeurs possibles:

urlstringRequis

The remote URL (website)

Réponses

200

Success

application/json

archivedstring · date-timeOptionnel

created_atstring · date-timeLecture seuleRequis

deletedstring · date-timeOptionnel

descriptionstring · markdownRequis

extrasobjectOptionnel

featuredbooleanLecture seuleOptionnel

idstringLecture seuleRequis

imagestringLecture seuleOptionnel

URL of the image

image_thumbnailstringLecture seuleOptionnel

URL of the cropped and squared image (500x500)

last_modifiedstring · date-timeLecture seuleRequis

metricsobjectLecture seuleOptionnel

pagestringLecture seuleOptionnel

Link to the udata web page for this reuse

privatebooleanOptionnel

slugstring · max: 255Lecture seuleRequis

tagsstring[]Optionnel

titlestringRequis

topicstring · enumRequisExample: healthValeurs possibles:

typestring · enumRequisExample: apiValeurs possibles:

uristringLecture seuleOptionnel

Link to the API endpoint for this reuse

urlstringRequis

The remote URL (website)

400

Validation error: your data cannot be updated for now, we have been notified of the error and we will fix it as soon as possible.

404

Reuse not found

410

Reuse has been deleted

put

/reuses/{reuse}/

HTTPcURLJavaScriptPython

PUT /api/1/reuses/{reuse}/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 279

{
  "archived": "2026-03-11T09:48:07.897Z",
  "dataservices": [
    "text"
  ],
  "datasets": [
    "text"
  ],
  "deleted": "2026-03-11T09:48:07.897Z",
  "description": "text",
  "extras": {},
  "organization": "text",
  "owner": "text",
  "private": true,
  "tags": [
    "text"
  ],
  "title": "text",
  "topic": "health",
  "type": "api",
  "url": "text"
}

{
  "archived": "2026-03-11T09:48:07.897Z",
  "badges": [
    {
      "kind": "text"
    }
  ],
  "created_at": "2026-03-11T09:48:07.897Z",
  "dataservices": [
    {
      "class": "text",
      "id": "text",
      "self_api_url": "text",
      "self_web_url": "text",
      "title": "My awesome API"
    }
  ],
  "datasets": [
    {
      "access_audiences": [
        {
          "condition": "yes",
          "role": "local_authority_and_administration"
        }
      ],
      "access_type": "text",
      "access_type_reason": "text",
      "access_type_reason_category": "text",
      "acronym": "text",
      "archived": "2026-03-11T09:48:07.897Z",
      "authorization_request_url": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "community_resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text",
          "dataset": {
            "class": "text",
            "id": "text"
          },
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "permissions": {
            "delete": true,
            "edit": true,
            "edit_resources": true
          }
        }
      ],
      "contact_points": [
        {
          "contact_form": "text",
          "email": "text",
          "id": "text",
          "name": "text",
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "role": "text"
        }
      ],
      "created_at": "2026-03-11T09:48:07.897Z",
      "deleted": "2026-03-11T09:48:07.897Z",
      "description": "text",
      "description_short": "text",
      "extras": {},
      "featured": true,
      "frequency": "continuous",
      "frequency_date": "2026-03-11T09:48:07.897Z",
      "harvest": {
        "archived": "text",
        "archived_at": "2026-03-11T09:48:07.897Z",
        "backend": "text",
        "created_at": "2026-03-11T09:48:07.897Z",
        "dct_identifier": "text",
        "domain": "text",
        "issued_at": "2026-03-11T09:48:07.897Z",
        "last_update": "2026-03-11T09:48:07.897Z",
        "modified_at": "2026-03-11T09:48:07.897Z",
        "remote_id": "text",
        "remote_url": "text",
        "source_id": "text",
        "uri": "text"
      },
      "id": "text",
      "internal": {
        "created_at_internal": "2026-03-11T09:48:07.897Z",
        "last_modified_internal": "2026-03-11T09:48:07.897Z"
      },
      "last_modified": "2026-03-11T09:48:07.897Z",
      "last_update": "2026-03-11T09:48:07.897Z",
      "license": "notspecified",
      "metrics": {},
      "organization": {
        "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"
      },
      "owner": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true,
        "edit_resources": true
      },
      "private": true,
      "quality": {},
      "resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text"
        }
      ],
      "schema": {
        "name": "text",
        "url": "text",
        "version": "text"
      },
      "slug": "text",
      "spatial": {
        "geom": {
          "coordinates": [
            {}
          ],
          "type": "Point"
        },
        "granularity": "other",
        "zones": {}
      },
      "tags": [
        "text"
      ],
      "temporal_coverage": {
        "end": "2026-03-11T09:48:07.897Z",
        "start": "2026-03-11T09:48:07.897Z"
      },
      "title": "text",
      "uri": "text"
    }
  ],
  "deleted": "2026-03-11T09:48:07.897Z",
  "description": "text",
  "extras": {},
  "featured": true,
  "id": "text",
  "image": "text",
  "image_thumbnail": "text",
  "last_modified": "2026-03-11T09:48:07.897Z",
  "metrics": {},
  "organization": {
    "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"
  },
  "owner": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  },
  "page": "text",
  "permissions": {
    "delete": true,
    "edit": true
  },
  "private": true,
  "slug": "text",
  "tags": [
    "text"
  ],
  "title": "text",
  "topic": "health",
  "type": "api",
  "uri": "text",
  "url": "text"
}

Delete a given reuse

delete

Paramètres de chemin

reusestringRequis

The reuse ID or slug

Paramètres de requête

send_legal_noticebooleanOptionnel

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

Réponses

204

Reuse deleted

404

Reuse not found

410

Reuse has been deleted

delete

/reuses/{reuse}/

HTTPcURLJavaScriptPython

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

Aucun contenu

Create a new badge for a given reuse

post

Paramètres de chemin

reusestringRequis

The reuse ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

kindstringRequis

Kind of badge (certified, etc), specific to each model

Réponses

200

Success

application/json

kindstringRequis

Kind of badge (certified, etc), specific to each model

post

/reuses/{reuse}/badges/

HTTPcURLJavaScriptPython

POST /api/1/reuses/{reuse}/badges/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 15

{
  "kind": "text"
}

200

Success

{
  "kind": "text"
}

Delete a badge for a given reuse

delete

Paramètres de chemin

badge_kindstringRequis

reusestringRequis

The reuse ID or slug

Réponses

200

Success

Aucun contenu

delete

/reuses/{reuse}/badges/{badge_kind}/

HTTPcURLJavaScriptPython

DELETE /api/1/reuses/{reuse}/badges/{badge_kind}/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

Aucun contenu

Add a dataset to a given reuse

post

Paramètres de chemin

reusestringRequis

The reuse ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

Réponses

200

The dataset is already present

application/json

archivedstring · date-timeOptionnel

created_atstring · date-timeLecture seuleRequis

deletedstring · date-timeOptionnel

descriptionstring · markdownRequis

extrasobjectOptionnel

featuredbooleanLecture seuleOptionnel

idstringLecture seuleRequis

imagestringLecture seuleOptionnel

URL of the image

image_thumbnailstringLecture seuleOptionnel

URL of the cropped and squared image (500x500)

last_modifiedstring · date-timeLecture seuleRequis

metricsobjectLecture seuleOptionnel

pagestringLecture seuleOptionnel

Link to the udata web page for this reuse

privatebooleanOptionnel

slugstring · max: 255Lecture seuleRequis

tagsstring[]Optionnel

titlestringRequis

topicstring · enumRequisExample: healthValeurs possibles:

typestring · enumRequisExample: apiValeurs possibles:

uristringLecture seuleOptionnel

Link to the API endpoint for this reuse

urlstringRequis

The remote URL (website)

201

Success

application/json

403

Not allowed to modify this reuse

post

/reuses/{reuse}/datasets/

HTTPcURLJavaScriptPython

POST /api/1/reuses/{reuse}/datasets/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 28

{
  "class": "text",
  "id": "text"
}

{
  "archived": "2026-03-11T09:48:07.897Z",
  "badges": [
    {
      "kind": "text"
    }
  ],
  "created_at": "2026-03-11T09:48:07.897Z",
  "dataservices": [
    {
      "class": "text",
      "id": "text",
      "self_api_url": "text",
      "self_web_url": "text",
      "title": "My awesome API"
    }
  ],
  "datasets": [
    {
      "access_audiences": [
        {
          "condition": "yes",
          "role": "local_authority_and_administration"
        }
      ],
      "access_type": "text",
      "access_type_reason": "text",
      "access_type_reason_category": "text",
      "acronym": "text",
      "archived": "2026-03-11T09:48:07.897Z",
      "authorization_request_url": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "community_resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text",
          "dataset": {
            "class": "text",
            "id": "text"
          },
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "permissions": {
            "delete": true,
            "edit": true,
            "edit_resources": true
          }
        }
      ],
      "contact_points": [
        {
          "contact_form": "text",
          "email": "text",
          "id": "text",
          "name": "text",
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "role": "text"
        }
      ],
      "created_at": "2026-03-11T09:48:07.897Z",
      "deleted": "2026-03-11T09:48:07.897Z",
      "description": "text",
      "description_short": "text",
      "extras": {},
      "featured": true,
      "frequency": "continuous",
      "frequency_date": "2026-03-11T09:48:07.897Z",
      "harvest": {
        "archived": "text",
        "archived_at": "2026-03-11T09:48:07.897Z",
        "backend": "text",
        "created_at": "2026-03-11T09:48:07.897Z",
        "dct_identifier": "text",
        "domain": "text",
        "issued_at": "2026-03-11T09:48:07.897Z",
        "last_update": "2026-03-11T09:48:07.897Z",
        "modified_at": "2026-03-11T09:48:07.897Z",
        "remote_id": "text",
        "remote_url": "text",
        "source_id": "text",
        "uri": "text"
      },
      "id": "text",
      "internal": {
        "created_at_internal": "2026-03-11T09:48:07.897Z",
        "last_modified_internal": "2026-03-11T09:48:07.897Z"
      },
      "last_modified": "2026-03-11T09:48:07.897Z",
      "last_update": "2026-03-11T09:48:07.897Z",
      "license": "notspecified",
      "metrics": {},
      "organization": {
        "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"
      },
      "owner": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true,
        "edit_resources": true
      },
      "private": true,
      "quality": {},
      "resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text"
        }
      ],
      "schema": {
        "name": "text",
        "url": "text",
        "version": "text"
      },
      "slug": "text",
      "spatial": {
        "geom": {
          "coordinates": [
            {}
          ],
          "type": "Point"
        },
        "granularity": "other",
        "zones": {}
      },
      "tags": [
        "text"
      ],
      "temporal_coverage": {
        "end": "2026-03-11T09:48:07.897Z",
        "start": "2026-03-11T09:48:07.897Z"
      },
      "title": "text",
      "uri": "text"
    }
  ],
  "deleted": "2026-03-11T09:48:07.897Z",
  "description": "text",
  "extras": {},
  "featured": true,
  "id": "text",
  "image": "text",
  "image_thumbnail": "text",
  "last_modified": "2026-03-11T09:48:07.897Z",
  "metrics": {},
  "organization": {
    "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"
  },
  "owner": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  },
  "page": "text",
  "permissions": {
    "delete": true,
    "edit": true
  },
  "private": true,
  "slug": "text",
  "tags": [
    "text"
  ],
  "title": "text",
  "topic": "health",
  "type": "api",
  "uri": "text",
  "url": "text"
}

Mark a reuse as featured

post

Paramètres de chemin

reusestringRequis

The reuse ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

archivedstring · date-timeOptionnel

created_atstring · date-timeLecture seuleRequis

deletedstring · date-timeOptionnel

descriptionstring · markdownRequis

extrasobjectOptionnel

featuredbooleanLecture seuleOptionnel

idstringLecture seuleRequis

imagestringLecture seuleOptionnel

URL of the image

image_thumbnailstringLecture seuleOptionnel

URL of the cropped and squared image (500x500)

last_modifiedstring · date-timeLecture seuleRequis

metricsobjectLecture seuleOptionnel

pagestringLecture seuleOptionnel

Link to the udata web page for this reuse

privatebooleanOptionnel

slugstring · max: 255Lecture seuleRequis

tagsstring[]Optionnel

titlestringRequis

topicstring · enumRequisExample: healthValeurs possibles:

typestring · enumRequisExample: apiValeurs possibles:

uristringLecture seuleOptionnel

Link to the API endpoint for this reuse

urlstringRequis

The remote URL (website)

post

/reuses/{reuse}/featured/

HTTPcURLJavaScriptPython

POST /api/1/reuses/{reuse}/featured/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

{
  "archived": "2026-03-11T09:48:07.897Z",
  "badges": [
    {
      "kind": "text"
    }
  ],
  "created_at": "2026-03-11T09:48:07.897Z",
  "dataservices": [
    {
      "class": "text",
      "id": "text",
      "self_api_url": "text",
      "self_web_url": "text",
      "title": "My awesome API"
    }
  ],
  "datasets": [
    {
      "access_audiences": [
        {
          "condition": "yes",
          "role": "local_authority_and_administration"
        }
      ],
      "access_type": "text",
      "access_type_reason": "text",
      "access_type_reason_category": "text",
      "acronym": "text",
      "archived": "2026-03-11T09:48:07.897Z",
      "authorization_request_url": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "community_resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text",
          "dataset": {
            "class": "text",
            "id": "text"
          },
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "permissions": {
            "delete": true,
            "edit": true,
            "edit_resources": true
          }
        }
      ],
      "contact_points": [
        {
          "contact_form": "text",
          "email": "text",
          "id": "text",
          "name": "text",
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "role": "text"
        }
      ],
      "created_at": "2026-03-11T09:48:07.897Z",
      "deleted": "2026-03-11T09:48:07.897Z",
      "description": "text",
      "description_short": "text",
      "extras": {},
      "featured": true,
      "frequency": "continuous",
      "frequency_date": "2026-03-11T09:48:07.897Z",
      "harvest": {
        "archived": "text",
        "archived_at": "2026-03-11T09:48:07.897Z",
        "backend": "text",
        "created_at": "2026-03-11T09:48:07.897Z",
        "dct_identifier": "text",
        "domain": "text",
        "issued_at": "2026-03-11T09:48:07.897Z",
        "last_update": "2026-03-11T09:48:07.897Z",
        "modified_at": "2026-03-11T09:48:07.897Z",
        "remote_id": "text",
        "remote_url": "text",
        "source_id": "text",
        "uri": "text"
      },
      "id": "text",
      "internal": {
        "created_at_internal": "2026-03-11T09:48:07.897Z",
        "last_modified_internal": "2026-03-11T09:48:07.897Z"
      },
      "last_modified": "2026-03-11T09:48:07.897Z",
      "last_update": "2026-03-11T09:48:07.897Z",
      "license": "notspecified",
      "metrics": {},
      "organization": {
        "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"
      },
      "owner": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true,
        "edit_resources": true
      },
      "private": true,
      "quality": {},
      "resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text"
        }
      ],
      "schema": {
        "name": "text",
        "url": "text",
        "version": "text"
      },
      "slug": "text",
      "spatial": {
        "geom": {
          "coordinates": [
            {}
          ],
          "type": "Point"
        },
        "granularity": "other",
        "zones": {}
      },
      "tags": [
        "text"
      ],
      "temporal_coverage": {
        "end": "2026-03-11T09:48:07.897Z",
        "start": "2026-03-11T09:48:07.897Z"
      },
      "title": "text",
      "uri": "text"
    }
  ],
  "deleted": "2026-03-11T09:48:07.897Z",
  "description": "text",
  "extras": {},
  "featured": true,
  "id": "text",
  "image": "text",
  "image_thumbnail": "text",
  "last_modified": "2026-03-11T09:48:07.897Z",
  "metrics": {},
  "organization": {
    "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"
  },
  "owner": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  },
  "page": "text",
  "permissions": {
    "delete": true,
    "edit": true
  },
  "private": true,
  "slug": "text",
  "tags": [
    "text"
  ],
  "title": "text",
  "topic": "health",
  "type": "api",
  "uri": "text",
  "url": "text"
}

Unmark a reuse as featured

delete

Paramètres de chemin

reusestringRequis

The reuse ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

archivedstring · date-timeOptionnel

created_atstring · date-timeLecture seuleRequis

deletedstring · date-timeOptionnel

descriptionstring · markdownRequis

extrasobjectOptionnel

featuredbooleanLecture seuleOptionnel

idstringLecture seuleRequis

imagestringLecture seuleOptionnel

URL of the image

image_thumbnailstringLecture seuleOptionnel

URL of the cropped and squared image (500x500)

last_modifiedstring · date-timeLecture seuleRequis

metricsobjectLecture seuleOptionnel

pagestringLecture seuleOptionnel

Link to the udata web page for this reuse

privatebooleanOptionnel

slugstring · max: 255Lecture seuleRequis

tagsstring[]Optionnel

titlestringRequis

topicstring · enumRequisExample: healthValeurs possibles:

typestring · enumRequisExample: apiValeurs possibles:

uristringLecture seuleOptionnel

Link to the API endpoint for this reuse

urlstringRequis

The remote URL (website)

delete

/reuses/{reuse}/featured/

HTTPcURLJavaScriptPython

DELETE /api/1/reuses/{reuse}/featured/ HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

200

Success

{
  "archived": "2026-03-11T09:48:07.897Z",
  "badges": [
    {
      "kind": "text"
    }
  ],
  "created_at": "2026-03-11T09:48:07.897Z",
  "dataservices": [
    {
      "class": "text",
      "id": "text",
      "self_api_url": "text",
      "self_web_url": "text",
      "title": "My awesome API"
    }
  ],
  "datasets": [
    {
      "access_audiences": [
        {
          "condition": "yes",
          "role": "local_authority_and_administration"
        }
      ],
      "access_type": "text",
      "access_type_reason": "text",
      "access_type_reason_category": "text",
      "acronym": "text",
      "archived": "2026-03-11T09:48:07.897Z",
      "authorization_request_url": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "community_resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text",
          "dataset": {
            "class": "text",
            "id": "text"
          },
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "permissions": {
            "delete": true,
            "edit": true,
            "edit_resources": true
          }
        }
      ],
      "contact_points": [
        {
          "contact_form": "text",
          "email": "text",
          "id": "text",
          "name": "text",
          "organization": {
            "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"
          },
          "owner": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "role": "text"
        }
      ],
      "created_at": "2026-03-11T09:48:07.897Z",
      "deleted": "2026-03-11T09:48:07.897Z",
      "description": "text",
      "description_short": "text",
      "extras": {},
      "featured": true,
      "frequency": "continuous",
      "frequency_date": "2026-03-11T09:48:07.897Z",
      "harvest": {
        "archived": "text",
        "archived_at": "2026-03-11T09:48:07.897Z",
        "backend": "text",
        "created_at": "2026-03-11T09:48:07.897Z",
        "dct_identifier": "text",
        "domain": "text",
        "issued_at": "2026-03-11T09:48:07.897Z",
        "last_update": "2026-03-11T09:48:07.897Z",
        "modified_at": "2026-03-11T09:48:07.897Z",
        "remote_id": "text",
        "remote_url": "text",
        "source_id": "text",
        "uri": "text"
      },
      "id": "text",
      "internal": {
        "created_at_internal": "2026-03-11T09:48:07.897Z",
        "last_modified_internal": "2026-03-11T09:48:07.897Z"
      },
      "last_modified": "2026-03-11T09:48:07.897Z",
      "last_update": "2026-03-11T09:48:07.897Z",
      "license": "notspecified",
      "metrics": {},
      "organization": {
        "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"
      },
      "owner": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "page": "text",
      "permissions": {
        "delete": true,
        "edit": true,
        "edit_resources": true
      },
      "private": true,
      "quality": {},
      "resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-11T09:48:07.897Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-11T09:48:07.897Z",
            "modified_at": "2026-03-11T09:48:07.897Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-11T09:48:07.897Z",
            "last_modified_internal": "2026-03-11T09:48:07.897Z"
          },
          "last_modified": "2026-03-11T09:48:07.897Z",
          "latest": "text",
          "metrics": {},
          "mime": "text",
          "preview_url": "text",
          "schema": {
            "name": "text",
            "url": "text",
            "version": "text"
          },
          "title": "text",
          "type": "main",
          "url": "text"
        }
      ],
      "schema": {
        "name": "text",
        "url": "text",
        "version": "text"
      },
      "slug": "text",
      "spatial": {
        "geom": {
          "coordinates": [
            {}
          ],
          "type": "Point"
        },
        "granularity": "other",
        "zones": {}
      },
      "tags": [
        "text"
      ],
      "temporal_coverage": {
        "end": "2026-03-11T09:48:07.897Z",
        "start": "2026-03-11T09:48:07.897Z"
      },
      "title": "text",
      "uri": "text"
    }
  ],
  "deleted": "2026-03-11T09:48:07.897Z",
  "description": "text",
  "extras": {},
  "featured": true,
  "id": "text",
  "image": "text",
  "image_thumbnail": "text",
  "last_modified": "2026-03-11T09:48:07.897Z",
  "metrics": {},
  "organization": {
    "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"
  },
  "owner": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  },
  "page": "text",
  "permissions": {
    "delete": true,
    "edit": true
  },
  "private": true,
  "slug": "text",
  "tags": [
    "text"
  ],
  "title": "text",
  "topic": "health",
  "type": "api",
  "uri": "text",
  "url": "text"
}