Skip to main content
TroopyDocs
Open Troopy
Troopy

API reference / Support Agent

Publish a change to the library

Publishes a live change as a recipe of the library, in your words only: what the agent made for one customer stays with that customer. A wish needs text, the wish in your own words. A card takes your title and, as text, its line. A routine takes its tool and its schedule, with no arguments, and its function only when you give it as transform. The Support agent offers it at once. 30 recipes at most. Needs an owner or admin. Not found while Liquid SaaS is off.

post/api/v1/support-liquid/layers/{id}/publish

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

Path parameters

id*string

A 24-character id

Body

application/json
title*string

At least 3 characters · At most 80 characters

about*string

What it does for a customer

At least 3 characters · At most 300 characters

textstring

A wish: its words, as you write them. A card: its line

At least 3 characters · At most 500 characters

transformstring

A routine: the function to share, with no value of a customer

At most 4000 characters

Response

201 · application/json
data*object
1 properties
id*string

A 24-character id

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.
404 not_foundCheck the path and any id in it. Every operation is listed in /api/v1/openapi.json.
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.