discussions

Discussion related operations

List all Discussions

get

Paramètres de requête

qstringOptionnel

The search query

sortstring · enumOptionnel

The field (and direction) on which sorting apply

Valeurs possibles:

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

pageintegerOptionnel

The page to fetch

page_sizeintegerOptionnel

The page size to fetch

Paramètres d'en-tête

X-Fieldsstring · maskOptionnel

An optional fields mask

Réponses

200

Success

application/json

next_pagestringOptionnel

The next page URL if exists

pageinteger · min: 1Requis

The current page

page_sizeintegerRequis

The page size used for pagination

previous_pagestringOptionnel

The previous page URL if exists

totalintegerRequis

The total paginated items

get

/discussions/

HTTPcURLJavaScriptPython

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

200

Success

{
  "data": [
    {
      "class": "text",
      "closed": "2026-02-24T22:17:20.140Z",
      "closed_by": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "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-02-24T22:17:20.140Z",
      "discussion": {
        "content": "text",
        "id": "text",
        "last_modified_at": "2026-02-24T22:17:20.140Z",
        "permissions": {
          "delete": true,
          "edit": true
        },
        "posted_by": {
          "class": "text",
          "id": "text",
          "avatar": "text",
          "avatar_thumbnail": "text",
          "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-02-24T22:17:20.140Z",
        "spam": {
          "status": "not_checked"
        }
      },
      "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",
      "spam": {
        "status": "not_checked"
      },
      "subject": {
        "class": "text",
        "id": "text"
      },
      "title": "text",
      "url": "text",
      "user": {
        "class": "text",
        "id": "text",
        "avatar": "text",
        "avatar_thumbnail": "text",
        "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

application/json

commentstringRequis

The content of the initial comment

extrasobjectOptionnel

Extras attributes as key-value pairs

titlestringRequis

The title of the discussion to open

Réponses

200

Success

application/json

classstringRequis

The object class

closedstring · date-timeOptionnel

The discussion closing date

createdstring · date-timeOptionnel

The discussion creation date

extrasobjectOptionnel

Extra attributes as key-value pairs

idstringOptionnel

The discussion identifier

self_web_urlstringOptionnel

The discussion web URL

titlestringOptionnel

The discussion title

urlstringOptionnel

The discussion API URI

post

/discussions/

HTTPcURLJavaScriptPython

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

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

200

Success

{
  "class": "text",
  "closed": "2026-02-24T22:17:20.140Z",
  "closed_by": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "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-02-24T22:17:20.140Z",
  "discussion": {
    "content": "text",
    "id": "text",
    "last_modified_at": "2026-02-24T22:17:20.140Z",
    "permissions": {
      "delete": true,
      "edit": true
    },
    "posted_by": {
      "class": "text",
      "id": "text",
      "avatar": "text",
      "avatar_thumbnail": "text",
      "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-02-24T22:17:20.140Z",
    "spam": {
      "status": "not_checked"
    }
  },
  "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",
  "spam": {
    "status": "not_checked"
  },
  "subject": {
    "class": "text",
    "id": "text"
  },
  "title": "text",
  "url": "text",
  "user": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "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

classstringRequis

The object class

closedstring · date-timeOptionnel

The discussion closing date

createdstring · date-timeOptionnel

The discussion creation date

extrasobjectOptionnel

Extra attributes as key-value pairs

idstringOptionnel

The discussion identifier

self_web_urlstringOptionnel

The discussion web URL

titlestringOptionnel

The discussion title

urlstringOptionnel

The discussion API URI

get

/discussions/{id}/

HTTPcURLJavaScriptPython

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

200

Success

{
  "class": "text",
  "closed": "2026-02-24T22:17:20.140Z",
  "closed_by": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "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-02-24T22:17:20.140Z",
  "discussion": {
    "content": "text",
    "id": "text",
    "last_modified_at": "2026-02-24T22:17:20.140Z",
    "permissions": {
      "delete": true,
      "edit": true
    },
    "posted_by": {
      "class": "text",
      "id": "text",
      "avatar": "text",
      "avatar_thumbnail": "text",
      "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-02-24T22:17:20.140Z",
    "spam": {
      "status": "not_checked"
    }
  },
  "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",
  "spam": {
    "status": "not_checked"
  },
  "subject": {
    "class": "text",
    "id": "text"
  },
  "title": "text",
  "url": "text",
  "user": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "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

application/json

closebooleanOptionnel

Is this a closing response. Only subject owner can close

commentstringRequis

The comment to submit

Réponses

200

Success

application/json

classstringRequis

The object class

closedstring · date-timeOptionnel

The discussion closing date

createdstring · date-timeOptionnel

The discussion creation date

extrasobjectOptionnel

Extra attributes as key-value pairs

idstringOptionnel

The discussion identifier

self_web_urlstringOptionnel

The discussion web URL

titlestringOptionnel

The discussion title

urlstringOptionnel

The discussion API URI

403

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

post

/discussions/{id}/

HTTPcURLJavaScriptPython

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

{
  "close": true,
  "comment": "text"
}

{
  "class": "text",
  "closed": "2026-02-24T22:17:20.140Z",
  "closed_by": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "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-02-24T22:17:20.140Z",
  "discussion": {
    "content": "text",
    "id": "text",
    "last_modified_at": "2026-02-24T22:17:20.140Z",
    "permissions": {
      "delete": true,
      "edit": true
    },
    "posted_by": {
      "class": "text",
      "id": "text",
      "avatar": "text",
      "avatar_thumbnail": "text",
      "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-02-24T22:17:20.140Z",
    "spam": {
      "status": "not_checked"
    }
  },
  "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",
  "spam": {
    "status": "not_checked"
  },
  "subject": {
    "class": "text",
    "id": "text"
  },
  "title": "text",
  "url": "text",
  "user": {
    "class": "text",
    "id": "text",
    "avatar": "text",
    "avatar_thumbnail": "text",
    "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

delete

/discussions/{id}/

HTTPcURLJavaScriptPython

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

403

Not allowed to delete this discussion

Aucun contenu