v1Recursos/Social Inbox/postTag an inbox item
Tag an inbox item
Adds and removes tags on one item. Name tags by id or by name, as listed by the tags endpoint. A tag that does not exist is refused by name, because new tags are created in the app, and an archived tag cannot be added.
post
inbox:write/api/v1/inbox/{kind}/{id}/tagsParâmetros de consulta
kindstring (comment | message | mention)obrigatório
The kind of item: a comment, a direct message conversation or a mention.
idstringobrigatório
The item's id, from the inbox list.
Corpo da solicitação
addarray of stringopcional
Tags to add, by id or name.
removearray of stringopcional
Tags to remove, by id or name.
Resposta
dataobjectopcional
okbooleanopcional
True when the tags were changed.
addedarray of stringopcional
The names of the tags that were added.
removedarray of stringopcional
The names of the tags that were removed.
Erros
400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.
401Chave de API ausente, inválida, expirada ou revogada.
403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.
404O recurso não foi encontrado, ou não pertence à sua agência.
429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.
post/api/v1/inbox/{kind}/{id}/tags
Sua chave de API
kind *
id *
Corpo da solicitação
{
"data": {
"ok": true,
"added": [
"VIP"
],
"removed": []
}
}