TextQL

TextQL Observability Service API

The ObservabilityService API from TextQL — 30 operation(s) for observabilityservice.

GitHub OpenAPI

Operations 30

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /textql.rpc.public.observe.ObservabilityService/ActivateCustomTopic Activate a custom topic · ActivateCustomTopic #
Ask an LLM
“How do I turn a custom topic on so new chats get tagged with it?”
“Can I re-enable a custom topic I paused earlier?”
Tell an agent
Activate custom topic {topic_id}.
Start tagging chats with custom topic {topic_id} again.
POST /textql.rpc.public.observe.ObservabilityService/BackfillCustomTopic Backfill a custom topic over past chats · BackfillCustomTopic #
Ask an LLM
“Can a new custom topic be applied to chats from before it existed?”
“Which date range does a topic backfill cover?”
Tell an agent
Backfill custom topic {topic_id} from {start_date} to {end_date}.
Tag historical chats with custom topic {topic_id}.
POST /textql.rpc.public.observe.ObservabilityService/BackfillThreadWarnings Backfill warnings on past chat threads · BackfillThreadWarnings #
Ask an LLM
“Can I generate thread warnings for older chats retroactively?”
“How many days back and with what concurrency can a warnings backfill run?”
Tell an agent
Backfill thread warnings for the last {days} days.
Redo warnings on all threads in org {org_id} with concurrency {concurrency}.
POST /textql.rpc.public.observe.ObservabilityService/CreateCustomTopic Create a custom topic for tagging chats · Custom topics #
Ask an LLM
“How do I define a custom topic to track what people ask about?”
“Can a custom topic list what it covers and what it excludes?”
Tell an agent
Create a custom topic named {name} described by {user_prompt}.
Add topic {name} covering {covers} but excluding {excludes}.
POST /textql.rpc.public.observe.ObservabilityService/DeactivateCustomTopic Deactivate a custom topic · DeactivateCustomTopic #
Ask an LLM
“Can I pause a custom topic without deleting it?”
“What stops new chats being tagged with a topic?”
Tell an agent
Deactivate custom topic {topic_id}.
Pause tagging for custom topic {topic_id}.
POST /textql.rpc.public.observe.ObservabilityService/DeleteCustomTopic Delete a custom topic · DeleteCustomTopic #
Ask an LLM
“How do I permanently remove a custom topic?”
“Is deleting a custom topic different from deactivating it?”
Tell an agent destructive · confirm first
Delete custom topic {topic_id}.
Permanently remove the topic {topic_id}.
POST /textql.rpc.public.observe.ObservabilityService/ExportObservabilityCsv Export observability data as CSV · ExportObservabilityCsv #
Ask an LLM
“Can I download observability data as a CSV?”
“Which tab and time window does a CSV export cover?”
Tell an agent
Export the {tab} observability tab as CSV for the last {days} days.
Download observability data for {days} days as a spreadsheet.
POST /textql.rpc.public.observe.ObservabilityService/FixCheckRecord Fix a failed check record · FixCheckRecord #
Ask an LLM
“Can a flagged check record be fixed automatically?”
“What happens when I apply a fix to a check record?”
Tell an agent
Fix check record {record_id}.
Apply the fix for flagged check {record_id}.
POST /textql.rpc.public.observe.ObservabilityService/FixWarning Fix a thread warning · FixWarning #
Ask an LLM
“Can I resolve a warning raised on a chat thread?”
“How are thread warnings fixed?”
Tell an agent
Fix warning {warning_id}.
Resolve the thread warning {warning_id}.
POST /textql.rpc.public.observe.ObservabilityService/GetAccessMethodStats Get usage by access method · GetAccessMethodStats #
Ask an LLM
“Are people using TextQL more through the web app, chat integrations or the API?”
“Can I break down usage by access method for a date range?”
Tell an agent
Show access method stats for the last {days} days.
Break down usage by access channel from {start_date} to {end_date}.
POST /textql.rpc.public.observe.ObservabilityService/GetActivePeopleStats Get active user counts · GetActivePeopleStats #
Ask an LLM
“How many people were active in the last month?”
“What's the active people count for a given window?”
Tell an agent
Get active people stats for the past {days} days.
Count how many members were active over {days} days.
POST /textql.rpc.public.observe.ObservabilityService/GetActivePeopleTrend Get the trend of active users over time · GetActivePeopleTrend #
Ask an LLM
“Is the number of active people going up or down over time?”
“Can I chart daily active people between two dates?”
Tell an agent
Show the active people trend over {days} days.
Plot active users between {start_date} and {end_date}.
POST /textql.rpc.public.observe.ObservabilityService/GetBackfillPreview Preview a thread-warning backfill · GetBackfillPreview #
Ask an LLM
“How many threads would a warnings backfill touch before I run it?”
“Can I estimate a backfill's scope first?”
Tell an agent
Preview a warnings backfill over {days} days.
Estimate what a full redo backfill would cover for org {org_id}.
POST /textql.rpc.public.observe.ObservabilityService/GetBackfillStatus Check a thread-warning backfill's progress · GetBackfillStatus #
Ask an LLM
“Is my warnings backfill still running?”
“How far along is the backfill for an org?”
Tell an agent
Get the backfill status for org {org_id}.
Check progress on the current warnings backfill with a {timeout_ms} ms timeout.
POST /textql.rpc.public.observe.ObservabilityService/GetBillingStats Get billing and usage cost stats · GetBillingStats #
Ask an LLM
“How much usage have we been billed for recently?”
“What do the billing stats look like for the past quarter?”
Tell an agent
Get billing stats for the last {days} days.
Summarize our spend over {days} days.
POST /textql.rpc.public.observe.ObservabilityService/GetChatSourceStats Get chat counts by source · GetChatSourceStats #
Ask an LLM
“Where are chats coming from, and in what numbers?”
“Can I see chat sources for one member over a date range?”
Tell an agent
Show chat source stats for the last {days} days.
Break down member {member_id}'s chats by source from {start_date} to {end_date}.
POST /textql.rpc.public.observe.ObservabilityService/GetChatTopics Get the topics tagged on chats · GetChatTopics #
Ask an LLM
“Which topics were these chats tagged with?”
“Can I look up topics for several chats at once?”
Tell an agent
Get the topics for chats {chat_ids}.
Show which topics apply to chat IDs {chat_ids}.
POST /textql.rpc.public.observe.ObservabilityService/GetCheckRecordFix Get the proposed fix for a check record · GetCheckRecordFix #
Ask an LLM
“What fix is suggested for a failed check before I apply it?”
“Can I review the remedy for a check record?”
Tell an agent
Show the proposed fix for check record {record_id}.
Get the suggested remedy for check {record_id} without applying it.
POST /textql.rpc.public.observe.ObservabilityService/GetCustomTopic Get a custom topic and its trend · GetCustomTopic #
Ask an LLM
“How is a custom topic configured and trending?”
“Can I see a custom topic's trend within a window?”
Tell an agent
Get custom topic {topic_id}.
Show topic {topic_id} trending from {trend_start} to {trend_end}.
POST /textql.rpc.public.observe.ObservabilityService/GetCustomTopicPeople List people who discuss a custom topic · GetCustomTopicPeople #
Ask an LLM
“Who in my organization is asking about a given topic?”
“Which members have chats tagged with this custom topic?”
Tell an agent
List the people behind custom topic {topic_id}.
Show who talks most about topic {topic_id}.
POST /textql.rpc.public.observe.ObservabilityService/GetCustomTopicThreads List chat threads tagged with a custom topic · GetCustomTopicThreads #
Ask an LLM
“Which chat threads were tagged with a custom topic?”
“Can I filter a topic's threads by verdict or by member?”
Tell an agent
List threads tagged with topic {topic_id}.
Show topic {topic_id} threads from member {member_id} with verdict {verdict}.
POST /textql.rpc.public.observe.ObservabilityService/GetEngagementSpectrum Get the engagement spectrum of members · GetEngagementSpectrum #
Ask an LLM
“How is engagement distributed across our users, from power users to inactive?”
“What does the engagement spectrum look like this month?”
Tell an agent
Show the engagement spectrum for the last {days} days.
Bucket members by engagement level over {days} days.
POST /textql.rpc.public.observe.ObservabilityService/GetMemberActivity Get per-member activity · GetMemberActivity #
Ask an LLM
“What has each member been doing lately?”
“Can I see activity broken out by person?”
Tell an agent
Get member activity for the past {days} days.
List activity per teammate over {days} days.
POST /textql.rpc.public.observe.ObservabilityService/GetMemberSignalTrend Get the member signal trend · GetMemberSignalTrend #
Ask an LLM
“How are member signals trending over time?”
“Is there a trend line for member signals across a window?”
Tell an agent
Show the member signal trend over {days} days.
Chart member signals for the last {days} days.
POST /textql.rpc.public.observe.ObservabilityService/GetObservabilityStats Get overall observability stats · GetObservabilityStats #
Ask an LLM
“What are the headline usage stats for my org?”
“Which time windows and timezones can the overview stats use?”
Tell an agent
Get observability stats for the last {days} days.
Show the overview stats for {days} days bucketed in timezone {timezone}.
POST /textql.rpc.public.observe.ObservabilityService/GetThreadWarnings Get warnings raised on chat threads · GetThreadWarnings #
Ask an LLM
“Were any warnings flagged on these chats?”
“Can I fetch thread warnings for several chats at once?”
Tell an agent
Get thread warnings for chats {chat_ids}.
List the warnings flagged on chat IDs {chat_ids}.
POST /textql.rpc.public.observe.ObservabilityService/ListCustomTopics List custom topics · ListCustomTopics #
Ask an LLM
“Which custom topics have we defined?”
“Can the topic list include trends for a given window?”
Tell an agent
List all custom topics.
List custom topics with trends from {trend_start} to {trend_end}.
POST /textql.rpc.public.observe.ObservabilityService/RefineTopicDraft Refine a draft custom topic definition · RefineTopicDraft #
Ask an LLM
“Can the system help me tighten a topic definition before I save it?”
“Will examples and exclusions improve a topic draft?”
Tell an agent
Refine the topic draft {prompt}.
Improve topic draft {prompt} using examples {examples} and exclusions {exclusions}.
POST /textql.rpc.public.observe.ObservabilityService/SetTopicTagFeedback Give feedback on a chat's topic tag · SetTopicTagFeedback #
Ask an LLM
“What if a chat was tagged with the wrong topic?”
“Can I exclude a chat from a topic and say why?”
Tell an agent
Exclude chat {chat_id} from topic {topic_id} because {reason}.
Record tag feedback on chat {chat_id} for topic {topic_id}.
POST /textql.rpc.public.observe.ObservabilityService/UpdateCustomTopic Update a custom topic · UpdateCustomTopic #
Ask an LLM
“Can I rename a custom topic or change what it covers?”
“How do I edit the exclusions on an existing topic?”
Tell an agent
Rename custom topic {topic_id} to {name}.
Change topic {topic_id} to cover {covers} and exclude {excludes}.

Documentation

📖
Documentation
https://docs.textql.com/api-reference/v2/introduction
📖
APIReference
https://docs.textql.com/api-reference/v2/introduction
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/authentication/textql-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/rate-limits/textql-rate-limits.yml
📖
Documentation
https://docs.textql.com/api-reference/introduction
📖
APIReference
https://docs.textql.com/api-reference/introduction

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/openapi/textql-observabilityservice-api-openapi.yml

Other Resources

🔗
OAuthScopes
https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/scopes/textql-scopes.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/errors/textql-problem-types.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/conventions/textql-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/data-model/textql-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/asyncapi/textql-webhooks.yml
🔗
Deprecation
https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/lifecycle/textql-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/conformance/textql-conformance.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/textql:textql-observabilityservice-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

textql-observabilityservice-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: TextQL Observability Service API
  version: 1.0.0
  description: 'TextQL public API. Generated from protobuf service definitions; internal

    endpoints are excluded via google.api.visibility / file_visibility.'
servers:
- url: https://app.textql.com/rpc/public
security:
- apiKey: []
tags:


# --- truncated at 32 KB (253 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/textql/refs/heads/main/openapi/textql-observabilityservice-api-openapi.yml