Skip to main content

Update a specific Status

This endpoint updates a specific status

info

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

HTTP Request

PUT /api/v2/status/{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 status.

NameInTypeRequiredDescription
» actionbodystring¦nulltrueThe action of the status
» textbodystringfalseThe content of the status 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 with the status
»» locationbodystring¦nulltrueLocation name
»» latbodynumber¦nulltrueLocation latitude
»» lngbodynumber¦nulltrueLocation Longitude
» addressingbodylist(integer)falseList of Tag ids

Example Body Parameters

{
"action": "string",
"text": "string",
"categories": ["integer"],
"medias": ["integer"],
"location": {
"location": "string",
"lat": "integer",
"lng": "integer"
},
"addressing": ["integer"],
"tags": ["integer"]
}

Example Request

const inputBody = '{
"action": "string",
"text": "string",
"categories": ["integer"],
"medias": ["integer"],
"location": {
"location": "string",
"lat": "integer",
"lng": "integer"
},
"addressing": ["integer"],
"tags": ["integer"]
}';
const headers = {
'Content-Type':'application/json',
'Accept':'application/json',
'Authorization': 'Bearer {access_token}'
};

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

Responses

StatusMeaningDescriptionSchema
200OKResponse status codeStatus

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"]
}