Team

Team is an input used to reference teams that exist in Port.

💡 Common team usage

The team input type can be used to reference any team that exists in Port, for example:

• The service owning team
• The current on-call
• The lead maintainers

In the live demo self-service hub page, we can see the scaffold new service action whose Owning Team input is a user input. 🎬

API definition

Basic

{
  "myTeamInput": {
    "title": "My team input",
    "icon": "My icon",
    "description": "My team input",
    "type": "string",
    "format": "team",
    "default": "my-team"
  }
}

Array

{
  "myTeamArrayInput": {
    "title": "My team array input",
    "icon": "My icon",
    "description": "My team array input",
    "type": "array",
    "items": {
      "type": "string",
      "format": "team"
    }
  }
}

Check out Port's API reference to learn more.

Terraform definition

Basic

resource "port_action" "myAction" {
  # ...action properties
  user_properties = {
    string_props = {
      myTeamInput = {
        title       = "My team input"
        description = "My team input"
        format      = "team"
        default     = "my-team"
      }
    }
  }
}

Array

resource "port_action" "myAction" {
  # ...action properties
  user_properties = {
    array_props = {
      myTeamArrayInput = {
        title       = "My team array input"
        description = "My team array input"
        format      = "team"
      }
    }
  }
}