Skip to main content
GET
/
insights
/
{id}
Get thread
curl --request GET \
  --url https://productlane.com/api/v1/insights/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "isDeleted": true,
  "showRecordCall": true,
  "lastInboundMessageAt": "2023-11-07T05:31:56Z",
  "lastOutboundMessageAt": "2023-11-07T05:31:56Z",
  "lastStateChangeAt": "2023-11-07T05:31:56Z",
  "text": "<string>",
  "painLevel": "<string>",
  "state": "<string>",
  "origin": "<string>",
  "title": "<string>",
  "snoozedUntil": "<string>",
  "workspaceId": "<string>",
  "contactId": "<string>",
  "companyId": "<string>",
  "reporterId": "<string>",
  "assigneeId": "<string>",
  "attachments": [
    "<any>"
  ],
  "recordingId": "<string>",
  "videoId": "<string>",
  "slackChannelId": "<string>",
  "linearAttachmentId": "<string>",
  "intercomId": "<string>",
  "frontId": "<string>",
  "zendeskId": "<string>",
  "hubspotId": "<string>",
  "plainId": "<string>",
  "productboardId": "<string>",
  "slackReplyId": "<string>",
  "uniqueId": "<string>",
  "customerNeeds": [
    {
      "id": "<string>",
      "feedbackId": "<string>",
      "issueId": "<string>",
      "projectId": "<string>",
      "linearCustomerNeedId": "<string>",
      "priority": 123,
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "contact": {
    "id": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "isDeleted": true,
    "version": 123,
    "email": "<string>",
    "name": "<string>",
    "imageUrl": "<string>",
    "workspaceId": "<string>",
    "intercomId": "<string>",
    "hubspotId": "<string>",
    "productboardId": "<string>",
    "companyId": "<string>",
    "zendeskId": "<string>"
  },
  "company": {
    "id": "<string>",
    "name": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "updatedAt": "2023-11-07T05:31:56Z",
    "isDeleted": true,
    "version": 123,
    "linearCustomerId": "<string>",
    "size": "<string>",
    "revenue": "<string>",
    "statusId": "<string>",
    "statusName": "<string>",
    "statusColor": "<string>",
    "tierId": "<string>",
    "tierName": "<string>",
    "logoUrl": "<string>",
    "domains": [
      "<string>"
    ],
    "autoAdd": true,
    "workspaceId": "<string>",
    "intercomId": "<string>",
    "hubspotId": "<string>",
    "productboardId": "<string>",
    "customerId": "<string>",
    "domain": "<string>"
  },
  "assignee": {
    "id": "<string>",
    "name": "<string>",
    "email": "<string>",
    "role": "<string>",
    "imageUrl": "<string>",
    "selectedTeamIds": [
      "<any>"
    ]
  },
  "conversation": [
    {
      "id": "<string>",
      "timestamp": "2023-11-07T05:31:56Z",
      "type": "<string>",
      "data": {
        "id": "<string>",
        "createdAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "date": "2023-11-07T05:31:56Z",
        "isDeleted": true,
        "type": "<string>",
        "subject": "<string>",
        "originalRecipient": "<string>",
        "from": {
          "name": "<string>",
          "email": "<string>",
          "mailboxHash": "<string>"
        },
        "to": [
          {
            "name": "<string>",
            "email": "<string>",
            "mailboxHash": "<string>"
          }
        ],
        "cc": [
          "<any>"
        ],
        "bcc": [
          "<any>"
        ],
        "attachments": [
          "<any>"
        ],
        "textContent": "<string>",
        "htmlContent": "<string>",
        "postmarkMessageId": "<string>",
        "messageId": "<string>",
        "uniqueId": "<string>",
        "threadId": "<string>",
        "workspaceId": "<string>",
        "userId": "<string>"
      }
    }
  ]
}

​
Get Thread

Retrieve a specific thread by its ID.

​
Path Parameters

​
id
string
required
Unique identifier of the thread

​
Response

​
id
string
Unique identifier for the thread
​
text
string
Thread content
​
title
string
Thread title
​
painLevel
string
Pain level of the thread
​
origin
string
Source of the thread
​
contactEmail
string
Email of the contact who provided the thread
​
contactName
string
Name of the contact who provided the thread
​
projectId
string
ID of the related project
​
issueId
string
ID of the related issue
​
state
string
Current state of the thread
​
createdAt
string
Timestamp when the thread was created
​
updatedAt
string
Timestamp when the thread was last updated
​
workspaceId
string
ID of the workspace this thread belongs to

​
Example Request

GET /api/v1/insights/insight_123456789

​
Example Response

{
  "id": "insight_123456789",
  "createdAt": "2024-01-15T10:30:00Z",
  "updatedAt": "2024-01-15T16:35:00Z",
  "isDeleted": false,
  "showRecordCall": false,
  "lastInboundMessageAt": "2024-01-15T14:22:00Z",
  "lastOutboundMessageAt": "2024-01-15T15:21:00Z",
  "lastStateChangeAt": "2024-01-15T15:30:00Z",
  "text": "<p>The current dashboard is too cluttered and hard to navigate. Users are struggling to find the most important metrics.</p>",
  "painLevel": "HIGH",
  "state": "PROCESSED",
  "origin": "EMAIL",
  "title": "Dashboard Navigation Issues",
  "snoozedUntil": null,
  "workspaceId": "ws_123456789",
  "contactId": "contact_123456789",
  "companyId": "company_123456789",
  "reporterId": null,
  "assigneeId": "user_123456789",
  "attachments": [],
  "recordingId": null,
  "videoId": null,
  "slackChannelId": null,
  "linearAttachmentId": null,
  "intercomId": null,
  "frontId": null,
  "zendeskId": null,
  "hubspotId": null,
  "plainId": null,
  "productboardId": null,
  "slackReplyId": null,
  "uniqueId": "abc123def456ghi789",
  "customerNeeds": [
    {
      "id": "customer_need_123",
      "feedbackId": "insight_123456789",
      "issueId": "issue_123",
      "projectId": null,
      "linearCustomerNeedId": "linear_need_123",
      "priority": 0,
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T10:30:00Z"
    }
  ],
  "contact": {
    "id": "contact_123456789",
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-01-15T10:30:00Z",
    "isDeleted": false,
    "version": 1,
    "email": "john@acme.com",
    "name": "John Doe",
    "imageUrl": "https://www.gravatar.com/avatar/example?d=404",
    "workspaceId": "ws_123456789",
    "intercomId": null,
    "hubspotId": null,
    "productboardId": null,
    "companyId": "company_123456789",
    "zendeskId": null
  },
  "company": {
    "id": "company_123456789",
    "name": "Acme Corporation",
    "createdAt": "2024-01-10T08:00:00Z",
    "updatedAt": "2024-01-15T14:22:00Z",
    "isDeleted": false,
    "version": 2,
    "linearCustomerId": "linear_customer_123",
    "size": null,
    "revenue": null,
    "statusId": "status_123",
    "statusName": "Active",
    "statusColor": "#5E6AD2",
    "tierId": null,
    "tierName": null,
    "logoUrl": "https://example.com/logo.png",
    "domains": ["acme.com"],
    "autoAdd": false,
    "workspaceId": "ws_123456789",
    "intercomId": null,
    "hubspotId": null,
    "productboardId": null,
    "customerId": null,
    "domain": null
  },
  "assignee": {
    "id": "user_123456789",
    "name": "Jane Smith",
    "email": "jane@example.com",
    "role": "ADMIN",
    "imageUrl": "https://example.com/avatar.jpg",
    "selectedTeamIds": []
  },
  "conversation": [
    {
      "id": "message_123456789",
      "timestamp": "2024-01-15T10:30:00Z",
      "type": "email",
      "data": {
        "id": "message_123456789",
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-15T10:30:00Z",
        "date": "2024-01-15T10:30:00Z",
        "isDeleted": false,
        "type": "INBOUND",
        "subject": "Dashboard Navigation Issues",
        "originalRecipient": "support@example.com",
        "from": {
          "name": "John Doe",
          "email": "john@acme.com",
          "mailboxHash": ""
        },
        "to": [
          {
            "name": "Support Team",
            "email": "support@example.com",
            "mailboxHash": ""
          }
        ],
        "cc": [],
        "bcc": [],
        "attachments": [],
        "textContent": "The current dashboard is too cluttered and hard to navigate. Users are struggling to find the most important metrics.",
        "htmlContent": "<p>The current dashboard is too cluttered and hard to navigate. Users are struggling to find the most important metrics.</p>",
        "postmarkMessageId": "postmark_123456789",
        "messageId": "<message_123456789@example.com>",
        "uniqueId": null,
        "threadId": "insight_123456789",
        "workspaceId": "ws_123456789",
        "userId": null
      }
    },
    {
      "id": "message_987654321",
      "timestamp": "2024-01-15T15:21:00Z",
      "type": "email",
      "data": {
        "id": "message_987654321",
        "createdAt": "2024-01-15T15:21:00Z",
        "updatedAt": "2024-01-15T15:21:00Z",
        "date": "2024-01-15T15:21:00Z",
        "isDeleted": false,
        "type": "OUTBOUND",
        "subject": "Re: Dashboard Navigation Issues",
        "originalRecipient": "john@acme.com",
        "from": {
          "name": "Jane Smith (Example)",
          "email": "support@example.com",
          "mailboxHash": ""
        },
        "to": [
          {
            "name": "John Doe",
            "email": "john@acme.com",
            "mailboxHash": ""
          }
        ],
        "cc": [],
        "bcc": [],
        "attachments": [],
        "textContent": "Thank you for your feedback. We're working on improving the dashboard navigation. Please see our roadmap for upcoming changes.",
        "htmlContent": "<p>Thank you for your feedback. We're working on improving the dashboard navigation. Please see our roadmap for upcoming changes.</p>",
        "postmarkMessageId": "postmark_987654321",
        "messageId": "<message_987654321@example.com>",
        "uniqueId": null,
        "threadId": "insight_123456789",
        "workspaceId": "ws_123456789",
        "userId": "user_123456789"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Query Parameters

​
includeConversation
enum<string>

Include conversation history (emails, Slack messages, live chat messages, and comments) merged into a single chronological array

Available options:
true,
false

Response

Successful response

​
id
string
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
isDeleted
boolean
required
​
showRecordCall
boolean
required
​
lastInboundMessageAt
string<date-time>
required
​
lastOutboundMessageAt
string<date-time>
required
​
lastStateChangeAt
string<date-time>
required
​
text
string
required
​
painLevel
string
required
​
state
string
required
​
origin
string
required
​
title
string
required
​
workspaceId
string
required
​
contactId
string
required
​
companyId
string
required
​
assigneeId
string
required
​
attachments
any[]
required
​
uniqueId
string
required
​
customerNeeds
object[]
required
​
contact
object
required
​
company
object
required
​
assignee
object
required
​
conversation
object[]
required
​
snoozedUntil
string | null
​
reporterId
string | null
​
recordingId
string | null
​
videoId
string | null
​
slackChannelId
string | null
​
linearAttachmentId
string | null
​
intercomId
string | null
​
frontId
string | null
​
zendeskId
string | null
​
hubspotId
string | null
​
plainId
string | null
​
productboardId
string | null
​
slackReplyId
string | null