Skip to main content
TroopyDocs
Open Troopy
Troopy

API reference / Support Agent

Change where the bug tickets of chats go

Send only what changes. GitHub checks that Troopy's GitHub App reaches the repo and that the branch is in it. A new repo drops the branch of the old one. A ticket keeps the repo and the branch that were set when Troopy made it. Owners and admins.

patch/api/v1/support-ticket-settings

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 support set-ticket-settings
MCP toolNone. Call it over REST or with the CLI.
Rate limit30 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
repostring | null

The GitHub repo that each bug ticket of a chat changes, as owner/name. Null: the Engineer picks the repo

branchstring | null

The branch that the work of each bug ticket of a chat starts from, and that its pull request goes into, like staging. Null: the default branch of the repo. A ticket keeps the branch that was set when Troopy made it

Response

200 · application/json
data*object
2 properties
repo*string | null

The GitHub repo that each bug ticket of a chat changes, as owner/name. Null: the Engineer picks the repo

branch*string | null

The branch that the work of each bug ticket of a chat starts from, and that its pull request goes into, like staging. Null: the default branch of the repo. A ticket keeps the branch that was set when Troopy made 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 an organization 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.