Add labels to a thread
Puts 1-10 of the inbox’s labels on the thread and keeps the ones it has. If any label is unknown, nothing changes (404). Answers every label on the thread afterwards; one inbox.thread.labels.updated event reports the request.
POST
/inboxes/{inbox_id}/threads/{thread_id}/labelsAutorización
AuthorizationToken Bearer · headerobligatorioA BillionSend API key (bs_…).
Parámetros de ruta
inbox_idstringobligatorioThe inbox ID or its email address, such as support@example.com
thread_idstring<uuid>obligatorioThe thread ID
Cuerpo de la solicitud
obligatorioapplication/jsonlabelsstring<uuid>[]obligatorio1-10 label IDs of the inbox
mín. 1 elementos · máx. 10 elementos
Respuestas
200
The labels on the thread
objectstringobligatorioValores permitidos:
listdataobject[]obligatorioEvery label on the thread after the change
Mostrar propiedadesOcultar propiedades
Array de
objectidstring<uuid>obligatorionamestringobligatoriocolorstringobligatorio401
Missing, malformed, unknown or revoked API key
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio404
Inbox, thread or label not found
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio422
Validation error
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio429
Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio