For the complete documentation index, see llms.txt. This page is also available as Markdown.

Teams Overview

Learn what Teams are in Harness IDP and how they connect people to the software they own.

A Team in Harness Internal Developer Portal (IDP) represents a real group of people in your organization, such as a squad, a platform team, a department, or a cross-functional working group.

Teams do two jobs at once. They describe how your organization is structured, and they describe who is responsible for which software. A Team can be marked as the owner of a Catalog entity, so the Team you belong to determines both the software you are accountable for and, with the right permissions, the software you can see and change.

Teams page in the IDP sidebar

Where to find Teams

Teams appear in two places, and both show the same entities.

  • Teams in the IDP sidebar

  • Team tab on the Catalog page

Go to Manage Teams to learn how to browse, filter, and customize these views.


What you can do with a Team

Action
Description

Create Teams at any scope

Teams can be created at the Account, Organization, or Project scope. Go to Create a Team.

Build a team hierarchy

A Team can have sub-teams, and those sub-teams can have sub-teams of their own. A Team can take sub-teams from its own scope or from any child scope, so an Organization-level Team can contain Teams from several projects inside that organization.

Own Catalog entities

Assign services, APIs, resources, and entities of custom kinds to a Team so that responsibility is visible in the Catalog. Go to Assign entities to a Team.

Grant access through ownership

Permissions granted on a Team extend to the Catalog entities that Team owns. Go to Team access control.

Roll up metrics and scores

Aggregate metrics from a Team's entities up to the Team itself, and evaluate scorecards against Team entities. Go to Team metrics and scorecards.


How a Team is represented

In the Catalog, a Team is an entity of kind Group with type set to team. You see this whenever you work with a Team outside the visual editor, for example in the YAML view, the Entity Inspector, the Entity API, or the Catalog Ingestion API.

Go to Create a Team for the full field reference.


Next steps

Last updated

Was this helpful?