Repository navigation
Open
0 / 30 of 3 issues completedLabels
#g-power-to-pcPower to the PC working groupPower to the PC working groupstoryA user story defining an entire featureA user story defining an entire feature~Fleet 5Feature requests or user stories that are part of Fleet's next major version release, Fleet 5Feature requests or user stories that are part of Fleet's next major version release, Fleet 5~assisting g-orchestrationThis is a #g-orchestration issue that another product group is assistingThis is a #g-orchestration issue that another product group is assisting~breaking changeContains breaking changes to Fleet's flags, db-based configuration, REST API, or fleetctl CLI usage.Contains breaking changes to Fleet's flags, db-based configuration, REST API, or fleetctl CLI usage.
Milestone
Description
Goal
| User story |
|---|
| As a Fleet user, |
| I don't want to see references "team" or "teams" anywhere |
| so that I can only work with "fleet" and "fleets". |
FLEET_JIT_USER_ROLE_TEAM_ will be handled with #53925.
Changes
Product
- UI changes: Remove teams from frontend and the command palette #56349
- CLI (fleetctl) usage changes: Remove teams from fleetctl #56630
- Removed commands, flags, and environment variables fail with:
The "fleetctl get teams" command is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgradeThe "--team" flag is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgradeThe "--policies-team" flag is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgradeThe "--delete-other-teams" flag is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgradeThe "DELETE_OTHER_TEAMS" environment variable is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgradeThe "--fleet no-team" value is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade
- Removed commands, flags, and environment variables fail with:
- YAML changes: Remove teams from the YAML docs #56209
- Old GitOps keys are rejected, not ignored. For example,
team_settingsfails withThe "team_settings" key is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade
- Old GitOps keys are rejected, not ignored. For example,
- REST API changes: Remove teams from the API docs #56092 Use "fleet" field names in the frontend #56415 Let the API accept fleet names for sorting and targets #56620 Remove teams URL paths from the API #56641 Make the frontend send and read the "fleet" names #56646 Keep the team ID out of script results #56679 Remove teams from the API #56680
- Old paths return a 410 instead of a 404. For example,
GET /api/v1/fleet/teamsreturnsThe "GET /teams" endpoint is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade - Old parameters, response fields, sort keys, and the team target type are rejected with a 422, not silently ignored. For example,
team_idreturnsThe "team_id" parameter is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade
- Old paths return a 410 instead of a 404. For example,
- Fleet's agent (fleetd) changes: No changes
- Fleet server configuration changes: Remove teams from Fleet server configuration docs #56211
- Exposed, public API endpoint changes: No changes
- Maybe in
server/service/handler_deprecated_paths.go?
- Maybe in
- fleetdm.com changes: No changes
- GitOps mode UI changes: No changes
- GitOps generation changes: See Remove teams from fleetctl #56630
- Activity changes: Remove teams from audit logs #56222
- Engineering: We'll need a migration for the new activity names.
- Permissions changes: No changes
- Changes to paid features or tiers: No changes
- My device and fleetdm.com/better changes: No changes
- Usage statistics: No changes
- Compatibility: Breaking changes, but part of a major release.
- Other reference documentation changes: Remove teams from reference docs #56215
- First draft of test plan added
- Once shipped, requester has been notified
- Once shipped, dogfooding issue has been filed
Engineering
- Test plan is finalized
- Contributor API changes: Yes, see links above
- Feature guide changes: Yes, see links above
- Database schema migrations: Yes, activities
ℹ️ Please read this issue carefully and understand it. Pay special attention to UI wireframes, especially "dev notes".
Risk assessment
- Risk level: High
- Risk description: Large surface area
Test plan
Make sure to go through the list and consider all events that might be related to this story, so we catch edge cases earlier.
Core flow
- Confirm there are no references to team/teams remaining.
- Confirm old team/teams endpoints return a 410, old parameters return a 422, and old GitOps keys and fleetctl commands, flags, and environment variables fail, each with its message and the migration guide link.
Edge cases
- TODO
Supplemental testing
Testing notes
Confirmation
- Engineer: Added comment to user story confirming successful completion of test plan (include any special setup, test data, or configuration used during development/testing if applicable).
- QA: Added comment to user story confirming successful completion of test plan.
- QA: Determined whether this story needs Playwright automation.
- Needs automation: Yes / No
- If yes, filed a follow-up issue in the :help-qa project with status "Needs automation":
Metadata
Metadata
Assignees
Labels
#g-power-to-pcPower to the PC working groupPower to the PC working groupstoryA user story defining an entire featureA user story defining an entire feature~Fleet 5Feature requests or user stories that are part of Fleet's next major version release, Fleet 5Feature requests or user stories that are part of Fleet's next major version release, Fleet 5~assisting g-orchestrationThis is a #g-orchestration issue that another product group is assistingThis is a #g-orchestration issue that another product group is assisting~breaking changeContains breaking changes to Fleet's flags, db-based configuration, REST API, or fleetctl CLI usage.Contains breaking changes to Fleet's flags, db-based configuration, REST API, or fleetctl CLI usage.
Type
Projects
- StatusShow more project fieldsNo status
- StatusShow more project fields🐣 In progress
Activity
[-]Remove references to "teams" in API[/-][+][Fleet 5] Remove references to "teams" in API[/+][-][Fleet 5] Remove references to "teams" in API[/-][+][Fleet 5 API] Remove references to "teams" in API[/+][-][Fleet 5 API] Remove references to "teams" in API[/-][+]Remove references to "teams" in API[/+]sharon-fdm commentedon Sep 30, 2026
Moving to Power to PC team, assisting Orchestration.
This ticket removes legacy references to "teams" throughout the API, aligning with the product rename to "fleets." This is an API-wide rename with self-contained scope that Power to PC can take on to help balance the Fleet 5 workload across groups.
Generated by Claude on behalf of Sharon FDM
getvictor commentedon Sep 30, 2026
@rachaelshaw Does this story mean replace "teams" with "fleets" and "team" with "fleet"?
This seems to also require a migration so that the frontend can handle the pre-5.0 activities.
sharon-fdm commentedon Oct 1, 2026
Assuming the above, we think this is XS due to needed migration.
23 remaining items
Remove teams from audit logs (#56222)
Remove teams from reference docs (#56215)
Add table of removed team names and the Fleet 5 removal message (#57319)
Add table of removed team names and the Fleet 5 removal message
Read fleet names in API responses in the frontend (#57325)
getvictor commentedon Nov 4, 2026
Fleet 5 migration guide: #56918
getvictor commentedon Nov 4, 2026
@spalmesano0 I will not touch teams in packs, since packs are to be removed in #53470
spalmesano0 commentedon Nov 4, 2026
Wow, this is gonna be a huge release.
Thanks for letting me know.
Fleet 5 upgrade guide: AB and VPP token response fields (#58623)