discussions

Discussion related operations

List all Discussions

get

Paramètres de requête

pageintegerOptionnel

The page to fetch

page_sizeintegerOptionnel

The page size to fetch

sortstring · enumOptionnel

The field (and direction) on which sorting apply

Valeurs possibles:

qstringOptionnel

The search query

closedbooleanOptionnel

Filters discussions on their closed status if specified

forstring[]Optionnel

Filter discussions for a given subject

orgstringOptionnel

Filter discussions for a given organization

userstringOptionnel

Filter discussions created by a user

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/discussions/

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

200

Success

{
  "data": [
    {
      "closed": "2026-01-01T00:00:00.000Z",
      "closed_by": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "deleted": "2026-01-01T00:00:00.000Z",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "closed_by_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"
      },
      "created": "2026-01-01T00:00:00.000Z",
      "discussion": [
        {
          "content": "text",
          "id": "text",
          "last_modified_at": "2026-01-01T00:00:00.000Z",
          "permissions": {
            "delete": true,
            "edit": true
          },
          "posted_by": {
            "class": "text",
            "id": "text",
            "avatar": "text",
            "avatar_thumbnail": "text",
            "deleted": "2026-01-01T00:00:00.000Z",
            "first_name": "text",
            "last_name": "text",
            "page": "text",
            "slug": "text",
            "uri": "text"
          },
          "posted_by_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"
          },
          "posted_on": "2026-01-01T00:00:00.000Z"
        }
      ],
      "extras": {},
      "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"
      },
      "permissions": {
        "close": true,
        "delete": true,
        "edit": true
      },
      "self_web_url": "text",
      "subject": {
        "class": "text",
        "id": "text"
      },
      "title": "text",
      "url": "text",
      "user": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "deleted": "2026-01-01T00:00:00.000Z",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      }
    }
  ],
  "next_page": "text",
  "page": 1,
  "page_size": 1,
  "previous_page": "text",
  "total": 1
}

Create a new Discussion

post

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

commentstringRequis

The content of the initial comment

extrasobjectOptionnel

Extras attributes as key-value pairs

titlestringRequis

The title of the discussion to open

Réponses

201

Success

application/json

closedstring · date-timeLecture seuleOptionnel

The discussion closing date

createdstring · date-timeLecture seuleRequis

The discussion creation date

extrasobjectOptionnel

Extra attributes as key-value pairs

idstringLecture seuleRequis

self_web_urlstringLecture seuleOptionnel

The discussion web URL

titlestringRequis

The discussion title

urlstringLecture seuleOptionnel

The discussion API URI

post/discussions/

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

{
  "comment": "text",
  "extras": {},
  "organization": {
    "class": "text",
    "id": "text",
    "acronym": "text",
    "name": "text"
  },
  "subject": {
    "class": "text",
    "id": "text"
  },
  "title": "text"
}

201

Success

{
  "closed": "2026-01-01T00:00:00.000Z",
  "closed_by": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "deleted": "2026-01-01T00:00:00.000Z",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  },
  "closed_by_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"
  },
  "created": "2026-01-01T00:00:00.000Z",
  "discussion": [
    {
      "content": "text",
      "id": "text",
      "last_modified_at": "2026-01-01T00:00:00.000Z",
      "permissions": {
        "delete": true,
        "edit": true
      },
      "posted_by": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "deleted": "2026-01-01T00:00:00.000Z",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "posted_by_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"
      },
      "posted_on": "2026-01-01T00:00:00.000Z"
    }
  ],
  "extras": {},
  "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"
  },
  "permissions": {
    "close": true,
    "delete": true,
    "edit": true
  },
  "self_web_url": "text",
  "subject": {
    "class": "text",
    "id": "text"
  },
  "title": "text",
  "url": "text",
  "user": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "deleted": "2026-01-01T00:00:00.000Z",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  }
}

Get a discussion given its ID

get

Paramètres de chemin

idstringRequis

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

closedstring · date-timeLecture seuleOptionnel

The discussion closing date

createdstring · date-timeLecture seuleRequis

The discussion creation date

extrasobjectOptionnel

Extra attributes as key-value pairs

idstringLecture seuleRequis

self_web_urlstringLecture seuleOptionnel

The discussion web URL

titlestringRequis

The discussion title

urlstringLecture seuleOptionnel

The discussion API URI

get/discussions/{id}/

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

200

Success

{
  "closed": "2026-01-01T00:00:00.000Z",
  "closed_by": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "deleted": "2026-01-01T00:00:00.000Z",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  },
  "closed_by_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"
  },
  "created": "2026-01-01T00:00:00.000Z",
  "discussion": [
    {
      "content": "text",
      "id": "text",
      "last_modified_at": "2026-01-01T00:00:00.000Z",
      "permissions": {
        "delete": true,
        "edit": true
      },
      "posted_by": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "deleted": "2026-01-01T00:00:00.000Z",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "posted_by_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"
      },
      "posted_on": "2026-01-01T00:00:00.000Z"
    }
  ],
  "extras": {},
  "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"
  },
  "permissions": {
    "close": true,
    "delete": true,
    "edit": true
  },
  "self_web_url": "text",
  "subject": {
    "class": "text",
    "id": "text"
  },
  "title": "text",
  "url": "text",
  "user": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "deleted": "2026-01-01T00:00:00.000Z",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  }
}

Add comment and optionally close a discussion given its ID

post

Paramètres de chemin

idstringRequis

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Corps

closebooleanOptionnel

Is this a closing response. Only subject owner can close

commentstringRequis

The comment to submit

Réponses

200

Success

application/json

closedstring · date-timeLecture seuleOptionnel

The discussion closing date

createdstring · date-timeLecture seuleRequis

The discussion creation date

extrasobjectOptionnel

Extra attributes as key-value pairs

idstringLecture seuleRequis

self_web_urlstringLecture seuleOptionnel

The discussion web URL

titlestringRequis

The discussion title

urlstringLecture seuleOptionnel

The discussion API URI

403

Not allowed to close this discussion OR can't add comments on a closed discussion

post/discussions/{id}/

POST /api/1/discussions/{id}/ HTTP/1.1
Host: www.data.gouv.fr
Content-Type: application/json
Accept: */*
Content-Length: 106

{
  "close": true,
  "comment": "text",
  "organization": {
    "class": "text",
    "id": "text",
    "acronym": "text",
    "name": "text"
  }
}

{
  "closed": "2026-01-01T00:00:00.000Z",
  "closed_by": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "deleted": "2026-01-01T00:00:00.000Z",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  },
  "closed_by_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"
  },
  "created": "2026-01-01T00:00:00.000Z",
  "discussion": [
    {
      "content": "text",
      "id": "text",
      "last_modified_at": "2026-01-01T00:00:00.000Z",
      "permissions": {
        "delete": true,
        "edit": true
      },
      "posted_by": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "deleted": "2026-01-01T00:00:00.000Z",
        "first_name": "text",
        "last_name": "text",
        "page": "text",
        "slug": "text",
        "uri": "text"
      },
      "posted_by_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"
      },
      "posted_on": "2026-01-01T00:00:00.000Z"
    }
  ],
  "extras": {},
  "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"
  },
  "permissions": {
    "close": true,
    "delete": true,
    "edit": true
  },
  "self_web_url": "text",
  "subject": {
    "class": "text",
    "id": "text"
  },
  "title": "text",
  "url": "text",
  "user": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "deleted": "2026-01-01T00:00:00.000Z",
    "first_name": "text",
    "last_name": "text",
    "page": "text",
    "slug": "text",
    "uri": "text"
  }
}

Delete a discussion given its ID

delete

Paramètres de chemin

idstringRequis

Paramètres de requête

send_legal_noticebooleanOptionnel

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

Réponses

403

Not allowed to delete this discussion

Aucun contenu

delete/discussions/{id}/

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

403

Not allowed to delete this discussion

Aucun contenu

Delete a comment given its index or UUID

delete

Paramètres de chemin

idstringRequis

cidxstringRequis

Paramètres de requête

send_legal_noticebooleanOptionnel

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

Réponses

403

Not allowed to delete this comment

Aucun contenu

delete/discussions/{id}/comments/{cidx}

DELETE /api/1/discussions/{id}/comments/{cidx} HTTP/1.1
Host: www.data.gouv.fr
Accept: */*

403

Not allowed to delete this comment

Aucun contenu