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.
Name | In | Type | Required | Description |
---|---|---|---|---|
» action | body | string¦null | true | The action of the status |
» text | body | string | false | The content of the status in html format, it can contain some mentions |
» categories | body | list(integer) | true | List of Category ids |
» medias | body | list(integer) | false | List of Media ids |
» location | body | object¦null | false | The Location object to associate with the status |
»» location | body | string¦null | true | Location name |
»» lat | body | number¦null | true | Location latitude |
»» lng | body | number¦null | true | Location Longitude |
» addressing | body | list(integer) | false | List of Tag ids |
Example Body Parameters
- JSON
{
"action": "string",
"text": "string",
"categories": ["integer"],
"medias": ["integer"],
"location": {
"location": "string",
"lat": "integer",
"lng": "integer"
},
"addressing": ["integer"],
"tags": ["integer"]
}
Example Request
- JavaScript
- Bash
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);
});
# You can also use wget
curl -X PUT /api/v2/status/{id}/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access_token}' \
--data-raw '{
"action": "string",
"text": "string",
"categories": ["integer"],
"medias": ["integer"],
"location": {
"location": "string",
"lat": "integer",
"lng": "integer"
},
"addressing": ["integer"],
"tags": ["integer"]
}'
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | Response status code | Status |
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": {Locality},
"addressing": ["integer"],
"tags": ["integer"]
}