Team

An organization team. Teams group org members for shared configuration. Each org has exactly one system team named "General" which is created automatically and cannot be deleted. The member_preview field is a capped, embedded snapshot of the team's most-recently-active members so frontends can render avatar stacks without a second round-trip. Use /teams/{team_id}/members for the full paginated list.

  • object
    Type: string

    Resource type identifier, always "team"

  • id
    Type: string

    Stable identifier for the team

  • org_id
    Type: string

    Identifier of the owning organization

  • name
    Type: string

    Display name (e.g. "General", "London")

  • slug
    Type: string

    URL-safe slug, unique within the org

  • is_system
    Type: boolean

    True when this is the org's system team. Its slug is locked and the row cannot be deleted; name and other fields remain editable.

  • member_preview
    Type: object · TeamMemberPreview

    Capped preview of the team's most-recently-active members, plus the team's full member count. Always present; empty for newly created teams or when preview enrichment fails.

    • object
      Type: string

      Resource type identifier, always "team_member_preview"

    • items
      Type: array object[] · TeamMember[]

      Up to PreviewMemberLimit members, ordered by most-recently-active first.

      A team membership. Identified by the (team_id, user) pair.

    • total_count
      Type: integer

      Total number of members in the team. May exceed len(items).

  • created_at
    Type: string

    Creation timestamp in RFC 3339 UTC form

  • updated_at
    Type: string

    Last-update timestamp in RFC 3339 UTC form