# Tellescope API

**Canonical:** https://apis.io/apis/tellescope/tellescope-api/  
**Provider:** Tellescope — https://apis.io/providers/tellescope/  
**Base URL:** https://api.tellescope.com  
**Documentation:** https://docs.tellescope.com/api-documentation

Tellescope API is one of 2 APIs that [Tellescope](https://apis.io/providers/tellescope/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Tellescope API as documented publicly: 96 operations. Contract generated from the documentation by API Evangelist (2026-11-15); not the provider's own document.

## Operations (60 of 96)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/ai-conversation` | Creates a new AiConversation. |
| GET | `/v1/ai-conversation/{id}` | Get an AiConversation. |
| PATCH | `/v1/ai-conversation/{id}` | Updates AiConversation fields. |
| GET | `/v1/ai-conversations` | Get a page of AiConversations. |
| POST | `/v1/ai-conversations/agent-message` | Sends an Anthropic-shaped transcript to the configured model with native tool use and prompt caching, and records the turn against an ai_conversation. |
| POST | `/v1/ai-conversations/generate-ai-decision` | Generates a decision from the AI conversation and continues in Journey. |
| POST | `/v1/ai-conversations/send-message` | Sends a message to the AI conversation. |
| POST | `/v1/ai-document` | Creates a new AiDocument. |
| GET | `/v1/ai-document-version/{id}` | Get an AiDocumentVersion |
| GET | `/v1/ai-document-versions` | Get a page of AiDocumentVersions |
| GET | `/v1/ai-document/{id}` | Get an AiDocument. |
| PATCH | `/v1/ai-document/{id}` | Updates AiDocument fields |
| GET | `/v1/ai-documents` | Get a page of AiDocuments. |
| POST | `/v1/ai-documents` | Creates new AiDocuments. |
| POST | `/v1/ai-documents/save-version` | Appends an immutable ai_document_versions record and advances the document's currentVersion. |
| POST | `/v1/allergy-code` | Creates a new AllergyCode |
| DELETE | `/v1/allergy-code/{id}` | Delete one AllergyCode |
| GET | `/v1/allergy-code/{id}` | Get an AllergyCode |
| PATCH | `/v1/allergy-code/{id}` | Updates AllergyCode fields |
| GET | `/v1/allergy-codes` | Get a page of AllergyCodes |
| POST | `/v1/allergy-codes` | Creates new AllergyCodes |
| POST | `/v1/analytics-frame` | Create AnalyticsFrame Method: |
| DELETE | `/v1/analytics-frame/{id}` | Delete AnalyticsFrame Method: |
| GET | `/v1/analytics-frame/{id}` | Get AnalyticsFrame Method: |
| PATCH | `/v1/analytics-frame/{id}` | Update AnalyticsFrame Method: |
| GET | `/v1/analytics-frames` | Get AnalyticsFrames Method: |
| POST | `/v1/analytics-frames` | Update Indexes Method: |
| PATCH | `/v1/analytics-frames/update-indexes` | Updates indexes for a number of analytics frames to adjust the default sorting |
| POST | `/v1/analytics/custom-aggregation` | Custom analytics aggregation Method: |
| GET | `/v1/analytics/custom-report` | For customized analytics reporting, pre-configured by the Tellescope team for a given organization |
| POST | `/v1/api-key` | Generate ApiKey Method: |
| DELETE | `/v1/api-key/{id}` | Delete one ApiKey |
| GET | `/v1/api-key/{id}` | Get ApiKey Method: |
| PATCH | `/v1/api-key/{id}` | Updates ApiKey fields |
| GET | `/v1/api-keys` | Get a page of ApiKeys |
| POST | `/v1/appointment-booking-page` | Creates a new AppointmentBookingPage |
| DELETE | `/v1/appointment-booking-page/{id}` | Delete one AppointmentBookingPage |
| GET | `/v1/appointment-booking-page/{id}` | Get an AppointmentBookingPage |
| PATCH | `/v1/appointment-booking-page/{id}` | Updates AppointmentBookingPage fields |
| GET | `/v1/appointment-booking-pages` | Get a page of AppointmentBookingPages |
| POST | `/v1/appointment-booking-pages` | Creates new AppointmentBookingPages |
| POST | `/v1/appointment-booking-pages/generate-access-token` | Generates a 1-time access token for booking an appointment |
| GET | `/v1/appointment-booking-pages/validate-access-token` | Validates an appointment booking token |
| POST | `/v1/appointment-location` | Creates a new AppointmentLocation |
| DELETE | `/v1/appointment-location/{id}` | Delete AppointmentLocation Method |
| GET | `/v1/appointment-location/{id}` | Get AppointmentLocation Method |
| PATCH | `/v1/appointment-location/{id}` | Update AppointmentLocation Method |
| GET | `/v1/appointment-locations` | Get AppointmentLocations Method |
| POST | `/v1/appointment-locations` | Create AppointmentLocations Method |
| POST | `/v1/automated-action` | Create AutomatedAction Method |
| DELETE | `/v1/automated-action/{id}` | Delete AutomatedAction Method |
| GET | `/v1/automated-action/{id}` | Get AutomatedAction Method |
| PATCH | `/v1/automated-action/{id}` | Update AutomatedAction Method |
| GET | `/v1/automated-actions` | Get AutomatedActions Method |
| POST | `/v1/automated-actions` | Create AutomatedActions Method |
| POST | `/v1/automated-actions/process` | AutomatedActions Process Automation Action (Admin Only) Method |
| POST | `/v1/automation-step` | Create AutomationStep Method |
| DELETE | `/v1/automation-step/{id}` | Delete AutomationStep Method |
| GET | `/v1/automation-step/{id}` | Get AutomationStep Method |
| PATCH | `/v1/automation-step/{id}` | Update AutomationStep Method |

…and 36 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/tellescope/openapi/_ae-authored/tellescope-openapi-generated.yml
- **JSONSchema** — https://artifacts.apis.io/tellescope/json-schema/tellescope-post-v1-appointment-booking-page-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/tellescope/json-schema/tellescope-post-v1-analytics-frame-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/tellescope/json-schema/tellescope-post-v1-automation-trigger-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/tellescope/json-schema/tellescope-post-v1-availability-block-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/tellescope/json-schema/tellescope-post-v1-appointment-location-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/tellescope/json-schema/tellescope-post-v1-ai-conversations-agent-message-request-schema.json

## Other Tellescope APIs (1)

- [Tellescope API](https://apis.io/apis/tellescope/tellescope-api-2/)

## Use this from code or an agent

- **REST, no key:** `GET https://apis.io/api/v1/providers/tellescope` returns the provider's full profile as JSON.
- **MCP:** `https://apis.io/mcp` (Streamable HTTP) — search the catalog, read any provider, compare providers, check agent readiness.
- **Free API key** for catalog-wide search, ratings and comparisons: sign in with GitHub, Google or LinkedIn at https://apis.io/developer/account/ (plans: https://apis.io/developer/plans/).

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/tellescope/tellescope-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/tellescope/.
