Skip to content

Remove references to "team" and "teams" #52795

Open
0 of 3 issues completed
Open

Description

@rachaelshaw

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-upgrade
      • The "--team" flag is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade
      • The "--policies-team" flag is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade
      • The "--delete-other-teams" flag is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade
      • The "DELETE_OTHER_TEAMS" environment variable is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade
      • The "--fleet no-team" value is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade
  • YAML changes: Remove teams from the YAML docs #56209
    • Old GitOps keys are rejected, not ignored. For example, team_settings fails with The "team_settings" key is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade
  • 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/teams returns The "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_id returns The "team_id" parameter is not available anymore. What to use instead: https://fleetdm.com/learn-more-about/fleet-5-upgrade
  • 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?
  • 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

  1. 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).
  2. QA: Added comment to user story confirming successful completion of test plan.
  3. 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":

Activity

  1. added
    storyA user story defining an entire feature
    ~Fleet 5Feature requests or user stories that are part of Fleet's next major version release, Fleet 5
    on Sep 8, 2026
  2. changed the title [-]Remove references to "teams" in API[/-] [+][Fleet 5] Remove references to "teams" in API[/+] on Sep 8, 2026
  3. changed the title [-][Fleet 5] Remove references to "teams" in API[/-] [+][Fleet 5 API] Remove references to "teams" in API[/+] on Sep 9, 2026
  4. added this to the 5.0.0 milestone on Sep 21, 2026
  5. changed the title [-][Fleet 5 API] Remove references to "teams" in API[/-] [+]Remove references to "teams" in API[/+] on Sep 23, 2026
  6. added
    #g-power-to-pcPower to the PC working group
    ~assisting g-orchestrationThis is a #g-orchestration issue that another product group is assisting
    and removed on Sep 30, 2026
  7. sharon-fdm commented on Sep 30, 2026

    @sharon-fdm
    Collaborator

    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

  8. getvictor commented on Sep 30, 2026

    @getvictor
    Member

    @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.

  9. sharon-fdm commented on Oct 1, 2026

    @sharon-fdm
    Collaborator

    Assuming the above, we think this is XS due to needed migration.

  10. self-assigned this
    on Oct 12, 2026
  11. 23 remaining items

  12. moved this from 📨 Inbox to 🦢 Drafting in ⚡ #g-power-to-pcon Oct 29, 2026
  13. moved this from 🦢 Drafting to 🐣 In progress in ⚡ #g-power-to-pcon Nov 2, 2026
  14. added 2 commits that reference this issue on Nov 2, 2026
    d143725
    44d8427
  15. getvictor commented on Nov 4, 2026

    @getvictor
    Member

    Fleet 5 migration guide: #56918

  16. getvictor commented on Nov 4, 2026

    @getvictor
    Member

    @spalmesano0 I will not touch teams in packs, since packs are to be removed in #53470

  17. spalmesano0 commented on Nov 4, 2026

    @spalmesano0
    Member

    Wow, this is gonna be a huge release.

    Thanks for letting me know.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

#g-power-to-pcPower to the PC working groupstoryA user story defining an entire feature~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 assisting~breaking changeContains breaking changes to Fleet's flags, db-based configuration, REST API, or fleetctl CLI usage.

Type

No type

Projects

Milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions