Set a thread's labels
Replaces the thread’s labels with exactly these (up to 100; [] takes them all off). The labels stay in the inbox. If any label is unknown, nothing changes (404). Answers every label on the thread afterwards.
PUT
/inboxes/{inbox_id}/threads/{thread_id}/labelsAutorização
AuthorizationToken Bearer · headerobrigatórioA BillionSend API key (bs_…).
Parâmetros de caminho
inbox_idstringobrigatórioThe inbox ID or its email address, such as support@example.com
thread_idstring<uuid>obrigatórioThe thread ID
Corpo da requisição
obrigatórioapplication/jsonlabelsstring<uuid>[]obrigatórioUp to 100 label IDs of the inbox: exactly the labels the thread ends up with
máx. 100 itens
Respostas
200
The labels on the thread
objectstringobrigatórioValores permitidos:
listdataobject[]obrigatórioEvery label on the thread after the change
Mostrar propriedadesOcultar propriedades
Array de
objectidstring<uuid>obrigatórionamestringobrigatóriocolorstringobrigatório401
Missing, malformed, unknown or revoked API key
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório404
Inbox, thread or label not found
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório422
Validation error
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobrigatórionamestringobrigatóriomessagestringobrigatório