Skip to main content

Update a specific Post

This endpoint updates a specific post

info

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

HTTP Request

PUT /api/v2/post/{id}/

Parameters

NameInTypeRequiredDescription
» textbodystringfalseThe content of the post in html format, it can contain some mentions
» categoriesbodylist(integer)trueList of Category ids
» mediasbodylist(integer)falseList of Media ids
» locationbodyobject¦nullfalseThe Location object to associate at the post
»» locationbodystring¦nulltrueLocation name
»» latbodynumber¦nulltrueLocation latitude
»» lngbodynumber¦nulltrueLocation longitude
» pollbodyobject¦nullfalseThe poll object to associate at the post
»» titlebodystringtruePoll title
»» multiple_choicesbodybooleanfalseIf poll choices can be multiple
»» expiration_atbodystring(date-time)falsePoll expiration datetime
»» choicesbodylist(object)truePoll choices objects
»»» choicebodystringtruePoll choice title
» addressingbodylist(integer)falseList of Tag ids

Example Body Parameters

{
"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

const inputBody = '{
"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/post/{id}/',
{
method: 'PUT',
body: inputBody,
headers: headers
})
.then(function(res) {
return res.json();
}).then(function(body) {
console.log(body);
});

Responses

StatusMeaningDescriptionSchema
200OKResponse status codePost

Example responses

{
"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": {Locality},
"addressing": ["integer"],
"tags": ["integer"],
"poll": {Poll}
}