APIThreads
Get thread
Fetch a thread by id. Use expand to inline messages and/or comments. Requires the threads:read scope.
GET
/threads/{id}curl -X GET "https://productlane.com/api/v2/threads/{id}" \
-H "Authorization: Bearer $PRODUCTLANE_API_KEY"Authorization
AuthorizationstringheaderrequiredBearer authentication header of the form
Bearer <token>, where<token>is your auth token.
Parameters
idstringpathrequiredexpandstringqueryComma-separated list of related resources to inline on the response. Allowed values:
messages(inlines the conversation),comments(inlines internal comments). Pass either one alone or both separated by a comma, e.g.messages,comments. Unknown values are ignored.
Response
application/json
Successful response
idstringrequirednumberinteger | nullrequiredTicket number shown to customers as
#123. Unique per workspace.created_atstringrequiredupdated_atstringrequiredtitlestring | nullrequiredtextstringrequiredpain_levelenum<string>requiredOne of:UNKNOWNLOWMEDIUMHIGHoriginstringrequiredcustom_channelstring | nullrequiredChannel name when
originiscustom, such aswhatsapp.statusenum<string>requiredOne of:opensnoozeddonetabenum<string>requiredOne of:opennewneeds-responsemysnoozeddonesnoozed_untilstring | nullrequiredlast_inbound_message_atstring | nullrequiredlast_outbound_message_atstring | nullrequiredlast_state_change_atstring | nullrequiredis_readbooleanrequiredcontactobject | nullrequiredcompanyobject | nullrequiredassigneeobject | nullrequiredreporterobject | nullrequiredtagsobject[]requiredcustomer_needsobject[]requiredexternal_idsstring[]requiredCaller-owned cross-system identifiers (CRM ids, etc.). Replaced wholesale on create/update.
integration_idsobjectrequiredai_draft_htmlstring | nullrequiredai_draft_sourcesany[] | nullrequiredai_draft_generated_atstring | nullrequiredai_draft_started_atstring | nullrequiredai_draft_error_atstring | nullrequiredmessagesany[]commentsobject[]
{
"id": "string",
"number": 0,
"created_at": "string",
"updated_at": "string",
"title": "string",
"text": "string",
"pain_level": "UNKNOWN",
"origin": "string",
"custom_channel": "string",
"status": "open",
"tab": "open",
"snoozed_until": "string",
"last_inbound_message_at": "string",
"last_outbound_message_at": "string",
"last_state_change_at": "string",
"is_read": true,
"contact": {
"id": "string",
"email": "string",
"name": "string",
"image_url": "string",
"company_id": "string",
"is_subscribed": true,
"external_ids": [
"string"
],
"integration_ids": {
"intercom": "string",
"front": "string",
"zendesk": "string",
"hubspot": "string",
"plain": "string",
"productboard": "string",
"slack_channel": "string"
},
"created_at": "string",
"updated_at": "string"
},
"company": {
"id": "string",
"name": "string",
"logo_url": "string",
"domains": [
"string"
],
"size": 0,
"revenue": 0,
"status_id": "string",
"status_name": "string",
"tier_id": "string",
"tier_name": "string",
"owner": {
"id": "string",
"name": "string",
"avatar_url": "string"
},
"external_ids": [
"string"
],
"integration_ids": {
"intercom": "string",
"front": "string",
"zendesk": "string",
"hubspot": "string",
"plain": "string",
"productboard": "string",
"slack_channel": "string"
},
"created_at": "string",
"updated_at": "string"
},
"assignee": {
"id": "string",
"name": "string",
"email": "string",
"image_url": "string"
},
"reporter": {
"id": "string",
"name": "string",
"email": "string",
"image_url": "string"
},
"tags": [
{
"id": "string",
"name": "string",
"color": "string",
"icon": "string",
"tag_group_id": "string",
"created_at": "string",
"updated_at": "string"
}
],
"customer_needs": [
{
"id": "string",
"thread_id": "string",
"project_id": "string",
"issue_id": "string",
"priority": 0,
"created_at": "string",
"updated_at": "string"
}
],
"external_ids": [
"string"
],
"integration_ids": {
"intercom": "string",
"front": "string",
"zendesk": "string",
"hubspot": "string",
"plain": "string",
"productboard": "string",
"slack_channel": "string"
},
"ai_draft_html": "string",
"ai_draft_sources": [
null
],
"ai_draft_generated_at": "string",
"ai_draft_started_at": "string",
"ai_draft_error_at": "string",
"messages": [
{
"id": "string",
"type": "email",
"created_at": "string",
"direction": "inbound",
"subject": "string",
"from": null,
"to": [
null
],
"cc": [
null
],
"bcc": [
null
],
"text": "string",
"html": "string",
"attachments": [
null
],
"thread_id": "string",
"user_id": "string"
}
],
"comments": [
{
"id": "string",
"created_at": "string",
"updated_at": "string",
"content": "string",
"attachments": [
null
],
"thread_id": "string",
"user_id": "string"
}
]
}