Update a specific Discussion

This endpoint updates a specific discussion.

info

This operation requires authentication. The logged user must be the discussion creator

HTTP Request

PUT /api/v2/discussion/{id}/

Parameters

info

By passing a category id that has parents defined, the system will automatically ascend the category graph based on the parents and will also automatically add the parents category ids to the discussion.

Name	In	Type	Required	Description
id	path	string	true	A unique integer value identifying this discussion
» title	body	string¦null	true	The title of the discussion
» text	body	string	false	The content of the discussion in html format, it can contain some mentions
» categories	body	list(integer)	true	List of id of Category
» medias	body	list(integer)	false	List of id of Media
» location	body	object¦null	false	The Location object to associate at the discussion
»» location	body	string¦null	true	The location name
»» lat	body	number¦null	true	The location latitude
»» lng	body	number¦null	true	The location longitude
» poll	body	object¦null	false	The poll object to associate at the discussion
»» title	body	string	true	The poll title
»» multiple_choices	body	boolean	false	If the poll has multiple choices
»» expiration_at	body	string(date-time)	false	Poll expiration datetime
»» choices	body	list(object)	true	Poll choices
»»» choice	body	string	true	Poll choice obj
» addressing	body	list(integer)	false	List of Tag ids

Example Body Parameters

JSON

{
    "title": "string",
    "text": "string",
    "categories": ["integer"],
    "medias": ["integer"],
    "location": {
      "location": "string",
      "lat": "integer",
      "lng": "integer"
    },
    "poll": {
      "title": "string",
      "multiple_choices": "boolean",
      "closed": "boolean",
      "expiration_at": "string",
      "choices": [
        {
          "choice": "string"
        }
      ]
    },
    "addressing": ["integer"],
    "tags": ["integer"]
}

Example Request

JavaScript

const inputBody = {
    "title": "string",
    "text": "string",
    "categories": ["integer"],
    "medias": ["integer"],
    "location": {
      "location": "string",
      "lat": "integer",
      "lng": "integer"
    },
    "poll": {
      "title": "string",
      "multiple_choices": "boolean",
      "closed": "boolean",
      "expiration_at": "string",
      "choices": [
        {
          "choice": "string"
        }
      ]
    },
    "addressing": ["integer"],
    "tags": ["integer"]
};
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'Authorization': 'Bearer {access_token}'
};

fetch('/api/v2/discussion/{id}/',
{
  method: 'PUT',
  body: inputBody,
  headers: headers
})
.then(function(res) {
    return res.json();
}).then(function(body) {
    console.log(body);
});

Bash

# You can also use wget
curl -X PUT /api/v2/discussion/{id}/ \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access_token}' \
  --data-raw '{
    "title": "string",
    "text": "string",
    "categories": ["integer"],
    "medias": ["integer"],
    "location": {
      "location": "string",
      "lat": "integer",
      "lng": "integer"
    },
    "poll": {
      "title": "string",
      "multiple_choices": "boolean",
      "closed": "boolean",
      "expiration_at": "string",
      "choices": [
        {
          "choice": "string"
        }
      ]
    },
    "addressing": ["integer"],
    "tags": ["integer"]
  }'

Responses

Status	Meaning	Description	Schema
200	OK	Response status code	Discussion

Example responses

200

{
  "id": "integer",
  "type": "string",
  "last_activity_at": "string",
  "author": {User},
  "added_at": "string",
  "last_edited_at": "string",
  "html": "string",
  "summary": "string",
  "deleted": "boolean",
  "collapsed": "boolean",
  "comment_count": "integer",
  "view_count": "integer",
  "vote_count": "integer",
  "reactions_count": [{Reaction}],
  "voted": "boolean",
  "reaction": {Reaction},
  "follower_count": "integer",
  "followed": "boolean",
  "suspended": "boolean",
  "flag_count": "integer",
  "share_count": "integer",
  "slug": "string",
  "categories": [{Category}],
  "medias": [{Media}],
  "location": "string",
  "addressing": ["integer"],
  "tags": ["integer"],
  "poll": {Poll},
  "title": "string"
}