posts

Posts related operations

List all posts

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

kindstring · enumOptionnelValeurs possibles:

with_draftsbooleanOptionnel

True also returns the unpublished posts (only for super-admins)

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

/posts/

HTTPcURLJavaScriptPython

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

200

Success

{
  "data": [
    {
      "body_type": "markdown",
      "content": "text",
      "content_as_page": {
        "blocs": [
          {}
        ],
        "created_at": "2026-03-01T13:55:00.514Z",
        "id": "text",
        "last_modified": "2026-03-01T13:55:00.514Z",
        "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
        }
      },
      "created_at": "2026-03-01T13:55:00.514Z",
      "credit_to": "text",
      "credit_url": "text",
      "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-01T13:55:00.514Z",
          "authorization_request_url": "text",
          "badges": [
            {
              "kind": "text"
            }
          ],
          "community_resources": [
            {
              "checksum": {
                "type": "sha1",
                "value": "text"
              },
              "created_at": "2026-03-01T13:55:00.514Z",
              "description": "text",
              "extras": {},
              "filesize": 1,
              "filetype": "file",
              "format": "text",
              "harvest": {
                "issued_at": "2026-03-01T13:55:00.514Z",
                "modified_at": "2026-03-01T13:55:00.514Z",
                "uri": "text"
              },
              "id": "text",
              "internal": {
                "created_at_internal": "2026-03-01T13:55:00.514Z",
                "last_modified_internal": "2026-03-01T13:55:00.514Z"
              },
              "last_modified": "2026-03-01T13:55:00.514Z",
              "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-01T13:55:00.514Z",
          "deleted": "2026-03-01T13:55:00.514Z",
          "description": "text",
          "description_short": "text",
          "extras": {},
          "featured": true,
          "frequency": "continuous",
          "frequency_date": "2026-03-01T13:55:00.514Z",
          "harvest": {
            "archived": "text",
            "archived_at": "2026-03-01T13:55:00.514Z",
            "backend": "text",
            "created_at": "2026-03-01T13:55:00.514Z",
            "dct_identifier": "text",
            "domain": "text",
            "issued_at": "2026-03-01T13:55:00.514Z",
            "last_update": "2026-03-01T13:55:00.514Z",
            "modified_at": "2026-03-01T13:55:00.514Z",
            "remote_id": "text",
            "remote_url": "text",
            "source_id": "text",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-01T13:55:00.514Z",
            "last_modified_internal": "2026-03-01T13:55:00.514Z"
          },
          "last_modified": "2026-03-01T13:55:00.514Z",
          "last_update": "2026-03-01T13:55:00.514Z",
          "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-01T13:55:00.514Z",
              "description": "text",
              "extras": {},
              "filesize": 1,
              "filetype": "file",
              "format": "text",
              "harvest": {
                "issued_at": "2026-03-01T13:55:00.514Z",
                "modified_at": "2026-03-01T13:55:00.514Z",
                "uri": "text"
              },
              "id": "text",
              "internal": {
                "created_at_internal": "2026-03-01T13:55:00.514Z",
                "last_modified_internal": "2026-03-01T13:55:00.514Z"
              },
              "last_modified": "2026-03-01T13:55:00.514Z",
              "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-01T13:55:00.514Z",
            "start": "2026-03-01T13:55:00.514Z"
          },
          "title": "text",
          "uri": "text"
        }
      ],
      "headline": "text",
      "id": "text",
      "image": "text",
      "image_thumbnail": "text",
      "image_url": "text",
      "kind": "news",
      "last_modified": "2026-03-01T13:55:00.514Z",
      "name": "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",
      "published": "2026-03-01T13:55:00.514Z",
      "reuses": [
        {
          "class": "text",
          "id": "text",
          "image": "text",
          "image_thumbnail": "text",
          "page": "text",
          "title": "text",
          "uri": "text"
        }
      ],
      "slug": "text",
      "tags": [
        "text"
      ],
      "uri": "text"
    }
  ],
  "next_page": "text",
  "page": 1,
  "page_size": 1,
  "previous_page": "text",
  "total": 1
}

Create a post

post

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

body_typestring · enumOptionnelExample: markdownValeurs possibles:

contentstring · markdownOptionnel

content_as_pagestringOptionnel

Reference to a Page when body_type is 'blocs'

credit_tostringOptionnel

An optional credit line (associated to the image)

credit_urlstringOptionnel

An optional link associated to the credits

datasetsstring[]Optionnel

The post datasets

headlinestringOptionnel

image_urlstringOptionnel

kindstring · enumOptionnel

Post kind (news or page)

Example: newsValeurs possibles:

namestring · max: 255Requis

reusesstring[]Optionnel

The post reuses

tagsstring[]Optionnel

Some keywords to help in search

Réponses

200

Success

application/json

body_typestring · enumOptionnelExample: markdownValeurs possibles:

contentstring · markdownOptionnel

created_atstring · date-timeLecture seuleRequis

credit_tostringOptionnel

An optional credit line (associated to the image)

credit_urlstringOptionnel

An optional link associated to the credits

headlinestringOptionnel

idstringLecture seuleRequis

imagestringLecture seuleOptionnel

URL of the image

image_thumbnailstringLecture seuleOptionnel

URL of the cropped and squared image (100x100)

image_urlstringOptionnel

kindstring · enumOptionnel

Post kind (news or page)

Example: newsValeurs possibles:

last_modifiedstring · date-timeLecture seuleRequis

namestring · max: 255Requis

pagestringLecture seuleOptionnel

The post web page URL

publishedstring · date-timeLecture seuleOptionnel

The post publication date

slugstring · max: 255Lecture seuleRequis

tagsstring[]Optionnel

Some keywords to help in search

uristringLecture seuleOptionnel

The API URI for this post

400

Validation error

post

/posts/

HTTPcURLJavaScriptPython

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

{
  "body_type": "markdown",
  "content": "text",
  "content_as_page": "text",
  "credit_to": "text",
  "credit_url": "text",
  "datasets": [
    "text"
  ],
  "headline": "text",
  "image_url": "text",
  "kind": "news",
  "name": "text",
  "reuses": [
    "text"
  ],
  "tags": [
    "text"
  ]
}

{
  "body_type": "markdown",
  "content": "text",
  "content_as_page": {
    "blocs": [
      {}
    ],
    "created_at": "2026-03-01T13:55:00.514Z",
    "id": "text",
    "last_modified": "2026-03-01T13:55:00.514Z",
    "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
    }
  },
  "created_at": "2026-03-01T13:55:00.514Z",
  "credit_to": "text",
  "credit_url": "text",
  "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-01T13:55:00.514Z",
      "authorization_request_url": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "community_resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-01T13:55:00.514Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-01T13:55:00.514Z",
            "modified_at": "2026-03-01T13:55:00.514Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-01T13:55:00.514Z",
            "last_modified_internal": "2026-03-01T13:55:00.514Z"
          },
          "last_modified": "2026-03-01T13:55:00.514Z",
          "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-01T13:55:00.514Z",
      "deleted": "2026-03-01T13:55:00.514Z",
      "description": "text",
      "description_short": "text",
      "extras": {},
      "featured": true,
      "frequency": "continuous",
      "frequency_date": "2026-03-01T13:55:00.514Z",
      "harvest": {
        "archived": "text",
        "archived_at": "2026-03-01T13:55:00.514Z",
        "backend": "text",
        "created_at": "2026-03-01T13:55:00.514Z",
        "dct_identifier": "text",
        "domain": "text",
        "issued_at": "2026-03-01T13:55:00.514Z",
        "last_update": "2026-03-01T13:55:00.514Z",
        "modified_at": "2026-03-01T13:55:00.514Z",
        "remote_id": "text",
        "remote_url": "text",
        "source_id": "text",
        "uri": "text"
      },
      "id": "text",
      "internal": {
        "created_at_internal": "2026-03-01T13:55:00.514Z",
        "last_modified_internal": "2026-03-01T13:55:00.514Z"
      },
      "last_modified": "2026-03-01T13:55:00.514Z",
      "last_update": "2026-03-01T13:55:00.514Z",
      "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-01T13:55:00.514Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-01T13:55:00.514Z",
            "modified_at": "2026-03-01T13:55:00.514Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-01T13:55:00.514Z",
            "last_modified_internal": "2026-03-01T13:55:00.514Z"
          },
          "last_modified": "2026-03-01T13:55:00.514Z",
          "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-01T13:55:00.514Z",
        "start": "2026-03-01T13:55:00.514Z"
      },
      "title": "text",
      "uri": "text"
    }
  ],
  "headline": "text",
  "id": "text",
  "image": "text",
  "image_thumbnail": "text",
  "image_url": "text",
  "kind": "news",
  "last_modified": "2026-03-01T13:55:00.514Z",
  "name": "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",
  "published": "2026-03-01T13:55:00.514Z",
  "reuses": [
    {
      "class": "text",
      "id": "text",
      "image": "text",
      "image_thumbnail": "text",
      "page": "text",
      "title": "text",
      "uri": "text"
    }
  ],
  "slug": "text",
  "tags": [
    "text"
  ],
  "uri": "text"
}

Get a given post

get

Paramètres de chemin

poststringRequis

The post ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

body_typestring · enumOptionnelExample: markdownValeurs possibles:

contentstring · markdownOptionnel

created_atstring · date-timeLecture seuleRequis

credit_tostringOptionnel

An optional credit line (associated to the image)

credit_urlstringOptionnel

An optional link associated to the credits

headlinestringOptionnel

idstringLecture seuleRequis

imagestringLecture seuleOptionnel

URL of the image

image_thumbnailstringLecture seuleOptionnel

URL of the cropped and squared image (100x100)

image_urlstringOptionnel

kindstring · enumOptionnel

Post kind (news or page)

Example: newsValeurs possibles:

last_modifiedstring · date-timeLecture seuleRequis

namestring · max: 255Requis

pagestringLecture seuleOptionnel

The post web page URL

publishedstring · date-timeLecture seuleOptionnel

The post publication date

slugstring · max: 255Lecture seuleRequis

tagsstring[]Optionnel

Some keywords to help in search

uristringLecture seuleOptionnel

The API URI for this post

404

Object not found

get

/posts/{post}/

HTTPcURLJavaScriptPython

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

{
  "body_type": "markdown",
  "content": "text",
  "content_as_page": {
    "blocs": [
      {}
    ],
    "created_at": "2026-03-01T13:55:00.514Z",
    "id": "text",
    "last_modified": "2026-03-01T13:55:00.514Z",
    "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
    }
  },
  "created_at": "2026-03-01T13:55:00.514Z",
  "credit_to": "text",
  "credit_url": "text",
  "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-01T13:55:00.514Z",
      "authorization_request_url": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "community_resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-01T13:55:00.514Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-01T13:55:00.514Z",
            "modified_at": "2026-03-01T13:55:00.514Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-01T13:55:00.514Z",
            "last_modified_internal": "2026-03-01T13:55:00.514Z"
          },
          "last_modified": "2026-03-01T13:55:00.514Z",
          "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-01T13:55:00.514Z",
      "deleted": "2026-03-01T13:55:00.514Z",
      "description": "text",
      "description_short": "text",
      "extras": {},
      "featured": true,
      "frequency": "continuous",
      "frequency_date": "2026-03-01T13:55:00.514Z",
      "harvest": {
        "archived": "text",
        "archived_at": "2026-03-01T13:55:00.514Z",
        "backend": "text",
        "created_at": "2026-03-01T13:55:00.514Z",
        "dct_identifier": "text",
        "domain": "text",
        "issued_at": "2026-03-01T13:55:00.514Z",
        "last_update": "2026-03-01T13:55:00.514Z",
        "modified_at": "2026-03-01T13:55:00.514Z",
        "remote_id": "text",
        "remote_url": "text",
        "source_id": "text",
        "uri": "text"
      },
      "id": "text",
      "internal": {
        "created_at_internal": "2026-03-01T13:55:00.514Z",
        "last_modified_internal": "2026-03-01T13:55:00.514Z"
      },
      "last_modified": "2026-03-01T13:55:00.514Z",
      "last_update": "2026-03-01T13:55:00.514Z",
      "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-01T13:55:00.514Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-01T13:55:00.514Z",
            "modified_at": "2026-03-01T13:55:00.514Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-01T13:55:00.514Z",
            "last_modified_internal": "2026-03-01T13:55:00.514Z"
          },
          "last_modified": "2026-03-01T13:55:00.514Z",
          "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-01T13:55:00.514Z",
        "start": "2026-03-01T13:55:00.514Z"
      },
      "title": "text",
      "uri": "text"
    }
  ],
  "headline": "text",
  "id": "text",
  "image": "text",
  "image_thumbnail": "text",
  "image_url": "text",
  "kind": "news",
  "last_modified": "2026-03-01T13:55:00.514Z",
  "name": "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",
  "published": "2026-03-01T13:55:00.514Z",
  "reuses": [
    {
      "class": "text",
      "id": "text",
      "image": "text",
      "image_thumbnail": "text",
      "page": "text",
      "title": "text",
      "uri": "text"
    }
  ],
  "slug": "text",
  "tags": [
    "text"
  ],
  "uri": "text"
}

Update a given post

put

Paramètres de chemin

poststringRequis

The post ID or slug

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

application/json

body_typestring · enumOptionnelExample: markdownValeurs possibles:

contentstring · markdownOptionnel

content_as_pagestringOptionnel

Reference to a Page when body_type is 'blocs'

credit_tostringOptionnel

An optional credit line (associated to the image)

credit_urlstringOptionnel

An optional link associated to the credits

datasetsstring[]Optionnel

The post datasets

headlinestringOptionnel

image_urlstringOptionnel

kindstring · enumOptionnel

Post kind (news or page)

Example: newsValeurs possibles:

namestring · max: 255Requis

reusesstring[]Optionnel

The post reuses

tagsstring[]Optionnel

Some keywords to help in search

Réponses

200

Success

application/json

body_typestring · enumOptionnelExample: markdownValeurs possibles:

contentstring · markdownOptionnel

created_atstring · date-timeLecture seuleRequis

credit_tostringOptionnel

An optional credit line (associated to the image)

credit_urlstringOptionnel

An optional link associated to the credits

headlinestringOptionnel

idstringLecture seuleRequis

imagestringLecture seuleOptionnel

URL of the image

image_thumbnailstringLecture seuleOptionnel

URL of the cropped and squared image (100x100)

image_urlstringOptionnel

kindstring · enumOptionnel

Post kind (news or page)

Example: newsValeurs possibles:

last_modifiedstring · date-timeLecture seuleRequis

namestring · max: 255Requis

pagestringLecture seuleOptionnel

The post web page URL

publishedstring · date-timeLecture seuleOptionnel

The post publication date

slugstring · max: 255Lecture seuleRequis

tagsstring[]Optionnel

Some keywords to help in search

uristringLecture seuleOptionnel

The API URI for this post

400

Validation error

404

Object not found

put

/posts/{post}/

HTTPcURLJavaScriptPython

PUT /api/1/posts/{post}/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 224

{
  "body_type": "markdown",
  "content": "text",
  "content_as_page": "text",
  "credit_to": "text",
  "credit_url": "text",
  "datasets": [
    "text"
  ],
  "headline": "text",
  "image_url": "text",
  "kind": "news",
  "name": "text",
  "reuses": [
    "text"
  ],
  "tags": [
    "text"
  ]
}

{
  "body_type": "markdown",
  "content": "text",
  "content_as_page": {
    "blocs": [
      {}
    ],
    "created_at": "2026-03-01T13:55:00.514Z",
    "id": "text",
    "last_modified": "2026-03-01T13:55:00.514Z",
    "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
    }
  },
  "created_at": "2026-03-01T13:55:00.514Z",
  "credit_to": "text",
  "credit_url": "text",
  "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-01T13:55:00.514Z",
      "authorization_request_url": "text",
      "badges": [
        {
          "kind": "text"
        }
      ],
      "community_resources": [
        {
          "checksum": {
            "type": "sha1",
            "value": "text"
          },
          "created_at": "2026-03-01T13:55:00.514Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-01T13:55:00.514Z",
            "modified_at": "2026-03-01T13:55:00.514Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-01T13:55:00.514Z",
            "last_modified_internal": "2026-03-01T13:55:00.514Z"
          },
          "last_modified": "2026-03-01T13:55:00.514Z",
          "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-01T13:55:00.514Z",
      "deleted": "2026-03-01T13:55:00.514Z",
      "description": "text",
      "description_short": "text",
      "extras": {},
      "featured": true,
      "frequency": "continuous",
      "frequency_date": "2026-03-01T13:55:00.514Z",
      "harvest": {
        "archived": "text",
        "archived_at": "2026-03-01T13:55:00.514Z",
        "backend": "text",
        "created_at": "2026-03-01T13:55:00.514Z",
        "dct_identifier": "text",
        "domain": "text",
        "issued_at": "2026-03-01T13:55:00.514Z",
        "last_update": "2026-03-01T13:55:00.514Z",
        "modified_at": "2026-03-01T13:55:00.514Z",
        "remote_id": "text",
        "remote_url": "text",
        "source_id": "text",
        "uri": "text"
      },
      "id": "text",
      "internal": {
        "created_at_internal": "2026-03-01T13:55:00.514Z",
        "last_modified_internal": "2026-03-01T13:55:00.514Z"
      },
      "last_modified": "2026-03-01T13:55:00.514Z",
      "last_update": "2026-03-01T13:55:00.514Z",
      "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-01T13:55:00.514Z",
          "description": "text",
          "extras": {},
          "filesize": 1,
          "filetype": "file",
          "format": "text",
          "harvest": {
            "issued_at": "2026-03-01T13:55:00.514Z",
            "modified_at": "2026-03-01T13:55:00.514Z",
            "uri": "text"
          },
          "id": "text",
          "internal": {
            "created_at_internal": "2026-03-01T13:55:00.514Z",
            "last_modified_internal": "2026-03-01T13:55:00.514Z"
          },
          "last_modified": "2026-03-01T13:55:00.514Z",
          "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-01T13:55:00.514Z",
        "start": "2026-03-01T13:55:00.514Z"
      },
      "title": "text",
      "uri": "text"
    }
  ],
  "headline": "text",
  "id": "text",
  "image": "text",
  "image_thumbnail": "text",
  "image_url": "text",
  "kind": "news",
  "last_modified": "2026-03-01T13:55:00.514Z",
  "name": "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",
  "published": "2026-03-01T13:55:00.514Z",
  "reuses": [
    {
      "class": "text",
      "id": "text",
      "image": "text",
      "image_thumbnail": "text",
      "page": "text",
      "title": "text",
      "uri": "text"
    }
  ],
  "slug": "text",
  "tags": [
    "text"
  ],
  "uri": "text"
}

Delete a given post

delete

Paramètres de chemin

poststringRequis

The post ID or slug

Réponses

204

Object deleted

404

Object not found

delete

/posts/{post}/

HTTPcURLJavaScriptPython

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

Aucun contenu