API reference / Account
Update the organization
Renames the organization, picks the AI plan its teammates run on, picks where their names come from, or answers setup's survey; send any of them. Changing the plan keeps the old one signed in on each computer, as the first fallback. A new troopNames renames every teammate still going by a theme's name or its job title; ones a person named keep theirs. profile changes only the answers it names. Needs an owner or admin.
/api/v1/organizationOther ways to call it
troopy organization updatetroopy_update_organizationIdempotency-Key header. A retry with the same key gets the first answer back, and the operation runs one time.Body
application/jsonnamestringThe new name, 1 to 80 characters
At least 1 characters · At most 80 characters
aiProviderenum<string>The AI plan the organization's teammates run on
claudechatgptgeminigrokcopilotopenrouterzaikimiminimaxqwenanthropicopenaicursor
troopNamesenum<string>The theme new teammates' names come from, or titles for their job titles
titlesgreek-mythgreek-heroesnorsecamelotspacescientistsexplorersauthorscomposersbirdstreesoceangemstonesspicescoffeeand 11 more
profileobjectSurvey answers to set; the others stay as they are
8 properties
teamSizeenum<string>How many people work in the business
solo2_1011_5051_200over_200
revenueenum<string>Monthly revenue, in USD
noneunder_10k10k_50k50k_250k250k_1mover_1m
jobRoleenum<string>The role of whoever answered
founderexecutivemarketingsalesoperationssupportproductagencyother
businessModelenum<string>saasecommerceagencyserviceslocalmarketplacecreatorother
industriesarray<enum<string>>technologyretailhealthfinanceeducationreal_estatehospitalitymediaprofessionalother
At most 10 items
reasonenum<string>The main reason they signed up
save_timefewer_toolsgrow_without_hiringalways_onexplore_aiother
jobsarray<enum<string>>What they want their teammates to do
outreachlead_researchsupportsocialcontentseoemailbookkeepingrecruitingreportingengineering
At most 11 items
referralsarray<enum<string>>How they heard about Troopy
googleai_assistantxlinkedinyoutuberedditproduct_huntfriendnewsletterother
At most 10 items
Response
200 · application/jsondata*object6 properties
id*stringA 24-character id
name*stringrole*enum<string>Role in the organization. Owners and admins reach every workspace in it, and manage its people. A member reaches only the workspaces that someone invited it into
owneradminmember
aiProvider*enum<string> | nullThe AI plan teammates run on. Null until setup picks one
claudechatgptgeminigrokcopilotopenrouterzaikimiminimaxqwenanthropicopenaicursor
troopNames*enum<string> | nullWhere new teammates' names come from: a theme, or their job titles (titles). Null until setup asks, which names them by job title
titlesgreek-mythgreek-heroesnorsecamelotspacescientistsexplorersauthorscomposersbirdstreesoceangemstonesspicescoffeeand 11 more
profile*objectSetup's survey about the business. Unanswered questions are missing
8 properties
teamSizeenum<string>How many people work in the business
solo2_1011_5051_200over_200
revenueenum<string>Monthly revenue, in USD
noneunder_10k10k_50k50k_250k250k_1mover_1m
jobRoleenum<string>The role of whoever answered
founderexecutivemarketingsalesoperationssupportproductagencyother
businessModelenum<string>saasecommerceagencyserviceslocalmarketplacecreatorother
industriesarray<enum<string>>technologyretailhealthfinanceeducationreal_estatehospitalitymediaprofessionalother
At most 10 items
reasonenum<string>The main reason they signed up
save_timefewer_toolsgrow_without_hiringalways_onexplore_aiother
jobsarray<enum<string>>What they want their teammates to do
outreachlead_researchsupportsocialcontentseoemailbookkeepingrecruitingreportingengineering
At most 11 items
referralsarray<enum<string>>How they heard about Troopy
googleai_assistantxlinkedinyoutuberedditproduct_huntfriendnewsletterother
At most 10 items