Create a Discussion
This endpoint creates a discussion.
info
This operation requires authentication
HTTP Request
POST /api/v2/discussion/
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
» 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 (only one media of type share is allowed) |
» 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 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
- Bash
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/',
{
method: 'POST',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});
# You can also use wget
curl -X POST /api/v2/discussion/ \
-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 |
---|---|---|---|
201 | Created | 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"
}