API reference / Apps
Choose what an app reads
Chooses what a connection reads. For Search Console, choose one property. For Meta Ads, choose the ad accounts, and the campaigns that Analytics tracks (null tracks all of them). The ids come from choices, and from the campaigns of getAnalyticsAds. For an image provider, choose the model that makes its pictures. Needs an owner or admin.
/api/v1/apps/{provider}Other ways to call it
troopy apps chooseIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Path parameters
provider*enum<string>The app, like stripe
stripeposthoggithubnotionhunterlemonsqueezypolarpaddledodopaymentssearchconsolemetaadsgooglecalendargeminiopenaifalreplicate
Body
application/jsonchoosearray<string>Ids from choices
At most 100 items
campaignsarray<string> | nullMeta Ads: the campaign ids to track, or null for all
modelstring | nullAn image provider: the model that makes its pictures. null: its default model
Response
200 · application/jsondata*object11 properties
provider*enum<string>The app, like stripe
stripeposthoggithubnotionhunterlemonsqueezypolarpaddledodopaymentssearchconsolemetaadsgooglecalendargeminiopenaifalreplicate
name*stringstatus*enum<string>connectednot_connected
mode*enum<string> | nullFor Stripe: whether the key reads test or live data
testlive
account*string | nullFor PostHog: the project it reads, like Viraloop (US). For an image provider: its model
pictures*booleanAn image provider: whether the workspace makes its pictures with this one
hint*string | nullThe key's last four characters
connectedBy*object | null3 properties
type*enum<string>personagentapi
id*stringname*stringconnectedAt*string | nulllastUsedAt*string | nullchoices*array<object> | nullWhat the connection can read, and what a person chose of it. Search Console has properties, and Meta Ads has ad accounts. null for the other services
3 properties
id*stringlabel*stringchosen*boolean