Microsoft Teams Team

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://learn.microsoft.com/en-us/graph/schemas/microsoft/team.json",
  "title": "Microsoft Teams Team",
  "description": "Represents a team in Microsoft Teams. A team is a collection of channels and members with shared settings, permissions, and tools for collaboration.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the team (GUID)",
      "readOnly": true
    },
    "displayName": {
      "type": "string",
      "description": "The name of the team",
      "maxLength": 256
    },
    "description": {
      "type": ["string", "null"],
      "description": "An optional description for the team",
      "maxLength": 1024
    },
    "internalId": {
      "type": ["string", "null"],
      "description": "A unique ID for the team that has been used in some internal contexts",
      "readOnly": true
    },
    "classification": {
      "type": ["string", "null"],
      "description": "An optional label describing the sensitivity of the team"
    },
    "specialization": {
      "type": ["string", "null"],
      "enum": [null, "none", "educationStandard", "educationClass", "educationProfessionalLearningCommunity", "educationStaff", "unknownFutureValue"],
      "description": "Indicates whether the team is intended for a particular use case"
    },
    "visibility": {
      "type": ["string", "null"],
      "enum": [null, "private", "public"],
      "description": "The visibility of the group and team"
    },
    "webUrl": {
      "type": ["string", "null"],
      "format": "uri",
      "description": "A hyperlink to the team in the Microsoft Teams client",
      "readOnly": true
    },
    "isArchived": {
      "type": ["boolean", "null"],
      "description": "Whether this team is in read-only mode"
    },
    "isMembershipLimitedToOwners": {
      "type": ["boolean", "null"],
      "description": "If set to true, the team is currently in the owner-only team membership state"
    },
    "createdDateTime": {
      "type": ["string", "null"],
      "format": "date-time",
      "description": "Timestamp at which the team was created",
      "readOnly": true
    },
    "memberSettings": {
      "$ref": "#/$defs/TeamMemberSettings"
    },
    "guestSettings": {
      "$ref": "#/$defs/TeamGuestSettings"
    },
    "messagingSettings": {
      "$ref": "#/$defs/TeamMessagingSettings"
    },
    "funSettings": {
      "$ref": "#/$defs/TeamFunSettings"
    },
    "discoverySettings": {
      "$ref": "#/$defs/TeamDiscoverySettings"
    }
  },
  "$defs": {
    "TeamMemberSettings": {
      "type": ["object", "null"],
      "description": "Settings to configure whether members can perform certain actions in the team",
      "properties": {
        "allowCreateUpdateChannels": {
          "type": "boolean",
          "description": "If true, members can add and update channels"
        },
        "allowCreatePrivateChannels": {
          "type": "boolean",
          "description": "If true, members can create private channels"
        },
        "allowDeleteChannels": {
          "type": "boolean",
          "description": "If true, members can delete channels"
        },
        "allowAddRemoveApps": {
          "type": "boolean",
          "description": "If true, members can add and remove apps"
        },
        "allowCreateUpdateRemoveTabs": {
          "type": "boolean",
          "description": "If true, members can create, update, and remove tabs"
        },
        "allowCreateUpdateRemoveConnectors": {
          "type": "boolean",
          "description": "If true, members can create, update, and remove connectors"
        }
      }
    },
    "TeamGuestSettings": {
      "type": ["object", "null"],
      "description": "Settings to configure whether guests can perform certain actions in the team",
      "properties": {
        "allowCreateUpdateChannels": {
          "type": "boolean",
          "description": "If true, guests can create and update channels"
        },
        "allowDeleteChannels": {
          "type": "boolean",
          "description": "If true, guests can delete channels"
        }
      }
    },
    "TeamMessagingSettings": {
      "type": ["object", "null"],
      "description": "Settings to configure messaging and mentions in the team",
      "properties": {
        "allowUserEditMessages": {
          "type": "boolean",
          "description": "If true, users can edit their messages"
        },
        "allowUserDeleteMessages": {
          "type": "boolean",
          "description": "If true, users can delete their messages"
        },
        "allowOwnerDeleteMessages": {
          "type": "boolean",
          "description": "If true, owners can delete any message"
        },
        "allowTeamMentions": {
          "type": "boolean",
          "description": "If true, @team mentions are allowed"
        },
        "allowChannelMentions": {
          "type": "boolean",
          "description": "If true, @channel mentions are allowed"
        }
      }
    },
    "TeamFunSettings": {
      "type": ["object", "null"],
      "description": "Settings to configure use of Giphy, memes, and stickers in the team",
      "properties": {
        "allowGiphy": {
          "type": "boolean",
          "description": "If true, enables Giphy use"
        },
        "giphyContentRating": {
          "type": "string",
          "enum": ["moderate", "strict"],
          "description": "Giphy content rating"
        },
        "allowStickersAndMemes": {
          "type": "boolean",
          "description": "If true, enables stickers and memes"
        },
        "allowCustomMemes": {
          "type": "boolean",
          "description": "If true, enables custom memes"
        }
      }
    },
    "TeamDiscoverySettings": {
      "type": ["object", "null"],
      "description": "Settings to configure team discoverability by others",
      "properties": {
        "showInTeamsSearchAndSuggestions": {
          "type": "boolean",
          "description": "If true, team is visible in search and suggestions"
        }
      }
    }
  }
}