Documentation Index
Fetch the complete documentation index at: https://docs.tellscope.io/llms.txt
Use this file to discover all available pages before exploring further.
API Overview
The Tellscope API is built on GraphQL, giving you the flexibility to request exactly the data you need. All requests are made to a single endpoint:
POST https://api.tellscope.io/graphql
Available Operations
Queries (Read)
| Operation | Description |
|---|
feedbackItems | List feedback with filters and pagination |
feedbackItem | Get a single feedback by ID |
contactItems | List contacts with search and pagination |
contactItem | Get a single contact by ID |
accountItems | List accounts with search and pagination |
accountItem | Get a single account by ID |
Mutations (Write)
| Operation | Description |
|---|
addFeedbackItem | Create new feedback |
removeFeedbackItem | Delete feedback by ID |
POST requests with a JSON body containing:
{
"query": "your GraphQL query or mutation",
"variables": { } // optional
}
{
"data": {
// your requested data
},
"errors": [
// any errors that occurred
]
}
Rate Limits
| Tier | Requests per minute |
|---|
| Free | 60 |
| Pro | 300 |
| Enterprise | Unlimited |
Rate limits are applied per API key. Contact support if you need higher limits.
Error Handling
The API returns standard GraphQL errors:
{
"errors": [
{
"message": "Invalid API key",
"extensions": {
"code": "UNAUTHENTICATED"
}
}
]
}
| Code | Description |
|---|
UNAUTHENTICATED | Invalid or missing API key |
FORBIDDEN | Valid key but no access to resource |
NOT_FOUND | Resource does not exist |
BAD_REQUEST | Invalid query or parameters |
