> ## 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.

# Introduction

> Overview of the Tellscope GraphQL API

## 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 |

## Request Format

All requests must be `POST` requests with a JSON body containing:

```json theme={null}
{
  "query": "your GraphQL query or mutation",
  "variables": { }  // optional
}
```

## Response Format

Responses follow the standard GraphQL format:

```json theme={null}
{
  "data": {
    // your requested data
  },
  "errors": [
    // any errors that occurred
  ]
}
```

## Rate Limits

| Tier       | Requests per minute |
| ---------- | ------------------- |
| Free       | 60                  |
| Pro        | 300                 |
| Enterprise | Unlimited           |

<Note>
  Rate limits are applied per API key. Contact support if you need higher limits.
</Note>

## Error Handling

The API returns standard GraphQL errors:

```json theme={null}
{
  "errors": [
    {
      "message": "Invalid API key",
      "extensions": {
        "code": "UNAUTHENTICATED"
      }
    }
  ]
}
```

Common error codes:

| 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         |