Skip to main content

Query

query {
  feedbackItem(
    apiKey: String!
    id: String!
  ): FeedbackItem
}

Parameters

apiKey
string
required
Your Tellscope API key
id
string
required
The unique identifier of the feedback item

Response

Returns a single FeedbackItem or null if not found.
id
string
Unique identifier
source
string
Source platform (e.g., zendesk, intercom)
title
string
Feedback title
content
string
Full feedback content
author
string
Author name
email
string
Author email address
sentiment
string
Detected sentiment (positive, neutral, negative)
status
string
Current status (unread, read, archived)
metadata
object
Additional metadata from source
publishedDate
datetime
Original publication date
createdAt
datetime
Record creation timestamp

Example

query {
  feedbackItem(
    apiKey: "tellscp_sk_YOUR_API_KEY"
    id: "clx789ghi"
  ) {
    id
    title
    content
    author
    email
    sentiment
    source
    status
    metadata
    publishedDate
    createdAt
  }
}

Error Responses

If the feedback doesn’t exist or you don’t have access:
{
  "data": {
    "feedbackItem": null
  }
}
If accessing feedback from another organization:
{
  "errors": [
    {
      "message": "Not authorized to access this feedback",
      "extensions": {
        "code": "FORBIDDEN"
      }
    }
  ]
}