api.v4.TeamWithExpansions

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/cloudbees/main/json-schema/cloudbees-api-v4-team-with-expansions-schema.json",
  "title": "api.v4.TeamWithExpansions",
  "description": "Team with optional expansion fields.",
  "x-generated": "2026-10-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cloudbees-teams-api-openapi.yml#/components/schemas/api.v4.TeamWithExpansions",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for this team"
    },
    "name": {
      "type": "string",
      "description": "Team name"
    },
    "description": {
      "type": "string",
      "description": "Optional description explaining the team's purpose or scope"
    },
    "tenantId": {
      "type": "string",
      "description": "tenant_id field"
    },
    "updatedAt": {
      "type": "string",
      "description": "When this team was last modified",
      "format": "date-time"
    },
    "immutable": {
      "type": "boolean",
      "description": "Whether this team is synchronized from your identity provider and cannot be modified directly"
    },
    "type": {
      "enum": [
        "TEAM_TYPE_UNSPECIFIED",
        "TEAM_TYPE_PREDEFINED",
        "TEAM_TYPE_USERDEFINED"
      ],
      "type": "string",
      "description": "Distinguishes platform-managed teams (PREDEFINED) from teams you create (USERDEFINED)"
    },
    "users": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/api.v4.User"
      },
      "description": "Users who are members of this team."
    }
  },
  "$defs": {
    "api.v4.User": {
      "required": [
        "email"
      ],
      "type": "object",
      "properties": {
        "id": {
          "readOnly": true,
          "type": "string",
          "description": "Unique identifier for this user"
        },
        "email": {
          "type": "string",
          "description": "Primary email address for authentication and contact"
        },
        "displayName": {
          "readOnly": true,
          "type": "string",
          "description": "Display name for this user"
        },
        "firstName": {
          "type": "string",
          "description": "First name of the user"
        },
        "lastName": {
          "type": "string",
          "description": "Last name of the user"
        },
        "additionalEmails": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Additional email addresses linked to user account"
        }
      },
      "description": "A person that can access CloudBees Unify. Invite users to a tenant to grant them access to your organizations."
    }
  }
}