Skip to main content
GET
/
insights
List threads
curl --request GET \
  --url https://productlane.com/api/v1/insights \
  --header 'Authorization: Bearer <token>'
{
  "insights": [
    {
      "id": "<string>",
      "title": "<string>",
      "text": "<string>",
      "painLevel": "<string>",
      "origin": "<string>",
      "state": "<string>",
      "uniqueId": "<string>",
      "workspaceId": "<string>",
      "assignee": "<string>",
      "reporter": "<string>",
      "contact": "<string>",
      "snoozedUntil": "<string>",
      "zendeskId": "<string>",
      "productboardId": "<string>",
      "slackChannelId": "<string>",
      "slackReplyId": "<string>",
      "linearAttachmentId": "<string>",
      "lastInboundMessageAt": "<string>",
      "lastOutboundMessageAt": "<string>",
      "lastStateChangeAt": "<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": "<string>",
        "workspaceId": "<string>",
        "intercomId": "<string>",
        "hubspotId": "<string>",
        "productboardId": "<string>",
        "customerId": "<string>",
        "domain": "<string>"
      },
      "linkedProjects": [
        "<any>"
      ],
      "linkedIssues": [
        "<any>"
      ],
      "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"
        }
      ]
    }
  ],
  "total": 123
}

​
List Insights

List all insights (threads) for your workspace with optional filtering and pagination. You can filter by state, issueId, or projectId.

​
Query Parameters

​
skip
number
Number of insights to skip for pagination (default: 0)
​
take
number
Number of insights to return (default: 100)
​
state
string
Filter insights by state
​
issueId
string
Filter insights by issue ID
​
projectId
string
Filter insights by project ID

​
Response

​
insights
object[]
Array of thread objects
​
insights[].id
string
Unique identifier for the thread
​
insights[].text
string
Thread content
​
insights[].title
string
Thread title
​
insights[].painLevel
string
Pain level of the thread
​
insights[].origin
string
Source of the thread
​
insights[].contactEmail
string
Email of the contact who provided the thread
​
insights[].contactName
string
Name of the contact who provided the thread
​
insights[].projectId
string
ID of the related project
​
insights[].issueId
string
ID of the related issue
​
insights[].state
string
Current state of the thread
​
insights[].createdAt
string
Timestamp when the thread was created
​
insights[].updatedAt
string
Timestamp when the thread was last updated
​
insights[].workspaceId
string
ID of the workspace this thread belongs to
​
total
integer
Total number of insights matching the filters

​
Example Request

GET /api/v1/insights?skip=0&take=10&state=NEW&projectId=proj_123

​
Example Response

{
  "insights": [
    {
      "id": "insight_123456789",
      "title": "Dashboard Navigation Issues",
      "text": "The current dashboard is too cluttered and hard to navigate. It would be great if we could customize the layout.",
      "painLevel": "HIGH",
      "origin": "API",
      "state": "PROCESSED",
      "uniqueId": "abc123def456ghi789",
      "workspaceId": "ws_123456789",
      "assignee": null,
      "reporter": null,
      "contact": null,
      "snoozedUntil": null,
      "zendeskId": null,
      "productboardId": null,
      "slackChannelId": null,
      "slackReplyId": null,
      "linearAttachmentId": null,
      "lastInboundMessageAt": null,
      "lastOutboundMessageAt": null,
      "lastStateChangeAt": null,
      "company": {
        "id": "company_123456789",
        "name": "Acme Corporation",
        "createdAt": "2024-01-15T10:30:00Z",
        "updatedAt": "2024-01-20T14:22:00Z",
        "isDeleted": false,
        "version": 1,
        "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": null,
        "workspaceId": "ws_123456789",
        "intercomId": null,
        "hubspotId": null,
        "productboardId": null,
        "customerId": null,
        "domain": null
      },
      "linkedProjects": [],
      "linkedIssues": [],
      "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"
        }
      ]
    },
    {
      "id": "insight_987654321",
      "title": "Feature Request: Dark Mode",
      "text": "It would be great to have a dark mode option for the application. Many users prefer dark themes.",
      "painLevel": "UNKNOWN",
      "origin": "API",
      "state": "NEW",
      "uniqueId": "xyz789abc123def456",
      "workspaceId": "ws_123456789",
      "assignee": null,
      "reporter": null,
      "contact": null,
      "snoozedUntil": null,
      "zendeskId": null,
      "productboardId": null,
      "slackChannelId": null,
      "slackReplyId": null,
      "linearAttachmentId": null,
      "lastInboundMessageAt": null,
      "lastOutboundMessageAt": null,
      "lastStateChangeAt": null,
      "company": {
        "id": "company_987654321",
        "name": "Tech Startup Inc",
        "createdAt": "2024-01-10T08:00:00Z",
        "updatedAt": "2024-01-18T16:45:00Z",
        "isDeleted": false,
        "version": 1,
        "linearCustomerId": "linear_customer_456",
        "size": null,
        "revenue": null,
        "statusId": "status_456",
        "statusName": "Active",
        "statusColor": "#5E6AD2",
        "tierId": null,
        "tierName": null,
        "logoUrl": "https://example.com/logo2.png",
        "domains": ["techstartup.com"],
        "autoAdd": null,
        "workspaceId": "ws_123456789",
        "intercomId": null,
        "hubspotId": null,
        "productboardId": null,
        "customerId": null,
        "domain": null
      },
      "linkedProjects": [],
      "linkedIssues": [],
      "customerNeeds": [
        {
          "id": "customer_need_456",
          "feedbackId": "insight_987654321",
          "issueId": null,
          "projectId": "project_123",
          "linearCustomerNeedId": "linear_need_456",
          "priority": 1,
          "createdAt": "2024-01-15T11:00:00Z",
          "updatedAt": "2024-01-15T11:00:00Z"
        }
      ]
    }
  ],
  "total": 2
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
skip
number
​
take
number
​
state
enum<string>
Available options:
NEW,
PROCESSED,
COMPLETED,
SNOOZED,
UNSNOOZED
​
issueId
string
​
projectId
string

Response

Successful response

​
insights
object[]
required
​
total
integer
required