API reference / Apps
Remove a custom app
Removes an app and forgets its key or its sign-in. Its calls that wait for a yes fail when someone says yes. Needs an owner or admin.
/api/v1/custom-apps/{slug}Other ways to call it
troopy custom-apps removetroopy_remove_custom_appIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
slug*stringThe id of the app, made from its name, as in acme_crm
Response
200 · application/jsondata*object12 properties
slug*stringThe id of the app, made from its name, as in acme_crm
name*stringkind*enum<string>A remote MCP server, or an OpenAPI document (Liquid SaaS)
mcpopenapi
url*stringThe Streamable HTTP address of its MCP server
auth*enum<string>How Troopy signs in: nothing, a key in a header, or the sign-in of the server
nonekeyoauth
status*enum<string>connectedneeds_sign_infailed
error*string | nulltools*array<object>5 properties
name*stringdescription*stringmode*enum<string>free: it runs. ask: it waits for the yes of an owner or admin. off: no teammate calls it
freeaskoff
args*array<string>The top-level arguments of the tool
visitor*string | nullThe argument that takes the email of a visitor of the website. Then the Support agent calls the tool for a visitor that the website proved, and Troopy fills that argument in. Null: the Support agent never calls it
listedAt*string | nullWhen an owner or admin last read its tools
connectedBy*objectWho wrote it
3 properties
type*enum<string>personagentapi
id*stringname*stringconnectedAt*stringISO 8601 date and time
signIn*string | nullThe page that starts the sign-in of the server, while it waits for one. A person opens it