Skip to main content
TroopyDocs
Open Troopy
Troopy

API reference / Support Agent

Tell the customers who asked for a topic that it is built

Once the ticket of a topic is released, gives each customer with a proved email who asked for it your words. The Support agent tells each one in their next chat, in their language, one time. A later call tells only the customers who asked since. Nothing takes it back. Needs an owner or admin. Not found while Liquid SaaS is off.

post/api/v1/support-liquid/requests/tell

Authorization

HeaderAuthorization: Bearer <API key>
Or the headerX-API-Key: <API key>
API keyMake one in Troopy under Settings > API keys. It acts as you, in its workspace.

Other ways to call it

CLItroopy liquid tell
MCP toolNone. Call it over REST or with the CLI.
Rate limit10 calls in 60 seconds, for each key
RetriesSend an Idempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.

Body

application/json
topic*string

At least 1 characters · At most 40 characters

words*string

One or two sentences for the customers, in your own words

At least 3 characters · At most 300 characters

customersinteger

The untold of the topic that you agree to. When it is another number now, the call refuses

At least 1

Response

200 · application/json
data*object
1 properties
customers*integer

How many customers hear it

Errors

400 invalid_inputFix the field named in detail. Each operation's schema is in /api/v1/openapi.json.
401 unauthorizedSend an API key as `Authorization: Bearer tr_live_...`. Create one in Troopy under Settings.
403 forbiddenThe key lacks a scope this operation needs, or its owner lacks the role. detail says which; create a key with the scope, or ask a company owner or admin.
409 conflictThis Idempotency-Key was used for a different request, or that request is still running. Use a new key for a new request.
429 rate_limitedWait the number of seconds in Retry-After, then retry.